如何通过宝塔面板部署Node.js应用_配置进程守护与端口映射-php教程-PHP中文网

先装宝塔官方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 管理器」只负责执行你填进去的那条命令，它不会自动加载你的 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

curl http://127.0.0.1:3000 能通，但浏览器输域名就 502，说明请求压根没到你的 Node 进程——Nginx 拦在中间，却不知道往哪转。

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

错误日志里常出现：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;