Nginx 反向代理中怎么配置才能代理非标准端口的第三方 API 服务-Nginx-PHP中文网

要让 nginx 成功代理非标准端口的第三方 api，必须显式指定含协议和端口的 proxy_pass 地址（如 http://api.example.com:8081/），精准处理路径拼接（location 与 proxy_pass 均带尾部斜杠以剥离前缀），透传 host、x-real-ip、x-forwarded-for、x-forwarded-proto 四大请求头，并为 websocket 补充 http_version 1.1 及 upgrade/connection 头，同时确认第三方服务监听 0.0.0.0 且网络可达。

nginx 反向代理中怎么配置才能代理非标准端口的第三方 api 服务

要让 Nginx 成功代理运行在非标准端口（如 3001、8081、9000 等）的第三方 API 服务，关键不是“加个 proxy_pass 就完事”，而是确保地址写对、路径不乱、头传全、连接不断、后端真能收得到。

proxy_pass 必须显式带协议和端口

第三方 API 若监听在非 80/443 端口（比如 http://api.example.com:8081/v1），Nginx 的 proxy_pass 就不能省略端口号，也不能依赖默认端口：

✅ 正确写法：`proxy_pass http://api.example.com:8081/;`（末尾斜杠表示剥离 location 前缀）
✅ 也正确：`proxy_pass https://api.example.com:8443/;`（HTTPS + 非标端口）
❌ 错误写法：`proxy_pass http://api.example.com;`（Nginx 默认走 80，请求发不到 8081）
❌ 错误写法：`proxy_pass http://api.example.com:8081;`（没斜杠，会导致路径拼接错误，如 /api/users 变成 http://...:8081/api/users 而不是预期的 http://...:8081/v1/api/users）

必须透传关键请求头

第三方 API 通常依赖 Host、协议类型、原始 IP 等信息做鉴权或路由。Nginx 默认不转发这些，需手动设置：

proxy_set_header Host $host; —— 防止因 Host 不匹配返回 404 或被拒绝
proxy_set_header X-Real-IP $remote_addr; —— 提供真实客户端 IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; —— 支持多级代理场景
proxy_set_header X-Forwarded-Proto $scheme; —— 告诉后端当前是 http 还是 https，避免重定向跳转错误

注意路径重写逻辑

如果想把 /third-party/ 映射到第三方 API 的根路径（比如 http://api.example.com:8081/），location 和 proxy_pass 的斜杠配合很重要：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

location /third-party/ { proxy_pass http://api.example.com:8081/; } → 请求 /third-party/users 会转发为 http://...:8081/users
location /third-party { proxy_pass http://api.example.com:8081; } → 请求 /third-party/users 会转发为 http://...:8081/third-party/users（多数第三方 API 不认这个路径）

简单记：location 以 / 结尾，proxy_pass 也以 / 结尾，才能干净剥离前缀。