Linux 与服务器运维 / 知识点
systemd 服务管理与排障手册
手册条目
阻止服务被手动或依赖启动,并在确认风险后恢复启动能力。
屏蔽与解除屏蔽服务
当某个服务必须完全禁止启动时,使用 systemctl mask;需要恢复启动能力时使用 systemctl unmask。屏蔽会让单元名解析到 /dev/null,因此手工启动、依赖拉起以及 socket、timer 等触发方式都会失败。它比 disable 更强:disable 只取消开机启用,仍允许手工启动。
命令定位
永久屏蔽写入 /etc/systemd/system/,重启后仍然有效;运行时屏蔽写入 /run/systemd/system/,重启后自动消失。解除屏蔽只删除屏蔽链接,不会自动启动服务,也不会修复服务自身的配置或依赖问题。
基本语法与常用参数
以下是语法模板,UNIT 应替换为完整单元名,例如 app.service。
sudo systemctl mask [--now] [--runtime] UNIT
sudo systemctl unmask UNIT--now 在建立屏蔽的同时停止当前已运行的单元;省略它时,已经运行的进程不会被停止。--runtime 只做临时屏蔽;--quiet 可隐藏正常的链接创建或删除提示,但不会隐藏错误。
高频用法
永久屏蔽并立即停止服务:
sudo systemctl mask --now --quiet app.service
systemctl is-enabled app.service || true预期输出:
maskedsystemctl is-enabled 对 masked 状态通常返回非零退出码,因此脚本中使用 || true 保留可读输出。此时再次执行 systemctl start app.service 会失败。
只在本次启动周期内临时屏蔽:
sudo systemctl mask --runtime --quiet app.service
systemctl is-enabled app.service || true预期输出:
masked-runtime该结果表示屏蔽位于 /run;机器重启后会失效。若同名单元同时存在永久屏蔽,输出可能仍为 masked,应先检查两处链接。解除屏蔽并恢复运行:
sudo systemctl unmask --quiet app.service
sudo systemctl start app.service
systemctl is-active app.service预期输出:
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 的精简容器中,这些命令可能不可用。
