Nginx 中如何使用 proxy_pass 实现内部转发-Nginx-PHP中文网

proxy_pass末尾斜杠决定路径处理方式：带斜杠时替换location前缀，不带斜杠时原样拼接完整URI；推荐location与proxy_pass均显式以/结尾，确保行为可预测。

nginx 中如何使用 proxy_pass 实现内部转发

在 Nginx 中，proxy_pass 是实现反向代理和内部请求转发的核心指令，常用于将客户端请求转给后端应用服务（如 Node.js、Python Flask、Java Spring Boot 等），而对外仍统一暴露 Nginx 的地址和端口。

基本语法与路径匹配逻辑

proxy_pass 必须写在 location 块中，它的行为高度依赖 location 的匹配方式和末尾斜杠：

如果 location /api/ 以 / 结尾，且 proxy_pass http://backend/ 也以 / 结尾，Nginx 会自动“剥离” /api/ 前缀再转发。例如请求 /api/users → 实际发给 http://backend/users
如果 proxy_pass http://backend 不带结尾斜杠，则整个原始 URI（包括 /api/）会被完整拼接过去：请求 /api/users → 发给 http://backend/api/users
不推荐在 proxy_pass 后直接写带路径的 URL（如 http://backend/v1/），Nginx 会忽略该路径，仅用 host + port，容易引发误解

常见配置示例

假设后端服务运行在 127.0.0.1:3000，前端静态资源由 Nginx 直接服务，API 请求需转发：

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;"># 静态文件直接返回
location / {
    root /var/www/html;
    try_files $uri $uri/ /index.html;
}

# 将 /api/ 开头的请求转发到本地 Node.js 服务
location /api/ {
    proxy_pass http://127.0.0.1:3000/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

}

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

注意：proxy_pass http://127.0.0.1:3000/ 末尾的 / 是关键，它确保 /api/ 被去掉，避免后端收到冗余前缀。

转发时必须设置的请求头

后端服务常依赖原始请求信息（如真实 IP、协议类型），若不显式透传，可能出错或日志失真：

Host：让后端知道原始域名，尤其当多个域名共用一个后端时
X-Real-IP 和 X-Forwarded-For：传递客户端真实 IP（后者支持多层代理链）
X-Forwarded-Proto：告知后端当前是 http 还是 https，影响重定向或链接生成

调试与排错要点

转发失败时，优先检查这几项：

后端服务是否真的在监听对应地址和端口（用 curl -v http://127.0.0.1:3000/health 验证）
Nginx 配置是否重载（nginx -t && nginx -s reload）
错误日志位置（默认 /var/log/nginx/error.log），关注 connect() failed 或 no live upstreams
防火墙或 SELinux 是否拦截了 Nginx 到后端的 outbound 连接