要在 nginx 中实现客户端访问 /api/xxx 时后端接收 /xxx，需利用 rewrite 与 proxy_pass 协同：方式一用 rewrite ^/api/(.*)$ /$1 break 配合 proxy_pass http://backend；方式二更推荐，直接写 proxy_pass http://backend/（末尾斜杠自动剥离前缀）。关键点包括必须加 break 防止循环匹配，proxy_pass 末尾斜杠不可省略，且应设置 proxy_set_header host $host 避免后端拒绝请求。
要在 Nginx 中通过 rewrite 配合 proxy_pass 实现无感知的路径隐藏（即客户端访问 /api/xxx，后端实际接收的是 /xxx），关键在于控制 URI 重写时机和 proxy_pass 的路径拼接逻辑。
理解 rewrite 和 proxy_pass 的执行顺序
Nginx 中 rewrite 指令在 proxy_pass 之前执行，但是否生效取决于 proxy_pass 是否带路径尾部斜杠。若 proxy_pass 后跟完整 URI（含路径），Nginx 会忽略 location 匹配的原始 URI；若只指定上游地址（如 http://backend），则默认将匹配到的 URI 原样转发——这时才需要 rewrite 来修改 URI。
正确配置 rewrite + proxy_pass 的两种常用方式
以下两种写法都能实现“访问 /api/v1/user → 后端收到 /v1/user”的效果，选其一即可：
-
方式一：用 rewrite + proxy_pass 不带路径
location /api/ {
rewrite ^/api/(.*)$ /$1 break;
proxy_pass http://backend;
} -
方式二：proxy_pass 直接带目标路径（更推荐）
location /api/ {
proxy_pass http://backend/;
}
注意：这里proxy_pass末尾的/很关键——它会让 Nginx 自动剥离/api/前缀，再拼接剩余部分到 upstream 地址后。
避免常见陷阱
容易出错的地方包括：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- rewrite 后漏写
break：不加break会导致重写后再次进入 location 匹配循环，可能引发 500 或无限重定向； - proxy_pass 写成
http://backend（无尾部斜杠）：此时 Nginx 会把整个原始 URI（如/api/v1/user）原样转发，rewrite 就白做了； - location 使用正则表达式但未加
^~或~修饰符：可能导致优先级混乱，rewrite 不触发； - 后端服务对 Host 头或 Referer 敏感：建议显式设置
proxy_set_header Host $host;，避免后端因 Host 不匹配拒绝请求。
验证是否生效的小技巧
可在后端服务日志中打印接收到的完整请求路径，或临时用 return 200 "URI: $request_uri\n"; 替代 proxy_pass 测试 rewrite 结果。例如：
location /api/ {
rewrite ^/api/(.*)$ /$1 break;
return 200 "Forwarded to: $uri";
}
访问 /api/test 应返回 Forwarded to: /test，说明 rewrite 已正确剥离前缀。
