用 systemd 管理 Node 服务的配置笔记:开机自启、崩溃重启与日志落盘

举报
yd_298384739 发表于 2026/11/10 23:59:11 2026/11/10
【摘要】 在小规格云服务器上跑 Node 服务,最怕三件事:重启后服务没起来、进程挂了没人知道、日志悄悄打满磁盘。之前我用 nohup 启动,SSH 一断、进程一挂就得手动处理。换成 systemd 管理后,这三件事都有了固定解法。下面是在华为云 Flexus(Ubuntu 22.04,Node.js 20)上的实测记录。 一、写一个最小可用的 unit 文件在 /etc/systemd/system...

在小规格云服务器上跑 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 不是万能,但对单机小服务够用。开机自启、崩溃重启、日志轮转三件套配齐,半夜重启、进程挂掉都不用再手动救火。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。