3403 字
17 分钟
Nginx 架构深挖:进程模型、配置结构与 location 匹配顺序

很多人第一次装 Nginx 只干了两件事:把 server 块抄进配置、跑 nginx -t 没报错就完事。配置能跑,不等于理解它。等到某天出现「这个 location 为什么没命中」「改了配置为什么没生效」「一个请求到底走了哪条路」这类问题时,才发现自己对 Nginx 的认知停留在复制粘贴的层面。这篇就从最底层把 Nginx 的骨架拆开:它是怎么用进程扛起并发的,配置块之间怎么继承,一个请求进来之后按什么顺序被匹配——这些是后面反向代理、负载均衡、缓存等所有进阶内容的地基。

master 与 worker:一个管事、多个干活#

Nginx 启动之后,系统里至少有两个进程:一个 master 进程和若干 worker 进程。可以用 ps aux | grep nginx 亲眼看一下,输出大概是这个样子:

Terminal window
root 1234 0.0 0.1 12345 2345 ? Ss 10:00 0:00 nginx: master process /usr/sbin/nginx -g daemon on;
www-data 1235 0.0 0.2 12345 3456 ? S 10:00 0:00 nginx: worker process
www-data 1236 0.0 0.2 12345 3456 ? S 10:00 0:00 nginx: worker process

分工很明确:master 进程不处理任何请求,它只负责读配置、开监听端口、管理 worker 的生死——worker 挂了就拉起一个新的,收到重载信号就让 worker 优雅地换配置。不要直接 kill 掉 master 进程,那样所有 worker 会跟着失去管理,正在处理的请求也会被一并掐断;想停服务用 nginx -s quit 优雅退出。worker 进程才是真正干活的,每一个 worker 都能独立处理成百上千个并发连接。master 只有一个,worker 有几个由 worker_processes 决定,通常写 auto,让 Nginx 按 CPU 核心数自己算。

这种「一个管事、多个干活」的结构带来两个实打实的好处。第一是平滑重载:执行 nginx -s reload 时,master 让老 worker 继续把手头正在处理的请求做完、同时用新配置启动新 worker 接新请求,服务全程不断,不断连接也不丢——这也是生产环境改配置的标准姿势。第二是故障隔离:某个 worker 因为个别请求崩掉,只影响它手里的连接,master 马上补一个新 worker 顶上,整个服务不会跟着倒。

WARNING

nginx -s reload 不是万能的:它只对能热重载的配置生效,改动监听端口这类涉及 master 的部分、或者配置文件本身有语法错误,都会导致重载失败。每次改完配置先跑 nginx -t 校验,通过了再 reload;reload 之后也要看一眼错误日志,确认新 worker 真的起来了。

事件驱动:一个 worker 怎么同时伺候几千个连接#

Nginx 能以很小的内存扛起高并发,靠的是事件驱动模型。传统模型是一个连接一个线程,连接一多线程就爆炸;Nginx 的 worker 是单线程的,它不为每个连接单独开线程,而是用操作系统的事件通知机制(Linux 上是 epoll)盯着所有连接:哪个连接有数据到了,就处理一下,处理完立刻去看下一个,中间不阻塞等待。

worker_connections 就是单个 worker 能同时盯着的连接数上限,默认值 512,生产环境一般会调大。一个简单的换算关系是:理论最大并发连接数 ≈ worker_processes × worker_connections。但这个数字只是天花板,真正能撑多少还要看内存、文件句柄数和后端响应速度,调大之前先确认系统 ulimit -n 的上限够不够。

事件驱动还有一个隐含前提:worker 里不能有长时间阻塞的操作。Nginx 的设计哲学是把耗时的工作交给别人——读磁盘用异步 IO、访问后端用非阻塞的网络调用,所以它自己永远不被某个慢请求拖住。这也是为什么 Nginx 做静态文件和反向代理特别快:它做的事全是「转发」而不是「等待」。

配置块与继承:先看清这张层级图#

Nginx 的配置是一层套一层的块结构,从外到内依次是:

events {
worker_connections 1024;
}
http {
include mime.types;
sendfile on;
server {
listen 80;
server_name example.com;
location / {
root /var/www/html;
}
location /api/ {
proxy_pass http://127.0.0.1:8080;
}
}
}

