Nginx 反向代理：从入门到踩坑

反向代理是 Nginx 最常见的用法：把外部请求转给后端应用，对外只暴露 80/443。看似一行 proxy_pass，细节都在 header 透传。

操作步骤

server {
    listen 80;
    server_name api.xirangzhe.com;

    location / {
        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;
    }
}

要点速览

• Host 与 X-Forwarded-Proto 必须透传，否则后端拿到的协议和域名会错，导致生成的链接变 http 或 127.0.0.1。
• 后端若在本机其它端口，proxy_pass 写成 http://127.0.0.1:3000，结尾的斜杠决定是否把 location 前缀也拼进去。
• 改完用 nginx -t 校验，再 reload，不要 restart 以免短暂中断。

反向代理的坑九成在 header：透传不全，后端就不知道自己被代理了。