用 systemd 管理 Node 服务的配置笔记:开机自启、崩溃重启与日志落盘
在小规格云服务器上跑 Node 服务,最怕三件事:重启后服务没起来、进程挂了没人知道、日志悄悄打满磁盘。之前我用 nohup 启动,SSH 一断、进程一挂就得手动处理。换成 systemd 管理后,这三件事都有了固定解法。下面是在华为云 Flexus(Ubuntu 22.04,Node.js 20)上的实测记录。
一、写一个最小可用的 unit 文件
在 /etc/systemd/system/ 下新建 app.service:
[Unit]
Description=Node.js Web Service
After=network.target
[Service]
Type=simple
User=node
WorkingDirectory=/opt/app
ExecStart=/usr/bin/node /opt/app/server.js
Restart=always
RestartSec=5
Environment=NODE_ENV=production
Environment=PORT=3000
[Install]
WantedBy=multi-user.target
要点:ExecStart 必须写绝对路径,node 也要写全路径,用 which node 确认;Type=simple 时 Node 进程就是主进程,systemd 能直接管它的生死;User 不要用 root,单独建一个 node 用户,目录权限一并收好。
二、启用与验证
sudo systemctl daemon-reload
sudo systemctl enable --now app.service
sudo systemctl status app.service --no-pager
curl http://127.0.0.1:3000/health
enable --now 一步完成开机自启加立即启动。status 看到 Active: active (running) 才是正常;curl 本地健康检查返回 200,再去验证公网端口。改动 unit 文件后必须先 daemon-reload 再 restart,否则改动不生效。
三、崩溃自动重启怎么配
Restart=always 加 RestartSec=5:任何原因退出,5 秒后拉起。实测:sudo kill <主进程 PID> 后等几秒,ps aux | grep node 能看到新 PID,curl 也恢复 200。别把 RestartSec 设成 0,配置错误导致秒退时,死循环重启会把日志刷爆;再加 StartLimitIntervalSec=60 和 StartLimitBurst=5,一分钟内失败超过 5 次就停下来,等人工处理。
四、日志落盘与轮转
默认日志进 journald,查看用:
journalctl -u app.service -f
journalctl -u app.service --since today --no-pager | tail -n 100
要落到文件,改两行:StandardOutput=append:/var/log/app/app.log,StandardError 同路径,再给 /etc/logrotate.d/app 写轮转规则,每天轮转、保留 7 天、压缩旧文件。小规格盘最怕日志失控,轮转和磁盘告警要一起做,只记日志不轮转等于埋雷。
五、升级与回滚
改代码后只 restart 服务;改 unit 后先 daemon-reload 再 restart。回滚办法很简单:发布时保留上一版目录,ExecStart 指向上版文件,restart 即回滚。配合 systemctl stop app.service 先停服务再换文件,避免正在写日志时被覆盖。
六、两个踩过的坑
第一,环境变量:.env 不会被自动读取,要用 EnvironmentFile=/opt/app/.env 显式指定,文件权限设 600,systemctl cat app.service 可以核对最终生效的配置。第二,端口占用:restart 失败先看 journalctl -u app.service,多数是旧进程没退出,ss -tlnp | grep 3000 定位后处理,不要反复 restart。
总结:systemd 不是万能,但对单机小服务够用。开机自启、崩溃重启、日志轮转三件套配齐,半夜重启、进程挂掉都不用再手动救火。
- 点赞
- 收藏
- 关注作者
评论(0)