Nginx中将/代理到后端子目录（如/app/）需在proxy_pass末尾加斜杠，如proxy_pass http://127.0.0.1:8080/app/;，否则会错误拼接路径导致404。
在 Nginx 中，用 proxy_pass 将根路径（如 /）请求代理到后端服务的子目录（例如 http://backend/app/），关键在于正确处理 URI 重写 —— 否则默认会把原始请求路径原样拼到后端地址后，导致访问错位。
理解 proxy_pass 的路径截断规则
Nginx 对 proxy_pass 后是否带路径尾部斜杠（/）非常敏感：
- 如果
proxy_pass以/结尾（如proxy_pass http://backend/;），Nginx 会删除匹配 location 的前缀路径，再拼接后端路径； - 如果
proxy_pass不带尾部斜杠（如proxy_pass http://backend;），Nginx 会保留原始请求 URI 全量拼接，容易出错。
将 / 代理到后端子目录（如 /app/）的推荐写法
假设你想让用户访问 https://example.com/xxx 时，实际请求后端 http://127.0.0.1:8080/app/xxx，配置如下：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
location / {
proxy_pass http://127.0.0.1:8080/app/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
✅ 这里 proxy_pass 以 /app/ 结尾，Nginx 会：
- 匹配
location /时，原始请求 URI（如/api/user）被截去/前缀，剩下api/user； - 再拼接到
proxy_pass指定的/app/后，最终发出请求：http://127.0.0.1:8080/app/api/user。
常见陷阱与避坑提示
⚠️ 注意以下易错点：
-
不要写成
proxy_pass http://backend/app（无结尾斜杠）：Nginx 会把完整 URI（如/api）直接拼过去，变成http://backend/app/api—— 看似一样，但若后端依赖路径解析（如前端路由或静态资源 base），可能 404； -
如果后端是单页应用（SPA），且依赖 HTML5 History 模式，需确保后端能正确响应
/app/下所有路径，否则刷新页面会 404； -
需要重写 Host 头或传递原始路径时，可配合
proxy_redirect或rewrite，但多数场景仅靠proxy_pass尾斜杠已足够。
验证是否生效的小技巧
可在后端加个简单日志或返回头，观察实际收到的请求路径；也可用 curl -v http://nginx-server/health 查看响应头中的 X-Original-URI（如果你加了该 header）或直接查后端 access log。
