把接口请求转发给后台服务
🎯 引言
前面用 Nginx 提供了 HTML 和 CSS 文件。本篇会用 Nginx 在 9001 端口搭一个模拟后台,为 /notes 返回配置里写好的 JSON,然后用 curl 验证 8080 端口的站点入口能否把接口请求转过去。
🧱 先分清三个角色
客户端(本篇用 curl)向站点入口请求 /api/notes,入口按 /api/ 规则把请求转给模拟后台,后台的响应再经由入口回到客户端。客户端只需要知道入口地址,这个过程叫反向代理。
这里接收转发的后台也叫上游服务。后台未来可以换成 Node.js 或其他语言的程序,代理并不要求双方使用同一种技术。
主线实验仍在同一台机器上:入口监听 127.0.0.1:8080,模拟后台监听 127.0.0.1:9001。它们是不同端口,在同一个 Nginx 实例中模拟两种角色,不具有独立应用的进程隔离能力。
🛠 准备可直接访问的模拟后台
创建 conf/servers/mock.conf:
server {
listen 127.0.0.1:9001;
server_name backend-a;
default_type application/json;
location = /notes {
add_header X-Backend 'a';
add_header X-Seen-URI $request_uri;
return 200 '{"instance":"a","notes":["learn nginx"]}';
}
location / {
return 404 '{"error":"not found"}';
}
}
JSON 是常见的数据交换格式。这里的 "notes" 是示例字段名,方括号里的 "learn nginx" 是直接写在 return 指令里的测试数据。请求 /notes 时,Nginx 会把这段固定的 JSON 发回客户端。
$request_uri 是原始请求路径和查询参数;通过实验用的 X-Seen-URI 响应头,可以看出后台实际收到了什么。检查、重载后先直连后台:
curl -i http://127.0.0.1:9001/notes
应返回 200、X-Backend: a 和上面写好的 JSON。先确认模拟后台能直接访问,再配置转发。
🛠 在网页入口增加代理
在 site.conf 的 server 中增加以下两个块,原有资源与页面规则继续保留:
location = /api {
return 308 /api/;
}
location ^~ /api/ {
proxy_pass http://127.0.0.1:9001/;
}
308 是重定向,告诉客户端换一个地址再请求,并保持原请求方法。补上 /api/ 的末尾斜杠是为了让后面的前缀规则一致工作。
检查并重载,然后执行:
curl -i 'http://127.0.0.1:8080/api/notes?type=public'
预期是 200 和 JSON,X-Seen-URI 显示 /notes?type=public。单引号把整个地址当成一个参数,避免终端把特殊字符当作操作符。
🪤 proxy_pass 末尾的斜杠会改变路径
对本篇这种普通前缀块、没有额外重写和变量的配置,规则如下:
| 配置 | 浏览器请求 | 上游收到 |
|---|---|---|
proxy_pass http://127.0.0.1:9001/; | /api/notes | /notes |
proxy_pass http://127.0.0.1:9001; | /api/notes | /api/notes |
proxy_pass http://127.0.0.1:9001/v1/; | /api/notes | /v1/notes |
关键不只是“有没有斜杠”,而是地址后面有没有 URI 部分。有 URI 时,用它替换匹配的 /api/;没有时,本例保留请求路径。复杂重写、变量及正则块有额外约束,不能直接套用这张表。详见proxy_pass 官方说明。
❓ 知识问答
Q1:为什么代理后得到后台的 404?
先看后台实际收到的路径。如果它只认识 /notes,而收到 /api/notes,应修改路径映射,不要用首页回退隐藏错误。
Q2:Nginx 会替后台处理登录和权限吗?
本例不会。它负责转发,用户身份和业务权限仍由应用校验。
🧪 小练习
暂时移除 proxy_pass 地址末尾的 /,检查并重载,再请求 /api/notes;最后恢复配置。
验收:移除后后台返回 JSON 404,恢复后返回 JSON 200。再访问 /api/missing,应仍为后台 JSON 404,不能出现首页 HTML。
🎉 你已经能从后台收到的路径反推代理配置!
