一聚教程网:一个值得你收藏的教程网站

最新下载

热门教程

前端必备Nginx配置完整指南

时间:2026-10-02 08:40:01 编辑:袖梨 来源:一聚教程网

平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“前端必备Nginx配置”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。

落到代码里,Nginx (engine x) 是一个轻量级高性能的HTTP和反向代哩服务務器,同时也是一个通用 代哩服务務器 (TCP/UDP/IMAP/POP3/SMTP),最初由俄罗斯人Igor Sysoev编写。

基本命令

nginx -t 检查设置文件是否有语法错误
nginx -s reload 热加载,重新加载设置文件
nginx -s stop 更快关闭
nginx -s quit 等待工作进程处理完成后关闭

理解这一步时,搭建好nginx服务器同时启动过后,我们先看nginx默认设置,再逐个介绍不同采用场景。

默认设置

在这个场景下,Nginx 安装目录下, 我们复制一份`nginx.conf`成`nginx.conf.default`作为设置文件备份,随后修改`nginx.conf`


# 工作进程的数量
worker_processes 1;
events {
  worker_connections 1024; # 每个工作进程连接数
}

http {
  include mime.types;
  default_type application/octet-stream;

  # 日志格式
  log_format access '$remote_addr - $remote_user [$time_local] $host "$request" '
         '$status $body_bytes_sent "$http_referer" '
         '"$http_user_agent" "$http_x_forwarded_for" "$clientip"';
  access_log /srv/log/nginx/access.log access; # 日志输出目录
  gzip on;
  sendfile on;

  # 链接超时时间,自动断开
  keepalive_timeout 60;

  # 虚拟主机
  server {
    listen 8080;
    server_name localhost; # 浏览器访问域名

    charset utf-8;
    access_log logs/localhost.access.log access;

    # 路由
    location / {
      root www; # 访问根目录
      index index.html index.htm; # 入口文件
    }
  }

  # 引入其他的配置文件
  include servers/*;
}

搭建站点

从实现思路看,在其他设置文件`servers`目录下,添加新建站点设置文件 xx.conf。

电脑 hosts 文件添加 127.0.0.1 xx_domian# 虚拟主机


server {
  listen 8080;
  server_name xx_domian; # 浏览器访问域名

  charset utf-8;
  access_log logs/xx_domian.access.log access;

  # 路由
  location / {
    root www; # 访问根目录
    index index.html index.htm; # 入口文件
  }
}

结合项目来看,执行命令 nginx -s reload,成功后浏览器访问 xx_domian 就能看到你的页面

根据文件类型设置过期时间


location ~.*.css$ {
  expires 1d;
  break;
}
location ~.*.js$ {
  expires 1d;
  break;
}

location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$ {
  access_log off;
  expires 15d; #保存15天
  break;
}

# curl -x127.0.0.1:80 http://www.test.com/static/image/common/logo.png -I #测试图片的max-age

禁止文件缓存

结合项目来看,开发环境经常改动代码,由于浏览器缓存需强制刷新才能看到效果。这是我们能够禁止浏览器缓存提高效率


location ~* .(js|css|png|jpg|gif)$ {
  add_header Cache-Control no-store;
}

防盗链

能够防止文件被其他网站调用


location ~* .(gif|jpg|png)$ {
  # 只允许 192.168.0.1 请求资源
  valid_referers none blocked 192.168.0.1;
  if ($invalid_referer) {
    rewrite ^/ http://$host/logo.png;
  }
}

静态文件压缩


server {
  # 开启gzip 压缩
  gzip on;
  # 设置gzip所需的http协议最低版本 (HTTP/1.1, HTTP/1.0)
  gzip_http_version 1.1;
  # 设置压缩级别,压缩级别越高压缩时间越长 (1-9)
  gzip_comp_level 4;
  # 设置压缩的最小字节数, 页面Content-Length获取
  gzip_min_length 1000;
  # 设置压缩文件的类型 (text/html)
  gzip_types text/plain application/javascript text/css;
}

执行命令 nginx -s reload,成功后浏览器访问

指定定错误页面


# 根据状态码,返回对于的错误页面
error_page 500 502 503 504 /50x.html;
location = /50x.html {
  root /source/error_page;
}

执行命令 nginx -s reload,成功后浏览器访问

跨域问题

跨域的定义

在这个场景下,同源策略限制了从同一个源加载的文档或脚本如何与来自另一个源的资源进行交互。这是一个用来隔离潜在恶意文件的重要安全机制。通常不允许不同源间的读操作。

同源的定义

结合项目来看,若两个页面的协议,端口(如果有指定)和域名都相同,则两个页面具有相同的源。nginx解决跨域的原理

比如:

  • 前端server域名为:(链接已移除)
  • 后端server域名为:(链接已移除)

现在(链接已移除)。

在这个场景下,不过只需启动一个nginx服务器,将server_name设置为xx_domain,随后设置相应的location以拦截前端需跨域的请求,最后将请求代理回github.com。如下面的设置:


## 配置反向代理的参数
server {
  listen 8080;
  server_name xx_domain

  ## 1. 用户访问 http://xx_domain,则反向代理到 https://github.com
  location / {
    proxy_pass https://github.com;
    proxy_redirect off;
    proxy_set_header Host $host; # 传递域名
    proxy_set_header X-Real-IP $remote_addr; # 传递ip
    proxy_set_header X-Scheme $scheme; # 传递协议
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

落到代码里,这样能够完美绕过浏览器的同源策略:github.com访问nginx的github.com属于同源访问,而nginx对服务端转发的请求不会触发浏览器的同源策略。

实际处理时,总的来说,Nginx适合结合实际项目边做边理解。先抓住核心思路,再逐步补上细节和边界处理,最后效果会更稳定,也更容易复用。

热门栏目