用 systemd 托管 Node.js 服务

用服务单元托管 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 路径沿用课程安装的位置。 软件包与环境变量

linux-notes.service
[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=execsystemd 成功启动 Node.js 程序后,将服务标记为已启动。
User指定运行 Node.js 的账号。
ExecStart指定启动命令和入口文件。
Environment=PORT=3000把端口 3000 作为环境变量传给应用。
Restart=on-failureNode.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 可以恢复运行。如果已经设置开机自启,下次开机时也会启动。


🧪 小练习

  1. 把 linux-notes.service 里的 Environment=PORT=3000 改为 Environment=PORT=3001。
  2. 执行 sudo systemctl daemon-reload,让 systemd 读到修改。再执行 sudo systemctl restart linux-notes.service,让新进程拿到新的端口。请求 http://127.0.0.1:3001/health,确认返回 200。
  3. 说出上面两条命令各做了什么。然后把端口改回 3000,重新加载并重启,确认 http://127.0.0.1:3000/health 再次返回 200。