宝塔面板 Nginx 反代 Node.js 与 Python:proxy_pass、WebSocket 与 502 排查

    发布时间:2026-09-30 05:00 更新时间:2026-09-30 05:00 阅读量:18

    前后端分离的项目越做越多,很多站长习惯把前端静态页丢给宝塔的 Nginx,后端 Node.js 或 Python(Flask、FastAPI、Django 之类)挂在某个高位端口上跑。对外只暴露 80/443,内部通过反向代理转发,这样既省了一个域名和证书,也方便用同一套日志体系排查问题。真正动手时卡人的往往是三件事:proxy_pass 后面到底写 IP 还是 127.0.0.1、端口为什么起不来、以及带 WebSocket 的项目一连就断。这篇按实际部署顺序讲一遍。

    proxy_pass 地址怎么写,以及端口占用的自查

    Nginx 反代的上游地址有两种常见写法:http://127.0.0.1:端口 和 http://公网IP:端口。前者走本地回环,不经过外部网络栈,性能更好也更安全,前提是应用监听在 127.0.0.1 或 0.0.0.0 上。如果应用只监听了 127.0.0.1,而 Nginx 配了公网 IP,就会连不上;反过来应用只监听内网某张网卡,用 127.0.0.1 也连不上。拿不准时先用 ss 或 netstat 看一眼实际监听地址。

    # 查看端口被哪个进程占用,以及监听在哪个地址
    ss -lntp | grep -E '3000|8000|8080'
    
    

    老系统没有 ss 的话

    netstat -lntp | grep 3000

    确认服务是否真的在监听,而不是启动后立刻退出

    curl -I http://127.0.0.1:3000/

    宝塔面板里,站点设置中的「反向代理」会自动生成一段 proxy_pass 配置,位置一般在站点配置文件的 server 块内。需要注意宝塔自动生成的规则里通常带 proxy_set_header Host $host;,而后端框架如果依赖 Host 做域名判断或生成绝对 URL,就要确认这个头传的是不是你想要的域名。Node 的 Express 和 Python 的 Flask 都容易在这里出现跳转地址变成 127.0.0.1 的情况。

    端口冲突是新手最常撞的坑:Node 默认示例爱用 3000,Flask 默认 5000,Django 8000,好几个项目挤在一台机器上很容易撞车。启动失败时先看应用自己的日志,再确认端口没被别的进程占着。宝塔的「网站」列表里看不到这些端口,因为它只管 Nginx 的站点,后端进程要靠 PM2、systemd 或宝塔的 Node 项目管理器来守护,重启服务器后不会自动拉起,这点要提前规划。

    WebSocket 的 upgrade 头与超时配置

    普通 HTTP 请求是「一问一答」,Nginx 转发完就断开。WebSocket 建立连接后要保持长连接双向通信,Nginx 默认的 HTTP/1.0 上游协议会把连接当成短连接处理,表现就是握手返回 101 之后很快断开,前端控制台反复重连。解决办法是在反代位置显式声明协议升级,并把 HTTP 版本提到 1.1。下面这段可以放在站点的 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 "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;
    
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
    

    几个细节值得说明。proxy_set_header Connection "upgrade" 是硬编码的,意思是所有经过这个 location 的请求都带上 upgrade 语义,对纯 HTTP 请求也没坏处;如果想更精细,可以用 map 指令按 $http_upgrade 是否为空来决定值。proxy_read_timeout 默认 60 秒,长连接空闲超过这个时间会被切断,聊天、推送类应用要适当调大,但也不要无脑设成几小时,否则后端异常挂掉时连接迟迟不释放。另外宝塔面板自带的反代模板有时只写了基础的 proxy_pass,WebSocket 需要自己补上这两行,改完记得重载 Nginx 而不是重启。

    如果项目前后端同域,前端连 WebSocket 时用 wss://你的域名/ws 这类相对路径即可,不用再单独开端口和证书。跨域场景下还要确认后端的 CORS 和 cookie 的 SameSite 设置,这部分和反代本身无关,但报错信息经常混在一起,容易误判成代理问题。

    反代后 502 的排查顺序

    502 Bad Gateway 的含义很明确:Nginx 把请求转给上游,但没能从上游拿到合法响应。它和 504(等超时了还没响应)是两回事,先分清再动手。排查从下往上走比较省时间。

    第一步确认后端进程活着。用 ps aux | grep node 或 systemctl status 你的服务名 看进程在不在,再看应用自己的日志有没有抛异常退出。很多 502 其实是应用启动就崩了,Nginx 只是背锅。

    第二步确认端口通不通。在服务器上执行 curl -v http://127.0.0.1:3000/,能返回内容说明应用没问题,问题在 Nginx 配置或防火墙;连不上就是应用或端口的事。这一步能把问题范围砍掉一半。

    第三步看 Nginx 错误日志。宝塔的日志一般在 /www/wwwlogs/ 目录下,对应站点的 error.log 会写明具体原因,比如 connect() failed (111: Connection refused)、upstream timed out、no live upstreams 等。这些原文比任何猜测都准,照着关键词搜就行。

    # 实时盯住站点错误日志,复现问题时观察输出
    tail -f /www/wwwlogs/你的域名.error.log
    
    

    检查 Nginx 配置语法,改完配置先验证再重载

    nginx -t

    平滑重载,不中断现有连接

    nginx -s reload

    第四步考虑 SELinux 或宝塔的防火墙。CentOS 系默认开启 SELinux 时,Nginx 主动外连可能被拦,报错也会体现为连接失败。另外宝塔的「系统防火墙」和云厂商的安全组是两层,只开一层等于没开,但反代走 127.0.0.1 时其实不经过这两层,别在这里绕太久。第五步才是看连接数和文件描述符,高并发下 worker_connections 或系统 ulimit 不够也会表现为间歇性 502,这类问题日志里通常能看到 worker_connections are not enough 之类的提示。

    最后提醒一点:反代配置改动后要用 nginx -t 验证再 reload,直接重启 Nginx 会短暂中断所有站点,对已经在跑业务的服务器不划算。后端进程建议用 systemd 或 PM2 做成开机自启并配置日志轮转,否则跑几个月日志文件把磁盘写满,最终还是会以 502 的形式暴露出来。把这几步固定成一套检查清单,以后换服务器或加新项目都能照着走。

    继续阅读

    📑 📅
    WordPress迁移后小工具和菜单丢失:序列化数据与WP-CLI替换思路 2026-09-30
    Nginx 与 PHP-FPM:Unix socket 还是 TCP,怎么选怎么切 2026-09-30
    网站上线前DNS预检清单:A/CNAME/MX/TXT记录核对与TTL切换节奏 2026-09-29
    宝塔面板多站点共用服务器MySQL连接数被打满的排查思路 2026-09-29
    WordPress附件库臃肿:按月分目录、清理wp_posts与CDN回源调整 2026-09-29
    Nginx 与 PHP-FPM 用 Unix socket 报 502:属主与用户组对齐排查 2026-09-30
    宝塔面板站点开 HTTP/3:Nginx 版本、Brotli 与 CDN 回源链路评估 2026-09-30
    WordPress数据库MyISAM转InnoDB:引擎、行格式与写入观察 2026-09-30
    Nginx 限流不生效排查:zone、层级与 CDN 真实 IP 三个坑 2026-09-30
    宝塔多版本PHP站点选错版本:fastcgi_pass与.user.ini排查 2026-09-30