宝塔部署Node.js环境，PM2运行Express项目

本文深入解析了在宝塔面板中成功部署Express项目的完整链路与关键避坑指南：从必须安装官方「Node.js版本管理器」插件并正确配置PATH环境变量，到严格遵循PM2管理器对package.json中"start"脚本的硬性依赖；从启动命令必须使用Node/NPM绝对路径、Express监听地址需绑定0.0.0.0，到Nginx反向代理配置的细节（如关闭缓存、透传Host与真实IP）——每一步都直击生产环境中高频报错（npm command not found、502 Bad Gateway、进程秒退、脚本未识别）的根本原因，帮你绕过文档盲区，真正实现稳定、可维护的Node.js服务上线。

pm2 start npm --name "xxx" -- start 这条命令只在 package.json 里有合法 "start" 脚本时才有效，否则部署会卡住或报 npm ERR! missing script: start。宝塔的 PM2 管理器不是万能启动器，它只是把你的配置翻译成一条固定格式的 PM2 命令去执行。

必须先装对插件，不是“PM2管理器”那个

宝塔默认不带 Node.js 运行环境，“PM2管理器”插件只负责展示进程状态，它本身不提供 node 或 npm 命令。常见错误现象：npm command not found、网站设置里根本看不到“Node.js”类型选项。

• 登录宝塔 → 左侧「软件商店」→ 搜索 Node.js → 找作者是「宝塔」、状态为「已安装」的那个（名称通常是「Node.js 版本管理器」或「Node.js 项目管理器」）
• 没装就选一个 LTS 版本（如 v18.19.1），别选 v21.x 这类非LTS版，和 Express 生态很多包有兼容问题
• 安装完点「设置」→「环境变量」，确认类似 /www/server/nvm/versions/node/v18.19.1/bin 的路径已加入系统 PATH
• 终端里执行 node -v 和 npm -v 必须能正常输出版本号，否则后续全白搭

Express 项目必须有可执行的 start 脚本

宝塔 PM2 管理器的「一键部署」功能硬编码依赖 package.json 中的 "start" 字段，写成 "dev"、"server" 或直接用 node app.js 启动，它完全识别不了。

• package.json 里至少要有：

  "scripts": { "start": "node ./bin/www" }

  （Express 默认生成的入口就是 ./bin/www）
• 确保 ./bin/www 文件首行是 #!/usr/bin/env node，且有可执行权限：chmod +x ./bin/www
• 不要在 start 脚本里加 nodemon 或 --watch —— PM2 不是开发工具，热重载会干扰守护行为
• 要用环境变量（如 NODE_ENV=production），必须写进脚本里："start": "NODE_ENV=production node ./bin/www"，别指望插件界面填的「环境变量」字段能透传

启动命令不能写 npm start，得用绝对路径

宝塔 PM2 管理器执行命令时不会加载你的 shell 环境（比如 ~/.bashrc），所以填 npm start 很大概率失败——它找不到全局 npm，或用了错误的 Node 版本。

• 启动命令必须写成绝对路径，例如：/www/server/nvm/versions/node/v18.19.1/bin/npm start
• 项目路径必须是含 package.json 的根目录（如 /www/wwwroot/my-express-app），不是 ./bin/www 所在目录；填错会触发 Cannot find module
• 应用名称（Name 字段）必须填，建议小写字母+短横线，如 user-api；不填会导致 PM2 无法识别进程，重启、日志都失效
• 如果用了 ecosystem.config.js，启动命令就得是：/www/server/nvm/versions/node/v18.19.1/bin/pm2 start ecosystem.config.js

Nginx 反向代理配错，502 就必然发生

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

• 进「网站」→ 点开对应站点 → 「反向代理」→ 添加，目标 URL 填 http://127.0.0.1:3000（端口必须和 Express 实际监听的一致）
• 务必关掉「启用缓存」，Express 是动态服务，开了缓存会返回旧响应
• Express 的 app.listen() 必须绑定 0.0.0.0:3000，不能只写 127.0.0.1:3000 或留空（某些框架默认只绑本地）
• 反向代理配置里加两行：proxy_set_header Host $host; 和 proxy_set_header X-Real-IP $remote_addr;，否则 Express 拿不到真实 IP 和 Host

实际部署中最容易被忽略的点是：Express 监听地址、Nginx 代理目标端口、PM2 启动命令所用的 Node 路径，这三者必须严格对齐，差一个字符，502 或进程秒退就跟着来了。

终于介绍完啦！小伙伴们，这篇关于《宝塔部署Node.js环境，PM2运行Express项目》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！