kita / notes
← 回到全部笔记

记录日期 阅读约 2 分钟

手动启动的服务,重启机器就没了

发布于 · 修订

本文目录(4 节)
  1. 手动起的进程
  2. 先确认现状
  3. 补一个 unit
  4. 启用并验证

网易云点歌那个功能,隔一阵子就不好使。不是完全挂掉,是"有时候能用有时候不能用"。

一开始我怀疑是插件那边的问题,后来才想到去看服务器上那个 API 服务本身。

手动起的进程

这个 API 是 NeteaseCloudMusicApiEnhanced,装在 /root/api-enhanced 下。当初的启动方式很朴素:

cd /root/api-enhanced
node app.js

手动跑在前台,没有 systemd 也没有 docker 托管。 这意味着三件事:

  • 服务器重启,它不会自己起来
  • 终端一关,进程可能跟着走
  • 进程真挂了,没有任何机制把它拉起来

"有时候不能用"就是这个原因——它对运行环境的连续性完全没有保障。

先确认现状

动手之前先看清楚它是怎么跑着的:

ps -eo pid,etimes,cmd | grep app.js

看到了 node 进程,说明当时是活的。再看有没有被托管:

ls /etc/systemd/system/*.service

里面没有它。确认这个进程完全没有任何守护机制后,下一步就是补齐 unit。

补一个 unit

解决办法是给它写个 systemd unit,文件放 /etc/systemd/system/ncm-api-enhanced.service:

[Unit]
Description=NeteaseCloudMusicApiEnhanced (ncm-api)
Documentation=file:///root/api-enhanced/README.md
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=10

[Service]
Type=simple
User=root
WorkingDirectory=/root/api-enhanced
ExecStart=/usr/bin/node app.js
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=ncm-api

[Install]
WantedBy=multi-user.target

几个地方是特意写的:

After=network-online.target + Wants= —— 等网络栈就绪后再启动。

Restart=always + RestartSec=5 —— 挂了就拉起来,隔 5 秒。这是"自动恢复"的核心。

StartLimitIntervalSec + StartLimitBurst —— 这两个是配套的限流。如果服务有严重的启动错误,Restart=always 会让它无限重启,日志瞬间被刷爆。加上"60 秒内最多重启 10 次",超过就停手,留出时间给人看日志。

SyslogIdentifier=ncm-api —— 加了它之后 journalctl -u 出来的日志每行都带这个标识,和别的服务混在一起时好认。

启用并验证

systemctl daemon-reload
systemctl enable --now ncm-api-enhanced

enable 是设开机自启,--now 是顺便立刻起来。

验证的一个技巧是看重启次数:

systemctl show ncm-api-enhanced -p ActiveState,SubState,NRestarts
ActiveState=active
SubState=running
NRestarts=0

看 NRestarts 是个很实用的习惯:刚拉起时是 0,过几天再看如果还是 0,说明进程一直稳着;如果这个数字一直在涨,即使状态看着还是 active,也说明服务有周期性崩溃的问题,得回去看 journalctl -u ncm-api-enhanced。

← 返回全部手记