Nginx 中怎么配置基础的 proxy_pass 实现反向代理转发-Nginx-PHP中文网

Nginx反向代理需正确配置location匹配、proxy_pass路径结尾及关键代理头。/api/配proxy_pass http://127.0.0.1:3000/可去除前缀；必须设Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto头；配置后用nginx -t和curl验证。

nginx 中怎么配置基础的 proxy_pass 实现反向代理转发

在 Nginx 中配置基础的 proxy_pass 实现反向代理，核心是让 Nginx 接收客户端请求后，把请求原样（或稍作改写）转发给后端服务，并把响应返回给客户端。关键不在“加一行”，而在于路径匹配、协议头传递和上下文处理是否正确。

明确 location 匹配规则再写 proxy_pass

proxy_pass 必须写在 location 块中，且匹配方式直接影响转发路径：

如果 location /api/ 后面的 proxy_pass 以 / 结尾（如 proxy_pass http://127.0.0.1:8080/;），Nginx 会自动去掉匹配到的 /api/ 前缀，再拼接到目标地址 —— 这是最常用、最安全的方式
如果 proxy_pass http://127.0.0.1:8080/backend;（不带结尾斜杠），则不会做路径替换，整个原始 URI（含 /api/xxx）会直接追加过去，后端需能处理该路径
避免写成 proxy_pass http://127.0.0.1:8080;（无结尾斜杠且无路径），此时 Nginx 会把原始 URI 完整透传，容易导致 404（尤其后端不期望带前缀时）

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

默认情况下，Nginx 转发时不重写 Host 和真实客户端 IP，后端可能拿到错误的请求来源。务必补充以下头字段：

proxy_set_header Host $host; —— 把原始请求的 Host 传给后端，避免后端因 Host 不匹配拒绝请求
proxy_set_header X-Real-IP $remote_addr; —— 让后端知道真实用户 IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; —— 支持多层代理链路下的 IP 追溯
proxy_set_header X-Forwarded-Proto $scheme; —— 告知后端原始请求是 http 还是 https，对跳转或生成绝对链接很重要

简单可用的完整示例

假设本地启动了一个 Node.js 服务监听 http://127.0.0.1:3000，想通过 https://example.com/api/ 访问它：

Umbrel Proxy Manager

高效管理与交互 Umbrel 代理服务，支持 Docker 容器。自动发现运行服务，将内部 Docker IP 映射为可访问的外部地址。

下载

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;
}

注意：/api/ 和 proxy_pass 末尾都带 /，这样访问 /api/users 时，实际转发的是 http://127.0.0.1:3000/users。