1. 先按 listen 端口过滤（只看监听同一端口的 server）2. 再按 server_name 匹配（精确 → 通配符 → 正则 → default_server）

nginx
server {listen80;server_name a.example.com;}server {listen8080;server_name a.example.com;}

nginx
# 精确单个server_name a.example.com;# 多个精确（一个 server 服务多域名）server_name a.example.com b.example.com;# 通配符server_name*.example.com;# 主域 + 所有子域server_name example.com *.example.com;# 兜底：catch-allserver_name _;# 正则（必须 ~ 开头）server_name ~^api(?<num>\d+)\.example\.com$;

nginx
listen80;                          # IPv4 任意地址listen [::]:80;                     # IPv6 任意地址listen80 default_server;           # 标记为默认 server（**同一端口只能有一个 default**）listen443 ssl http2;               # HTTPS + HTTP/2（注意 1.25.1 起推荐写 `http2 on;`）listen unix:/run/nginx-internal.sock;   # Unix socket（内部转发用）listen80 reuseport;                # 启用 SO_REUSEPORT，多 worker 各自 accept（高并发场景）

nginx
# 第一个 server 就放个明确的 default，拒绝未识别 Hostserver {listen80 default_server;server_name _;return444;       # nginx 内部状态码，直接关闭连接不返回}

nginx
server {listen80;server_name demo.local;location = / {return200"A: 精确根路径\n";    }location = /favicon.ico {return200"B: 精确 favicon\n";    }location ^~ /static/ {return200"C: ^~ /static/\n";    }location~ \.php$ {return200"D: 正则 .php\n";    }location~* \.(jpg|png|gif)$ {return200"E: 正则不区分大小写图片\n";    }location /api/ {return200"F: 普通前缀 /api/\n";    }location / {return200"G: 普通前缀 / (兜底)\n";    }}

nginx
# 写法 1：用 rootlocation /static/ {root /var/www;}# Nginx 拼接：root + 完整 URI# 实际磁盘路径：/var/www/static/x.png# 写法 2：用 aliaslocation /static/ {alias /var/www/assets/;}# Nginx 替换：alias 替换掉 location 部分# 实际磁盘路径：/var/www/assets/x.png# 写法 3：alias 路径与 location 不同名（最常见用法）location /imgs/ {alias /data/pictures/;}# 请求 /imgs/cat.jpg → 磁盘 /data/pictures/cat.jpg

nginx
server {listen80;server_name demo.local;root /var/www/my-site;        # ← 默认根目录location / {try_files$uri$uri/ /index.html;    }location /docs/ {# 没写 root，自动用 server 级别的 /var/www/my-site# 请求 /docs/a.html → /var/www/my-site/docs/a.html    }location /assets/ {# 想给 /assets 单独换路径，这里覆盖alias /opt/cdn-cache/;# 请求 /assets/main.css → /opt/cdn-cache/main.css    }}

nginx
# ❌ 坑 1：alias 末尾没斜杠location /static/ {alias /var/www/assets;    # 缺 /}# 请求 /static/x.png 实际去找 /var/www/assetsx.png（路径被拼坏）# ✅ 正确：location 和 alias 都要么都有 /，要么都没 /location /static/ {alias /var/www/assets/;}# ❌ 坑 2：在 server 上下文用了 aliasserver {alias /var/www/x;         # ❌ alias 不能用在 server 级}# ❌ 坑 3：正则 location 配 alias 用错变量location~ ^/imgs/(.+)\.jpg$ {alias /data/$1.jpg;        # 这种写法在新版 nginx 已不推荐，建议 try_files}

nginx
location / {try_files$uri$uri/ =404;# 1. 试 $uri 本身是不是文件# 2. 试 $uri/ 是不是目录（自动找 index）# 3. 都没有，返回 404}

nginx
location / {try_files$uri$uri/ /index.html;# 文件在就给文件，否则统统返回 index.html# 这样前端路由刷新 /users/123 也不会 404}

nginx
location / {try_files$uri$uri/ /index.php?$query_string;}location~ \.php$ {fastcgi_pass unix:/run/php/php8.2-fpm.sock;fastcgi_index index.php;include fastcgi_params;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;}

bash
sudotail -f /var/log/nginx/error.log# 再访问一次出问题的 URL，等错误打出来

*123 open() "/var/www/static/static/img/x.png" failed (2: No such file or directory),client: 127.0.0.1, server: demo.local, request: "GET /static/img/x.png HTTP/1.1"

nginx
# 假设原配置location /static/ {root /var/www/static;     # ← root 会拼上 location，变成 /var/www/static/static/...}# 修正方案 A：去掉 root 里的 staticlocation /static/ {root /var/www;            # → /var/www/static/img/x.png}# 修正方案 B：用 aliaslocation /static/ {alias /var/www/static/;   # → /var/www/static/img/x.png}

bash
sudo -u www-data ls /var/www/static/img/x.png# 如果 Permission denied 就是权限问题# Nginx 用户需要：目录有 x（能进入）+ 文件有 r（能读）sudochown -R www-data:www-data /var/www/staticsudochmod -R 755 /var/www/static

nginx
# error_log 改成 debug 级别（**仅排查时开**）error_log /var/log/nginx/error.log debug;

test location: "/static/"using configuration "/static/"http filename: "/var/www/static/img/x.png"

nginx
location /protected/ {    internal;                                  # 外部 GET /protected/x 直接 404alias /var/www/protected-files/;}location /api/download/ {# 应用做鉴权后，回 X-Accel-Redirect 头给 nginxproxy_pass http://backend;}

nginx
server {# ━━ listen ━━listen80;listen [::]:80;                              # 同时听 IPv6# ━━ server_name ━━server_name www.example.com example.com;# ━━ 根路径写在 server 级，全 server 共享 ━━root /var/www/example;index index.html;# ━━ 日志分站点 ━━access_log /var/log/nginx/example.access.log;error_log  /var/log/nginx/example.error.log warn;# ━━ 通用 location ━━location / {try_files$uri$uri/ =404;    }# ━━ 静态资源单独缓存 ━━location~* \.(jpg|png|css|js)$ {expires7d;add_header Cache-Control "public, immutable";    }# ━━ 隐藏文件拒绝访问 ━━location~ /\. {deny all;access_logoff;log_not_foundoff;    }# ━━ 转发 API 到后端 ━━location /api/ {proxy_pass http://127.0.0.1:3000/;       # 注意结尾的 /，下一篇详讲proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;    }}