最外层是 main(全局上下文),events 块管连接层面的事,http 块管 HTTP 服务,server 块对应一个虚拟主机,location 块对应这台虚拟主机里的一类请求路径。include 指令可以把其他文件的内容原地展开,Debian/Ubuntu 上常见的 sites-enabled 目录就是靠它组织多个站点的。

理解配置的关键是继承规则。大部分指令是「向下继承」的:在 http 块里写了 sendfile on,下面所有 server 和 location 默认都继承这个值;如果某个 location 自己又写了一遍,就以它自己的为准。但有几类指令是例外,数组型指令不会继承,最典型的就是 add_header 和 proxy_set_header:只要子块里写了任意一条 add_header,父块里写的 add_header 就全部失效,不会合并。这是个经典坑:有人在 http 块里统一加了安全响应头,又在某个 location 里单独加了一条,结果全站的安全头全丢了。

另一个容易踩的坑是 root 与 alias 的区别。root 是把 location 的 URI 拼到路径后面,alias 是把 location 的前缀替换掉:

location /static/ {
root /var/www;
}
location /images/ {
alias /var/www/pictures/;
}

请求 /static/a.png 时,root 的做法是拼出 /var/www/static/a.png;请求 /images/b.png 时,alias 的做法是把 /images/ 换成 /var/www/pictures/,得到 /var/www/pictures/b.png。用 alias 时注意末尾的斜杠必须成对出现——location 以 / 结尾,alias 的路径也要以 / 结尾,否则路径拼接会错位。

location 匹配:Nginx 先看谁、再看谁#

一个请求进来之后,Nginx 先按 server_name 找到对应的 server 块,再在这个块里按规则找 location。location 的匹配分四种写法,优先级从高到低是固定的:

优先级写法含义
1location = /exact精确匹配,URI 必须一字不差
2location ^~ /prefix/最长前缀匹配,命中后不再看正则
3location ~ \.php$正则匹配,按配置文件中出现的顺序逐个试
4location /prefix/普通前缀匹配,取其中最长的那个

具体的匹配流程分三步走:

  1. 先找精确匹配。如果有 location = / 这种写法且 URI 完全相等,直接命中,流程结束。精确匹配最常用来处理首页或健康检查路径。
  2. 再找最长前缀匹配。把所有普通前缀和 ^~ 前缀都比一遍,取最长的那个记下来。如果这个最长的是 ^~,直接命中,不再看正则;如果不是 ^~,先记下来,再继续第三步。
  3. 按顺序试正则。从上到下逐个测试正则 location,第一个命中的就是结果。如果一个正则都没命中,就用第二步记下来的最长前缀。
