先装宝塔官方Node.js插件（非PM2插件），否则网站类型无Node.js选项、npm报command not found；再用绝对路径配置PM2启动命令、正确设置反向代理及云服务器安全组端口。
宝塔里找不到 Node.js 类型网站？先装对插件
根本原因不是面板坏了，而是没装官方 Node.js 版本管理器 插件。宝塔默认不带 Node 运行环境，“PM2 管理器”插件只是个进程看门狗，不能替代 Node 本身。
常见错误现象：npm command not found、在「网站」模块里压根看不到「Node.js」类型选项。
- 登录宝塔 → 左侧「软件商店」→ 搜索
Node.js→ 找作者是「宝塔」、状态为「已安装」的那个 - 没装就选一个 LTS 版本（比如
v18.19.1）安装，别碰v21.x这类非LTS版，和很多 npm 包有兼容问题 - 安装完点「设置」→「环境变量」，确认类似
/www/server/nvm/versions/node/v18.19.1/bin的路径已加入系统PATH
PM2 启动就退出？命令和路径必须写死
宝塔的「PM2 管理器」只负责执行你填进去的那条命令，它不会自动加载你的 shell 环境，也不会帮你猜路径。
使用场景：你本地 npm start 能跑，但填进宝塔 PM2 里就报错或秒退。
- 启动命令别写
npm start，改用绝对路径：/www/server/nvm/versions/node/v18.19.1/bin/npm start - 项目路径必须是含
package.json的根目录，不是server.js所在子目录；填错会触发Cannot find module - 应用名称（
Name字段）必须填，否则 PM2 无法识别进程，重启、日志都失效；建议用小写字母+短横线，如user-api - 如果用了
ecosystem.config.js，启动命令就得是：/www/server/nvm/versions/node/v18.19.1/bin/pm2 start ecosystem.config.js
域名访问显示 502？反向代理端口没对齐
curl http://127.0.0.1:3000 能通，但浏览器输域名就 502，说明请求压根没到你的 Node 进程——Nginx 拦在中间，却不知道往哪转。
错误日志里常出现：connect() failed (111: Connection refused)，就是 Nginx 去连了一个没监听的端口。
- 进「网站」→ 点开对应站点 → 「反向代理」→ 添加，目标 URL 填
http://127.0.0.1:3000（端口必须和你代码里app.listen(3000)完全一致） - 务必关掉「启用缓存」，Node 动态服务开缓存等于返回脏数据
- 如果代码里写了
app.set('trust proxy', 1)或需要真实 IP，反向代理配置里得手动加两行：proxy_set_header X-Real-IP $remote_addr;和proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
端口被拒绝或无法访问？云服务器安全组没放行
哪怕 Nginx 反向代理配对了，如果云厂商的安全组规则没放开对应端口，外网请求照样进不来。
腾讯云/阿里云控制台里，安全组规则默认只放行 80、443、22，Node 项目监听的 3000、5000 这类端口必须手动加。
- 去云服务商控制台 → 找到你的服务器 → 进入「安全组」→ 编辑入站规则
- 添加一条：协议类型
TCP，端口范围填你 Node 实际监听的端口（如3000），源地址填0.0.0.0/0（或按需限制 IP 段） - 别只改宝塔里的“网站端口”，那个只是 Nginx 监听的前端端口；后端 Node 进程端口由安全组管，两者不互通
最易忽略的是安全组和反向代理端口的双重对齐——Node 监听端口、反向代理目标端口、安全组放行端口，三者必须完全一致，差一位都会 502 或连接超时。
