用 server 和 location 决定请求去向
🎯 引言
同一个 Nginx 可以接收多个站点、多个路径的请求。本篇把选择过程拆成两步:先选站点,再选站点内部的处理规则。
🧱 先根据地址、端口和名字选站点
请求首先要到达 listen 指定的地址与端口,然后才会用 HTTP 请求头里的 Host 匹配 server_name。如果名字匹配不上,就使用该监听地址与端口的默认站点。这一顺序见官方请求处理说明。
创建 conf/servers/other.conf:
server {
listen 127.0.0.1:8080;
server_name other.test;
location / {
return 200 'other site\n';
}
}
return 直接结束请求并返回给定状态码和内容。重载后,用 -H 添加请求头来模拟域名:
curl -i -H 'Host: notes.test' http://127.0.0.1:8080/
curl -i -H 'Host: other.test' http://127.0.0.1:8080/
curl -i -H 'Host: unknown.test' http://127.0.0.1:8080/
第二个请求返回 other site,其余两个都到学习笔记站。这里没有修改 DNS;直接在浏览器输入 other.test 仍可能无法访问。不要为同一地址和端口配置两个 default_server。
🧭 再在站点里选择 location
下面只讨论同一层、不嵌套的 location,以免把入门规则套进复杂结构:
| 写法 | 含义 |
|---|---|
location = /health | 精确匹配 /health |
location /assets/ | 匹配以 /assets/ 开头的路径 |
location ^~ /assets/ | 前缀匹配,选中它后跳过同层正则 |
location ~ \.txt$ | 用大小写敏感的正则匹配以 .txt 结尾的路径 |
location ~* \.txt$ | 正则匹配,但忽略大小写 |
正则表达式是一种描述文字模式的写法,\. 表示真正的点,$ 表示结尾。本课程只用少量简单模式。
选择顺序是:先尝试精确匹配;否则记住最长匹配前缀。如果该前缀带 ^~,直接使用;否则按配置顺序检查正则,第一个匹配的正则获胜;没有正则匹配,才使用刚才记住的前缀。查询参数不参与这里的路径匹配。
🛠 用可观察结果验证规则
在 site.conf 的 server 中保留原有 location /,再添加:
location = /health {
default_type text/plain;
return 200 'healthy\n';
}
location /manual/ {
default_type text/plain;
return 200 'prefix\n';
}
location ~ \.txt$ {
default_type text/plain;
return 200 'regex\n';
}
重载后分别请求 /health?full=1、/manual/start、/manual/start.txt,结果依次为 healthy、prefix、regex。然后给 /manual/ 加上 ^~,重载后最后一个请求也应返回 prefix。
/api/ 不会匹配恰好等于 /api 的路径。需要两者都工作时,单独处理 /api,后面的代理章节会给出写法。
实验完成后删除 other.conf,删除上面 /manual/ 与 .txt 正则测试块,保留 /health。后续要访问真实 .txt 文件,不能继续让测试规则拦截它们。
❓ 知识问答
Q1:把普通前缀 location 放到最上面,就一定优先吗?
不会。普通前缀之间看匹配长度;正则之间才按出现顺序找第一个匹配。
Q2:server_name _; 是特殊的万能匹配吗?
不是。常有人用这个不常见的名字搭配默认站点,但真正让未匹配请求进入该站点的是 listen 的默认规则。
🧪 小练习
增加 location = /about,返回 about page。验证 /about、/about?from=home 和 /about/。
验收:前两者命中精确匹配,第三个不命中。验证后删除这个测试块,让实验目录保持简洁。
🎉 能按规则预测请求去向,就不再需要靠调整代码顺序碰运气!
