把接口请求转发给后台服务

理解反向代理的请求流向,掌握 proxy_pass 的路径保留与替换规则。

🎯 引言

前面用 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:

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。


🎉 你已经能从后台收到的路径反推代理配置!