使用宝塔面板部署Node.js应用:从环境安装到反向代理配置全流程
Node.js项目部署和Python类似,也是新手容易卡壳的地方。本地npm run dev跑得好好的,到服务器上就端口冲突、依赖装不上、进程管理乱。宝塔面板对Node.js的支持比Python稍弱,但流程理顺了也不复杂。
先装Node.js版本管理器。宝塔软件商店里搜Node.js版本管理器,安装。装完打开,能看到多个Node版本,选一个LTS版本安装。建议选16.x或18.x或20.x的LTS版本,别选最新的非LTS版,很多包还没适配。
装完后在终端里验证:
node -v
npm -v
如果命令找不到,可能是环境变量没配好。宝塔的Node版本管理器会把node装在/www/server/nodejs/版本号/目录下,需要把路径加到PATH里,或者直接用完整路径调用。
部署项目。把代码传到服务器,可以用宝塔文件管理器上传zip解压,或者git clone拉代码。代码放/www/wwwroot/目录下,比如/www/wwwroot/myapp。
进项目目录,安装依赖:
npm install --production
如果有package.json里的scripts定义了start命令,直接:
npm run start
但这样跑在前台,关了终端进程就停了。需要进程管理工具。
PM2是Node.js进程管理的事实标准。全局安装:
npm install -g pm2
用PM2启动项目:
pm2 start app.js
或者
pm2 start npm --name "myapp" -- run start
PM2常用命令。pm2 list看所有进程。pm2 logs看日志。pm2 restart all重启。pm2 stop all停止。pm2 delete all删除。pm2 startup设开机自启,按提示执行命令。
宝塔里也可以用PM2管理器插件,图形化操作,能启动、停止、看日志、设开机启动。对新手友好,但功能不如命令行全。
Node.js应用默认监听端口,比如3000。和Python项目一样,绑定127.0.0.1:3000,外部不能直接访问,需要Nginx反向代理。
宝塔里建站点,域名填好,根目录指向项目目录。站点设置里配置文件加反代:
location / {
proxy_passhttp://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_cache_bypass $http_upgrade;
}
注意Node.js项目尤其是WebSocket应用,需要设Upgrade和Connection头,不然WebSocket连不上。普通HTTP应用不加这两行也行,但加上没坏处。
如果项目用了环境变量,.env文件放在项目根目录。PM2启动时可以指定env文件:
pm2 start app.js --env production
或者在ecosystem.config.js里定义环境变量。
HTTPS配置。宝塔里站点设置SSL,申请Let's Encrypt证书,强制HTTPS。Nginx反代不需要额外配置,证书在Nginx层处理,Node.js应用还是走HTTP。
多Node.js项目部署。每个项目用不同端口,3000、3001、3002。每个站点配不同的反代规则指向对应端口。PM2里每个项目起一个进程,用name区分。
数据库和Redis。Node.js项目常用MongoDB或MySQL。宝塔软件商店装对应数据库,建库建用户。Redis装完直接连127.0.0.1:6379。注意数据库端口别对公网开放,只监听本机。
日志管理。Node.js应用日志用PM2 logs看,但日志文件会越来越大。用pm2-logrotate插件自动切割:
pm2 install pm2-logrotate
设max_size和retain参数。Nginx访问日志也要切割,宝塔计划任务里配。
常见坑。端口被占用,pm2 list看谁在占。node版本和项目要求不匹配,用nvm或宝塔版本管理器切换。npm install卡住或失败,换国内镜像:
npm config set registryhttps://registry.npmmirror.com
权限问题,项目目录属主设对。SELinux拦端口,关掉或加策略。宝塔防火墙没放行端口,但反代场景不需要对外开Node端口,只开80和443。
静态文件处理。如果Node.js项目同时提供静态文件,可以在Nginx里配location优先处理:
location /static/ {
alias /www/wwwroot/myapp/public/static/;
expires 30d;
}
让Nginx直接处理CSS、JS、图片,不走Node.js,性能更好。
Node.js部署的核心逻辑和Python一样:环境隔离、进程管理、反代接外网。区别是Node.js生态用PM2管进程,Python用systemd或gunicorn。思路通了,换什么框架都一样。

发表评论