location = /health {
access_log off;
return 200 "ok";
}
location ^~ /static/ {
root /var/www;
expires 30d;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location / {
root /var/www/html;
index index.html;
}

拿几个请求走一遍就明白了。请求 /health:第一步精确匹配命中,直接返回 ok,连日志都不记。请求 /static/logo.png:最长前缀是 ^~ /static/,直接命中,不会再去试后面的正则。请求 /index.php:前缀匹配记下 /,然后正则 \.php$ 命中,交给 PHP 处理。请求 /about.html:没有正则命中,落回最长前缀 /,按 root 找文件。

WARNING

正则 location 是按配置文件中的书写顺序逐个测试的,不是按正则写得有多精确排序。两个正则都能匹配同一个 URI 时,写在前面的那个赢。调整顺序之前,先想清楚有没有更具体的规则被前面的宽泛规则抢走了。

还有一个细节值得单独提:location / 这个写法看起来像个兜底,实际上它是「长度为零的前缀」,任何 URI 都能匹配它。Nginx 选它只是因为没有更长的前缀可选,而不是因为它有什么特殊地位。Nginx 选它只是因为没有更长的前缀可选,而不是因为它有什么特殊地位。理解这一点,就不会再问「为什么我的请求走了 / 而不是别的 location」——答案永远是:更具体的那条规则要么不存在,要么没排上。

try_files:文件找不到时按顺序试#

try_files 是 Nginx 里最常用的「按顺序试」指令,写法是给出一串候选,最后一个是兜底:

location / {
root /var/www/html;
try_files $uri $uri/ /index.html;
}

请求 /about.html 时,Nginx 先试 $uri 对应的文件 /var/www/html/about.html,存在就直接返回;不存在就试 $uri/ 对应的目录;再不存在就按最后一个参数做内部重定向,去请求 /index.html。单页应用(SPA)的部署基本都靠这一行:所有前端路由都不存在真实文件,最后统一落到 index.html,由前端路由接管。

要注意最后一个参数的两种形态:写成 =404 就是直接返回 404 状态码,写成 URI 就是内部重定向到那个 URI(会重新走一遍 location 匹配)。用 try_files $uri $uri/ =404 做静态站点时,目录不存在也不会误判成奇怪的响应。

还有一个常见误区:try_files 里不要写 http:// 开头的完整 URL 做兜底,那会触发 302 跳转到外部地址,多数情况下不是想要的效果。内部兜底用相对 URI,外部跳转用 return 301 显式写清楚。

请求处理阶段:一句话带过全貌#

从请求进入 Nginx 到响应发出去,中间要经过一系列阶段:读请求头、找 server、找 location、做重写、做访问控制、找内容、生成响应、写日志。大部分阶段对使用者是透明的,知道两个结论就够了:rewrite 指令发生在 location 匹配之后、内容生成之前,所以它能改变请求最终落到哪个 location;而 access_log 写在流程末尾,所以日志里记录的是处理完成后的最终状态,包括内部重定向之后的 URI。后面讲日志排障时还会回到这个话题。

排障:三个最常见的架构级问题#

前面讲的都是「正常时怎么工作」,这里补三条「出问题时先查什么」。架构层面的故障大多不是配置写错一个单词,而是对上面某个机制理解错了。

改了配置,行为一点没变。 先确认两件事:第一,改的是不是正在运行的那个 Nginx 读的配置文件——Debian/Ubuntu 上 sites-enabled 里是符号链接,改源文件和改链接目标是两回事,用 nginx -T 可以把实际生效的完整配置打出来核对;第二,改完有没有 reload。只改文件不 reload,master 手里的还是旧配置。nginx -t 通过只说明语法没错,不代表已生效,reload 之后再看一眼错误日志里有没有新 worker 启动失败的记录。

请求落到了意料之外的 location。 先把匹配流程按本篇的优先级表手算一遍,重点查两处:有没有更具体的正则被写在前面的宽泛正则抢走了,以及 ^~ 是不是把正则短路了。拿不准的时候可以临时打开 rewrite_log on 并把 error_log 级别调到 notice,日志里会记录每一次内部重写与 location 的选择过程,复现一次请求就能看清路径。查完记得把日志级别调回去,生产环境长期开 debug 级日志会把磁盘写满。

并发一上来就报 502 或连接被拒绝。 先看错误日志里有没有 worker_connections are not enough,有就是单个 worker 的连接数打满了,调大 worker_connections 之前先确认 ulimit -n 给每个 worker 的文件句柄够不够用——句柄数是硬上限,配置写得再大也突破不了它。另一个常见原因是 worker_processes 只设了 1,单核扛全站流量,改成 auto 让 Nginx 按核心数起 worker。调完之后用 nginx -t 校验再 reload,调参数之前先看日志定性,不要凭感觉同时改五六个值,否则出了效果也不知道是哪一个起的作用。

小结#

这篇把 Nginx 的骨架拆成了四块:master/worker 进程模型负责稳定与平滑重载,事件驱动负责用一个 worker 扛起大量并发,配置块与继承规则决定了每条指令到底对谁生效,location 匹配顺序与 try_files决定了每个请求最终落到哪里。把这四块记牢,后面几篇讲反向代理、负载均衡、缓存时,每一条配置都能找到它落脚的位置,不再是「抄过来能跑就行」的黑盒。

下一篇讲反向代理:proxy_pass 后面那个斜杠到底改变了什么、请求头要怎么传、缓冲开还是关,以及上游连接怎么复用。反向代理的配置如果还停留在 《用 Docker 部署 Nginx 反向代理与自动 HTTPS》 那种「能跑起来」的水平,这篇架构是理解它的前提;如果站点多到手写配置开始吃力,也可以先看 《Nginx Proxy Manager:图形化反代与自动 HTTPS》 了解面板路线的取舍。

Nginx 架构深挖:进程模型、配置结构与 location 匹配顺序
https://www.anexns.cloudns.org/posts/webserver-nginx-architecture/
作者
Anexns
发布于
2026-11-16
许可协议
CC BY-NC-SA 4.0