动力启航logo
公告以ASP.NET(C#)2.0+jQuery技术为中心,面向软件开发者、程序爱好者、网页设计师,专门结合AJAX技术打造友好界面
运维 栏目 · 实战手册

Nginx 配置入门:server、location、try_files 三件事

用最小示例讲清 nginx 的请求匹配顺序、root 与 alias 的区别、静态站与反代的正确写法。

nginx 配置看起来复杂,实际日常只需要理解三件事:请求进哪个 server、匹配哪个 location、文件从哪里取。

一个能用的静态站配置

server {
    listen 80;
    server_name example.com www.example.com;
    root /www/wwwroot/example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~* \.(css|js|png|jpg|webp|svg|woff2)$ {
        expires 30d;
        add_header Cache-Control "public, max-age=2592000";
    }
}

try_files $uri $uri/ =404 的意思是:先找同名文件,再找同名目录,都没有就返回 404。不要写成 /index.html,那会把所有不存在的 URL 都返回首页内容,状态码 200,搜索引擎判定为软 404。

location 的匹配顺序

  1. = 精确匹配,最高优先
  2. ^~ 前缀匹配,命中后不再看正则
  3. ~ 正则(区分大小写)、~*(不区分)
  4. 普通前缀匹配,取最长

实践建议:能用 = 和 ^~ 就别用正则,正则多了以后很难判断哪个生效。

root 与 alias 的区别

  • root /path:最终路径 = root + 完整 URI
  • alias /path:最终路径 = alias + 去掉 location 前缀的部分
location /download/ {
    alias /data/files/;   # /download/a.zip -> /data/files/a.zip
}

alias 结尾的斜杠必须和 location 一致,否则 404。

反代的标准写法

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

少了 X-Forwarded-Proto,后端会以为请求是 HTTP,生成 http:// 的资源链接,导致混合内容告警。

安全响应头

add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options SAMEORIGIN always;
add_header Referrer-Policy strict-origin-when-cross-origin always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;

always 让错误响应也带上头。

改完必须做的事

nginx -t && nginx -s reload

-t 失败时不要 reload,nginx 会继续用旧配置,你会以为改了没生效。配置语法错误导致 reload 失败时,线上仍是旧的,但下次重启就会起不来——所以一定要在 -t 通过后再操作。

排查三件套

  • nginx -T:打印最终生效的完整配置(包含 include)
  • tail -f /var/log/nginx/error.log:看真实错误
  • curl -I:看状态码与响应头
有个隐蔽的坑:只替换 conf 文件不 reload,nginx -T 会显示新配置(它读的是磁盘文件),但运行中的 master 仍是旧配置。判断是否生效要看响应头或实际页面。

下一步:HTTPS 全流程。

主题标签
nginx配置部署