Nginx 中如何使用 proxy_pass 实现后端服务反向代理-Nginx-PHP中文网

nginx反向代理需正确配置proxy_pass的协议+主机、路径匹配规则、请求头（host/x-real-ip/x-forwarded-for）、重定向与cookie路径重写、cors处理，并配合upstream实现负载均衡与容错。

nginx 中如何使用 proxy_pass 实现后端服务反向代理

Nginx 使用 proxy_pass 实现反向代理，核心是把客户端请求转发给后端服务，并将响应原样返回。关键在于路径匹配、请求头处理和协议兼容性，而不是简单写一行配置就完事。

proxy_pass 后面必须是完整的协议+主机（可选端口），例如 http://127.0.0.1:8000 或 http://backend（配合 upstream）。Nginx 不会自动补全协议或默认端口，缺了 http:// 会导致 502 错误。

如果 location 用精确匹配（location = /api），proxy_pass 末尾加不加 / 不影响路径拼接
如果 location 是前缀匹配（location /api/），proxy_pass 末尾带 / 会截掉匹配部分再拼接；不带则原样转发路径
错误示例：proxy_pass http://127.0.0.1; 缺少端口或路径，可能被当作 http://127.0.0.1/，但后端未必监听根路径

默认情况下，Nginx 转发请求时会把 Host 头改成 proxy_pass 指定的地址，后端可能因此无法识别原始域名。同时，不显式设置 X-Real-IP 和 X-Forwarded-For，后端拿到的 IP 就是 Nginx 本机地址。

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

后端返回 302 重定向时，Location 头里的地址通常是内部地址（如 http://localhost:8000/login），直接返回给浏览器会失败。同理，Set-Cookie 中的 Path 或 Domain 也可能不匹配前端域名。

用 proxy_redirect 重写重定向地址，例如 proxy_redirect http://localhost:8000/ https://example.com/;
若后端 Cookie 的 Path 是 / 但实际部署在子路径下，可用 proxy_cookie_path / /subpath/; 修正
对跨域场景，确保后端设置了 Access-Control-Allow-Origin，或 Nginx 主动添加 CORS 头（仅限开发或简单需求）