Nginx 中 proxy_pass 代理不同业务模块的方法详解-Nginx-PHP中文网

proxy_pass末尾斜杠决定路径是“替换”还是“原样拼接”：location /api/ 与 proxy_pass http://backend/; 组合时剥离前缀，请求/api/v1/users→后端收到/v1/users；而location /admin 与 proxy_pass http://backend; 则原样转发/admin/login→后端收到/admin/login。

nginx 中 proxy_pass 代理不同业务模块的方法详解

在 Nginx 中，proxy_pass 是实现反向代理的核心指令，它不单是“转发请求”这么简单，而是支撑多业务模块隔离、路由分发和架构解耦的关键机制。实际使用中，重点在于 location 匹配规则与 proxy_pass 路径拼接逻辑的配合，稍有不慎就会导致路径错乱或 404。

按业务路径前缀做精确路由

最常用也最稳妥的方式，是用 location 块匹配不同业务模块的 URL 前缀，再通过 proxy_pass 指向对应后端服务。关键点在于末尾斜杠的处理：

若 location /api/ 后带斜杠，且 proxy_pass http://backend1/; 也带斜杠，Nginx 会自动剥离 /api/ 再拼接，例如请求 /api/v1/users → 后端收到 /v1/users
若 location /admin（不带尾斜杠），而 proxy_pass http://backend2; 也不带斜杠，则整个路径原样转发，/admin/login → 后端收到 /admin/login
错误示例：location /user + proxy_pass http://srv/;，会导致请求 /user/profile 变成 /profile，后端可能找不到接口

用 upstream 实现模块级服务编组

当同一业务模块由多个实例提供服务（如微服务集群），应将后端地址定义在 upstream 块中，再在 proxy_pass 中引用名称，便于统一管理与负载均衡：

CPA Update - Secure CLI Proxy API Maintenance

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

下载

在 http 块顶层定义：upstream user-svc { server 10.0.1.10:8080; server 10.0.1.11:8080; }
在对应 location 中写：proxy_pass http://user-svc;（注意末尾分号）
可叠加健康检查：server 10.0.1.10:8080 max_fails=3 fail_timeout=30s;
支持权重、备份节点、IP hash 等策略，适合灰度发布或流量调度

跨协议与跨域场景下的 proxy_pass 配置

代理不只限于 HTTP，也可桥接其他协议；同时需主动处理跨域头，避免前端被浏览器拦截：

代理 WebSocket：在 location 中添加 proxy_http_version 1.1; 和 proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade";
代理 HTTPS 后端：proxy_pass https://backend-secure;，需确保 Nginx 编译时启用了 OpenSSL 支持
解决跨域：显式设置 proxy_set_header Origin ""; 或透传原始 Origin，并配合 add_header Access-Control-Allow-Origin *;（生产环境慎用通配符）
透传真实客户端 IP：proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;