Linux 与服务器运维 / 知识点

systemd 服务管理与排障手册

手册条目

阻止服务被手动或依赖启动,并在确认风险后恢复启动能力。

屏蔽与解除屏蔽服务

当某个服务必须完全禁止启动时,使用 systemctl mask;需要恢复启动能力时使用 systemctl unmask。屏蔽会让单元名解析到 /dev/null,因此手工启动、依赖拉起以及 socket、timer 等触发方式都会失败。它比 disable 更强:disable 只取消开机启用,仍允许手工启动。

命令定位

永久屏蔽写入 /etc/systemd/system/,重启后仍然有效;运行时屏蔽写入 /run/systemd/system/,重启后自动消失。解除屏蔽只删除屏蔽链接,不会自动启动服务,也不会修复服务自身的配置或依赖问题。

基本语法与常用参数

以下是语法模板,UNIT 应替换为完整单元名,例如 app.service。

bash
sudo systemctl mask [--now] [--runtime] UNIT
sudo systemctl unmask UNIT

--now 在建立屏蔽的同时停止当前已运行的单元;省略它时,已经运行的进程不会被停止。--runtime 只做临时屏蔽;--quiet 可隐藏正常的链接创建或删除提示,但不会隐藏错误。

高频用法

永久屏蔽并立即停止服务:

bash
sudo systemctl mask --now --quiet app.service
systemctl is-enabled app.service || true

预期输出:

text
masked

systemctl is-enabled 对 masked 状态通常返回非零退出码,因此脚本中使用 || true 保留可读输出。此时再次执行 systemctl start app.service 会失败。

只在本次启动周期内临时屏蔽:

bash
sudo systemctl mask --runtime --quiet app.service
systemctl is-enabled app.service || true

预期输出:

text
masked-runtime

该结果表示屏蔽位于 /run;机器重启后会失效。若同名单元同时存在永久屏蔽,输出可能仍为 masked,应先检查两处链接。解除屏蔽并恢复运行:

bash
sudo systemctl unmask --quiet app.service
sudo systemctl start app.service
systemctl is-active app.service

预期输出:

text
active

该输出以单元配置有效、依赖正常且启动命令成功为前提。仅执行 unmask 不会自动启动服务。

风险与边界

对数据库、网络、登录、挂载或关键 target 进行屏蔽,可能导致业务中断、远程失联或下次启动无法进入目标状态。只想取消开机启动时优先使用 systemctl disable;只做维护窗口隔离时优先使用 --runtime,并先确认依赖方能接受启动失败。

屏蔽已运行服务但未使用 --now 时,旧进程仍继续工作,容易造成“看似已封禁、实际仍提供服务”的误判。模板单元也要区分 worker@.service 与具体实例 worker@1.service;屏蔽模板可能影响所有实例,操作前先列出实际单元。

排障清单

  • unmask 后仍显示 masked:分别检查 /etc/systemd/system/app.service 与 /run/systemd/system/app.service,确认是否同时存在永久和运行时屏蔽。
  • 报错 File exists:目标路径可能已有本地单元文件或非预期链接。先用 systemctl cat app.service 和 ls -l 确认来源,不要直接删除或强制覆盖。
  • 解除屏蔽后仍启动失败:查看 systemctl status app.service --no-pager -l,再用 journalctl -u app.service -b --no-pager 定位依赖、权限、条件判断或执行命令错误。
  • 依赖方持续报错:用 systemctl list-dependencies --reverse app.service 查找反向依赖,确认屏蔽是否破坏了上游启动链。

兼容性

适用于以 systemd 为服务管理器的系统。管理用户级单元时使用 systemctl --user mask 和 systemctl --user unmask,通常不需要 sudo。未以 systemd 作为 PID 1 的精简容器中,这些命令可能不可用。

目录与阅读设置

记录一个想法

systemd 服务管理与排障手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通