nginx 中 alias 和 proxy_pass 不能共存于同一 location 块，因二者同属互斥的内容处理指令；正确做法是用多个 location 按路径分流，如 /static/ 用 alias 映射本地目录，/ 其余路径用 proxy_pass 代理后端。
Nginx 中 alias 和 proxy_pass 不能直接用在同一个 location 块里 —— 这是常见误区。因为 alias 用于本地文件路径映射，而 proxy_pass 是反向代理转发，二者语义冲突，Nginx 会报错或行为异常（比如忽略 alias、路径拼接错误）。
为什么 alias + proxy_pass 不行？
alias 的作用是把 location 匹配的 URI 路径“替换”为指定的本地文件系统路径；proxy_pass 则是把请求完整（或按规则重写后）转发给后端服务。Nginx 在一个 location 中只允许一个“内容处理指令”，alias 和 proxy_pass 都属于这类指令，互斥。
实际需求通常是什么？
你真正想做的，大概率是：把某个 URL 路径（如 /static/）映射到本地目录，其余路径（如 /api/、/）代理到后端服务。这不是“同时用”，而是“按路径分流”——用多个 location 块分别处理。
正确写法：用多个 location 分开配置
例如，让 /static/ 指向本地磁盘，其他所有请求（包括 /、/api/）都代理到 https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1：
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
location /static/ {
alias /var/www/myapp/static/;
# 注意：alias 后路径末尾要有 /，且 location 末尾也要有 /
}
<p>location / {
proxy_pass <a href="https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1">https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1</a>;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}</p>
关键细节：
-
location /static/和alias /var/www/myapp/static/末尾都带/，这样/static/js/app.js会映射到/var/www/myapp/static/js/app.js -
location /必须放在后面（或确保优先级更低），避免覆盖更具体的匹配；Nginx location 匹配遵循最长前缀原则，所以/static/会优先生效 - 不需要、也不应该在
proxy_pass的 location 里写alias
如果想“代理时重写路径”，用 rewrite + proxy_pass
比如要把 /backend/api/ 代理到 http://127.0.0.1:8080/api/，去掉前缀 /backend：
location /backend/ {
rewrite ^/backend/(.*)$ /$1 break;
proxy_pass http://127.0.0.1:8080;
}
注意：rewrite ... break 会让 Nginx 内部重写 URI 后不再重新匹配 location，然后 proxy_pass 使用新 URI 转发（即 /api/xxx）。这里没用 alias，因为它不参与代理逻辑。
