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 的匹配顺序
=精确匹配,最高优先^~前缀匹配,命中后不再看正则~正则(区分大小写)、~*(不区分)- 普通前缀匹配,取最长
实践建议:能用 = 和 ^~ 就别用正则,正则多了以后很难判断哪个生效。
root 与 alias 的区别
root /path:最终路径 =root+ 完整 URIalias /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 全流程。