要让 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 成功代理运行在非标准端口（如 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 的斜杠配合很重要：
-
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 也以 / 结尾，才能干净剥离前缀。
检查第三方服务是否可被 Nginx 访问
配置写得再准，如果 Nginx 所在机器根本连不上那个端口，一切白搭：
- 确认第三方 API 服务监听的是
0.0.0.0:8081，而非仅127.0.0.1:8081（否则 Nginx 无法从外部访问） - 在 Nginx 服务器上执行：
curl -v http://api.example.com:8081/health，看能否通 - 检查防火墙（ufw/firewalld）、云厂商安全组，确保出向（Nginx → 第三方）和入向（第三方 → Nginx）端口放行
- 若第三方域名解析依赖内网 DNS，需确认 Nginx 所在机器的
/etc/resolv.conf配置正确
特殊协议支持（如 WebSocket）
如果该第三方 API 提供 WebSocket 接口（例如实时通知、长连接推送），必须额外启用 HTTP/1.1 升级机制：
proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";
这三行缺一不可，否则连接会在默认超时（60 秒）后静默断开。
