Nginx 反代配置速查（含 WebSocket）

1) 最常用的反代模板

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

2) WebSocket 必备（HMR/实时消息）

推荐用 map：

map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      close;
}

然后在 location 里：

location / {
  proxy_pass http://127.0.0.1:3000;
  proxy_http_version 1.1;

  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection $connection_upgrade;

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

3) 常见坑

• 忘了 proxy_http_version 1.1 → WS 握手失败
• location 被其它规则覆盖（例如静态资源 location）
• CDN/网关层拦截 websocket（需要一起排查）

4) 调试方式

• 浏览器 DevTools → Network → WS → 看是否 101 Switching Protocols
• Nginx error log 是否出现 upstream connection 异常