Linux Nginx 怎么配置 proxy_pass 实现后端服务反向代理-Nginx-PHP中文网

nginx反向代理核心是正确配置proxy_pass及配套头信息与超时参数。末尾斜杠影响路径重写；必须设置host、x-real-ip、x-forwarded-for、x-forwarded-proto等头；需补全proxy_redirect、websocket支持和超时配置。

linux nginx 怎么配置 proxy_pass 实现后端服务反向代理

在 Linux 系统中用 Nginx 配置 proxy_pass 实现反向代理，核心是让 Nginx 接收客户端请求后，把请求转发给后端服务（如 Node.js、Python Flask、Java 应用等），再把响应原样返回给用户。关键不在“能不能转”，而在于路径处理、头信息、超时和协议一致性是否正确。

基础 proxy_pass 配置写法

最简配置示例（假设后端服务运行在 http://127.0.0.1:3000）：

location / {
    proxy_pass http://127.0.0.1:3000;
}

注意：proxy_pass 后面的 URL 末尾是否有斜杠（/），会极大影响路径拼接逻辑：

写成 proxy_pass http://127.0.0.1:3000;（无尾部 /）→ 请求 /api/user 会被完整转发为 http://127.0.0.1:3000/api/user
写成 proxy_pass http://127.0.0.1:3000/;（有尾部 /）→ 请求 /api/user 会被重写为 http://127.0.0.1:3000/user（/api 被剥离）

必须设置的关键代理头信息

如果不显式设置，后端可能拿不到真实客户端 IP、协议类型或 Host，导致日志不准、HTTPS 判断失败、重定向异常等问题。推荐在 location 块内加上：

Linux Ai Server

Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。

下载

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;

其中：

X-Real-IP 和 X-Forwarded-For 是后端获取用户真实 IP 的主要依据
X-Forwarded-Proto 让后端知道原始请求是 HTTP 还是 HTTPS，避免强制跳转出错

常见问题与对应配置补丁

实际部署中容易踩坑的地方：

后端返回 302 重定向地址错误：Nginx 默认不改写后端响应里的 Location 头。可加 proxy_redirect http://127.0.0.1:3000/ /; 或设为 proxy_redirect default; 自动适配
WebSocket 连接失败：需额外透传升级头：proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
大文件上传/长连接超时：增加超时时间：proxy_connect_timeout 60; proxy_send_timeout 60; proxy_read_timeout 60;
静态资源缓存干扰动态接口：建议按路径区分 location，例如 location /static/ { ... } 直接 serve 文件，location /api/ { proxy_pass ... } 走代理