用 systemd 托管 Node.js 服务
🎯 引言
上一节用 node 手动启动了一个 HTTP 服务。机器重启后,或者进程意外退出后,谁来重新启动它?systemd 是 Ubuntu 用来启动和管理服务的程序。把 Node.js 的启动命令和重启规则交给它,就能让服务自动启动和恢复。
本节直接托管上一节的 server.mjs,用 systemctl 启动和管理服务,再亲手验证故障恢复和开机自启。
🧱 把 Node.js 启动命令写进服务单元
systemd 把它管理的每个服务称为服务单元。一个 .service 文件就能描述这个服务要执行哪条命令、以谁的身份运行,以及进程退出后怎么处理。systemctl 是向 systemd 发指令和查询状态的命令。
直接沿用上一节保存的程序和当前账号。先取得账号名和入口文件的绝对路径,待会儿填进配置。
whoami
realpath -e "$HOME/linux-lab/app/server.mjs"
在课程学习机上可以用 root 测试。如果 whoami 输出 root,下面就写 User=root,并可省略命令里的 sudo。
用 sudo vim /etc/systemd/system/linux-notes.service 创建配置。把 User 和 ExecStart 中的入口文件路径换成刚才查到的值。Node.js 路径沿用课程安装的位置。 软件包与环境变量
[Unit]
Description=Node.js HTTP Service
[Service]
Type=exec
User=learner
ExecStart=/opt/linux-course/runtime/bin/node "/home/learner/linux-lab/app/server.mjs"
Environment=PORT=3000
Restart=on-failure
RestartSec=3s
[Install]
WantedBy=multi-user.target
| 配置 | 在本例中的作用 |
|---|---|
Description | 在服务状态里显示一行说明。 |
Type=exec | systemd 成功启动 Node.js 程序后,将服务标记为已启动。 |
User | 指定运行 Node.js 的账号。 |
ExecStart | 指定启动命令和入口文件。 |
Environment=PORT=3000 | 把端口 3000 作为环境变量传给应用。 |
Restart=on-failure | Node.js 异常退出时尝试重启。 |
RestartSec=3s | 自动重启前等待 3 秒。 |
WantedBy=multi-user.target | 执行 enable 时,把服务加入 Ubuntu 常规开机时要启动的一组服务。 |
完整配置项见官方手册。 systemd.service · systemd.exec
▶️ 启动服务并检查接口
如果上一节手动启动的进程还在运行,先按上一节的方法停止它,腾出 3000 端口。然后用 daemon-reload 让 systemd 读取新建的单元文件,再用 start 启动服务。文件名 linux-notes.service 就是命令里指定的单元名。 进程管理
sudo systemctl daemon-reload
sudo systemctl start linux-notes.service
systemctl status linux-notes.service --no-pager
看到 active (running) 表示 Node.js 进程正在运行。再请求健康检查接口,看到 HTTP 200 和 {"status":"ok"} 就说明服务已经能响应。
curl -i http://127.0.0.1:3000/health
如果启动失败,或稍等片刻后接口仍无法访问,用 journalctl 看这个单元最近的日志。
sudo journalctl -u linux-notes.service -b -n 20 --no-pager
🧪 验证进程异常退出后能恢复
先记下 MainPID,也就是 systemd 当前管理的 Node.js 进程编号。恢复后要用它确认 systemd 启动了新进程。
systemctl show -p MainPID --value linux-notes.service
如果输出 0,先检查服务状态。确认服务正在运行后,在课程学习机上用 SIGKILL 强制结束主进程,模拟突然退出。接口会短暂中断。
sudo systemctl kill --kill-whom=main --signal=SIGKILL linux-notes.service
等几秒,再查 PID、日志和接口。
systemctl show -p MainPID --value linux-notes.service
sudo journalctl -u linux-notes.service -b -n 20 --no-pager
curl -i http://127.0.0.1:3000/health
日志中的 status=9/KILL 记录了旧进程被结束,Scheduled restart job 记录了 systemd 安排重启。PID 变了,接口又返回 200,就说明新进程接手了。
🔁 设置并验证开机自启
start 启动当前这次服务。enable 设置它在以后开机时启动。先启用,再确认系统记下了这个设置。
sudo systemctl enable linux-notes.service
systemctl is-enabled linux-notes.service
看到 enabled 后,可以在课程专用学习机上执行 sudo reboot 验证。机器重新上线后登录 Ubuntu,直接查看状态和接口。
systemctl status linux-notes.service --no-pager
curl -i http://127.0.0.1:3000/health
看到 active (running) 和 HTTP 200,就验证了实际开机时服务能自动启动。
❓ 知识问答
我用 systemctl stop 停掉服务,也会触发故障重启吗?
主动停服会让服务保持停止。执行 sudo systemctl start linux-notes.service 可以恢复运行。如果已经设置开机自启,下次开机时也会启动。
🧪 小练习
- 把
linux-notes.service里的Environment=PORT=3000改为Environment=PORT=3001。 - 执行
sudo systemctl daemon-reload,让 systemd 读到修改。再执行sudo systemctl restart linux-notes.service,让新进程拿到新的端口。请求http://127.0.0.1:3001/health,确认返回200。 - 说出上面两条命令各做了什么。然后把端口改回
3000,重新加载并重启,确认http://127.0.0.1:3000/health再次返回200。
