Ubuntu VPS上Node.js后端API后台运行及开机自启配置求助
Node.js API后台运行与开机自启解决方案
先指出你原有systemd配置的问题:
- 工作目录写的
/a,但你的服务实际在/backend,路径完全错误 - 启动命令用了
npm start,但你实际是通过PM2启动ecosystem.config.json,且--no-daemon会强制PM2前台运行,关闭终端进程必然终止,不适合systemd管理
给你两种可行的解决办法:
办法一:修正systemd服务配置(直接管理PM2进程)
创建或修改/etc/systemd/system/api.service文件,内容如下:
[Unit] Description=Node.js后端API服务 After=network.target [Service] Type=forking User=root Restart=always RestartSec=5 WorkingDirectory=/backend # 先执行`which pm2`拿到PM2的绝对路径,替换下面的/usr/bin/pm2 ExecStart=/usr/bin/pm2 start ecosystem.config.json ExecReload=/usr/bin/pm2 reload ecosystem.config.json ExecStop=/usr/bin/pm2 stop ecosystem.config.json [Install] WantedBy=multi-user.target
关键参数说明:
Type=forking:PM2启动后会后台fork子进程,用这个类型匹配更准确Restart=always:不管进程意外终止还是服务器重启,都会自动拉起服务RestartSec=5:进程终止后间隔5秒再重启,避免无限循环重启
配置完成后执行以下命令生效:
systemctl daemon-reload systemctl start api systemctl enable api
办法二:使用PM2自带的systemd生成工具(更省心)
PM2本身提供一键生成systemd服务的功能,步骤更简单:
- 正常启动服务(不要加
--no-daemon):
cd /backend pm2 start ecosystem.config.json
- 保存当前PM2的进程列表:
pm2 save
- 生成并配置systemd服务:
pm2 startup ubuntu -u root --hp /root
执行后会提示你运行一条systemctl命令,照着输入即可完成开机自启配置。
通过Webmin操作的步骤
- 登录Webmin,进入系统 > 系统服务
- 如果用办法一:
- 点击添加新服务,将上述修正后的配置内容粘贴进去,服务名称设为
api - 保存后点击启动服务,再勾选开机时启动
- 点击添加新服务,将上述修正后的配置内容粘贴进去,服务名称设为
- 如果用办法二:
- 执行完PM2的命令后,回到系统服务列表,找到
pm2-root服务 - 确认服务处于运行状态,勾选开机时启动
- 执行完PM2的命令后,回到系统服务列表,找到
验证生效情况
- 关闭终端后重新SSH登录,执行
pm2 list查看进程是否仍在运行 - 重启VPS后,执行
pm2 list或直接访问API接口,确认服务已自动启动
内容的提问来源于stack exchange,提问作者Deadlef
相关产品推荐
相关产品推荐

