systemctl — systemd 系统与服务管理器控制详解

systemctl 是 Linux 下 systemd 系统与服务管理器（system and service manager）的控制前端。它并非直接操作进程，而是作为客户端通过 D-Bus 总线与 PID 1 的 systemd 守护进程通信，用于查看和改变系统、服务的状态。几乎每一个"我要管理这个 Linux 系统的进程与服务"的操作，都通过 systemctl 完成。

1. 概述

1.1 systemctl 是什么

systemctl 的功能分为两大块：

• 探查（introspect）：查看 systemd 当前管理的所有单元（unit）、任务（job）、系统运行状态。
• 控制（control）：启动/停止/重启服务、设置开机自启、进入救援模式、关机重启等。

命令语法：systemctl [OPTIONS...] COMMAND [UNIT...]，默认与系统管理器通信；加 --user 则与当前用户的用户管理器通信。

1.2 单元文件的查找路径

systemd 按优先级从高到低在以下目录查找单元文件，同名文件优先级高的生效：

三者是"栈式叠加"：高优先级文件未定义的项会回落到低优先级文件，而非整体替换。每处目录都可存在 foo.service.d/ 子目录存放 drop-in 片段。

1.3 enable 与 start 是正交的

这是新手最容易混淆的点：

• enable（自启）—— 只在 /etc/systemd/system/ 下按 [Install] 段创建符号链接，让单元在开机时被拉起。不启动当前。
• start（运行）—— 立即激活单元，spawn 进程。不改变开机自启设置。

用 systemctl enable --now foo 可一步完成两件事；同理 disable --now = 取消自启 + 停止。

systemctl enable nginx      # 只设置开机自启
systemctl start nginx       # 只立即启动
systemctl enable --now nginx   # 自启 + 立即启动

1.4 定位：systemd 只是 Linux 的主流 init 系统，并非全部

systemctl 只对 systemd 有效。而 Linux 世界并非全员 systemd，Apple 系则是另一套体系。先分清"面前的机器用哪个 init 系统"再选命令，否则会得到 command not found。

Apple 系收敛，Linux 系多元：launchd 是苹果的唯一标准；systemd 只是 Linux 的主流而非全员。选命令前先确认：systemctl（systemd）、rc-service（OpenRC）、service（SysVinit）、launchctl / brew services（macOS）。

systemd 与 launchd 概念对照

2. 行为图（系统"做什么"）

2.1 用例图 — systemctl 交互全景

管理员（root）是主要使用角色；普通用户可用 --user 管理自己的用户服务；后台的 systemd 则是这些操作最终作用的被控制对象。

图 1：systemctl 用例图（行为全景）

用例演示

systemctl list-units --type=service --state=running   # 列出所有运行中的服务
systemctl status nginx                                # 查看 nginx 详细状态+最近日志
systemctl daemon-reload                               # 单元文件改动后重载配置
systemctl set-property nginx.service MemoryMax=2G     # 运行时调整资源上限

2.2 活动图 — 服务生命周期主流程

以"启动一个服务 → 观察 → 停止"为主线，展示 systemctl 与 systemd 的职责划分。

图 2：服务生命周期主流程活动图（带泳道）

用例演示

systemctl start redis.service     # 启动
systemctl status redis.service    # 观察 active (running)
systemctl stop redis.service      # 优雅停止（SIGTERM）
# 若进程未在 TimeoutStopSec 内退出，systemd 会升级为 SIGKILL

2.3 状态机图 — unit 生命周期

单元在 systemd 眼中的生命周期，对应 systemctl status 里 Active: 一行的取值。

图 3：unit 生命周期状态机图

ACTIVE 状态速查

2.4 时序图 — systemctl start 内部调用

一次 systemctl start nginx.service，在 systemctl、D-Bus、systemd 与服务进程之间如何流转。

图 4：systemctl start 内部时序图

用例演示

# 观察事务中实际入队了哪些 job
systemctl start --show-transaction nginx.service

# 观察管理器日志（另一终端）
journalctl -u nginx.service -f

2.5 活动图 — enable / start / mask 对比

把三者放一起对比，理解它们对"开机自启"和"立即运行"两个维度的影响。

图 5：enable / start / mask / disable 对比活动图

用例演示

systemctl enable  nginx        # 创建自启符号链接
systemctl disable nginx        # 移除自启符号链接（不影响当前运行）
systemctl mask    nginx        # 链接到 /dev/null，任何 start/enable 都失败
systemctl unmask  nginx        # 解除屏蔽
systemctl is-enabled nginx     # 查看自启状态（enabled/disabled/masked/static...）

3. 结构图（系统"由什么组成"）

3.1 部署图 — systemd 生态

systemctl 只是 systemd 生态众多管理工具中的一个，它们围绕 D-Bus 总线协作。

图 6：systemd 生态部署图

用例演示

systemctl list-machines             # 列出本机与本地容器
systemctl --host=user@host status   # SSH 远程管理
systemctl -M container status       # 管理容器内服务
systemctl --user status             # 管理当前用户服务

3.2 组件图 — systemctl 内部

把 systemctl 进程拆开看：它如何解析你的命令、如何与 systemd 通信、如何读写单元文件。

图 7：systemctl 内部组件图

用例演示

systemctl status /home        # 路径自动转换为 home.mount 单元
systemctl status /dev/sda     # 设备路径 → dev-sda.device
systemctl stop "sshd@*.service"   # 通配符匹配所有 sshd@.service 实例
systemctl edit nginx.service  # 打开编辑器编辑 drop-in，退出后自动 daemon-reload

3.3 包图 — 命令分组

systemctl 的全部命令可归为七大类，便于记忆与检索。

图 8：systemctl 命令分组包图

归类速记

3.4 类图 — 对象模型

理解 systemctl / systemd 背后的核心抽象：Manager、Unit、Job、UnitFile 及其关系。

图 9：systemctl 对象模型类图

用例演示

systemctl show nginx.service -p MainPID -p ActiveState   # 读属性（脚本友好）
systemctl show nginx.service --value -p ExecStart        # 只输出值
systemctl list-dependencies nginx.service                # 递归列出依赖
systemctl list-dependencies --reverse nginx.service      # 谁依赖它

4. 配置文件语法规范

单元文件（unit file）是 systemd 的"声明式配置"，写对了才能跑稳。规范分三层：文件结构、值格式、每段的指令语义。本节是实战的基础，所有 service / timer / socket 的排查都从这里开始。

4.1 单元文件结构

单元文件由若干段（section）组成，段内是键=值对。段名写在方括号里且大小写敏感，# 或 ; 开头是注释，空行忽略，键=值 可用反斜杠续行。

图 10：单元文件结构图（三个段 + 典型指令）

结构演示

# /etc/systemd/system/myapp.service
[Unit]
Description=My Application Server        # [Unit] 通用段：描述、依赖、排序
After=network-online.target
Wants=network-online.target

[Service]                                 # [Service] 服务特有段：执行、类型、重启
Type=simple
ExecStart=/usr/local/bin/myapp --port 8080
Restart=on-failure
User=www-data

[Install]                                 # [Install] 安装段：enable 时如何被拉起
WantedBy=multi-user.target

4.2 值格式与占位符

先掌握值格式，再看指令才不会读错配置。

说明符（specifier）— 模板单元的核心

在单元文件值里，%X 会被替换为运行期信息，常用于模板单元 foo@.service（用 systemctl start foo@bar 实例化，实例名即 bar）：

# getty@tty1.service 的 [Service]
ExecStart=-/sbin/agetty -o '-p -- \\u' --noclear %I $TERM   # %I 实例名 tty1

4.3 [Unit] 段 — 描述、依赖与排序

这是最容易写错的部分。依赖决定"要不要拉起来"，排序决定"谁先谁后"，两者是正交的。

图 11：依赖（Requires/Wants）与排序（After/Before）对比图

4.4 [Service] 段 — 命令与类型

4.4.1 执行命令

ExecStart 前缀修饰符（放在命令最前面）：

变量展开：$FOO 只展开一次（传给子进程仍保留字面量）；${FOO} 在传给子进程前先替换为值。用 ${FOO} 更符合预期。

4.4.2 Type — systemd 如何判定"启动完成"

# forking 经典写法（老式守护进程）
[Service]
Type=forking
PIDFile=/run/daemon.pid
ExecStart=/usr/sbin/daemon -d
ExecReload=/bin/kill -HUP $MAINPID

# notify 推荐写法（现代服务，自身支持 sd_notify）
[Service]
Type=notify
NotifyAccess=all
ExecStart=/usr/local/bin/server

4.5 [Service] 段 — 重启策略、身份与沙箱

4.5.1 退出与重启

4.5.2 身份与工作环境

4.5.3 资源限制与沙箱

[Service]
User=www-data
EnvironmentFile=-/etc/myapp.env          # 缺失也不报错
LimitNOFILE=65535
PrivateTmp=yes
ProtectSystem=full
ProtectHome=yes
NoNewPrivileges=yes
Restart=on-failure
RestartSec=3
TimeoutStopSec=30

4.6 [Install] 段 — 开机自启

只在 systemctl enable 时读取，决定"开机时被谁拉起"，与运行无关。

[Install]
WantedBy=multi-user.target     # 开机进入多用户模式时自动启动
Also=myapp.timer               # enable myapp.service 时顺带 enable 定时器

4.7 其他单元类型段

[Timer] — 定时器（cron 替代）

[Socket] — 套接字（按需启动）

[Path]、[Mount]、[Slice]

4.8 drop-in 覆盖与优先级

不要直接改厂商自带的 /usr/lib/systemd/system/*.service。用 drop-in 追加覆盖：

# 方法一：systemctl edit（自动创建并打开编辑器，保存后自动 daemon-reload）
systemctl edit myapp.service

# 方法二：手工创建
sudo mkdir -p /etc/systemd/system/myapp.service.d
sudo tee /etc/systemd/system/myapp.service.d/override.conf <<'EOF'
[Service]
Environment=APP_ENV=production
RestartSec=5
EOF
sudo systemctl daemon-reload

叠加规则（栈式）：同一键的取值按目录优先级取最高者，目录优先级 /etc > /run > /usr/lib；同一目录内按文件名排序，后者覆盖前者。要清空某个在低优先级文件里设置的键，赋空值即可：

# override.conf —— 清掉上游设置的 User
[Service]
User=

5. 实战速查手册

5.1 查询与状态

5.2 服务生命周期

5.3 开机自启管理

5.4 系统电源管理

5.5 环境与属性

5.6 定时任务与套接字

systemd 的 cron 替代是 timer 单元；按需启动的守护进程用 socket 单元。

创建一个定时任务

# /etc/systemd/system/backup.service
[Unit]
Description=Daily backup job

[Service]
Type=oneshot
ExecStart=/usr/local/bin/backup.sh

# /etc/systemd/system/backup.timer
[Unit]
Description=Run backup daily

[Timer]
OnCalendar=*-*-* 03:00:00   # 每天凌晨 3 点
Persistent=true             # 错过（关机期间）后开机补跑

[Install]
WantedBy=timers.target

systemctl daemon-reload
systemctl enable --now backup.timer
systemctl list-timers backup.timer

5.7 日志查看

systemctl 本身不读日志，配合 journalctl 使用：

journalctl -u nginx.service          # 该单元全部日志
journalctl -u nginx.service -f       # 实时跟踪
journalctl -u nginx.service --since "1 hour ago"
journalctl -b -p err                 # 本次开机以来的错误级日志
journalctl --since today             # 今天所有日志
journalctl -f                        # 实时看全部日志

5.8 新建服务实战

例：把 Go/Python 写的 Web 后端托管为系统服务

sudo tee /etc/systemd/system/myapp.service <<'EOF'
[Unit]
Description=My Application Server
After=network-online.target
Wants=network-online.target

[Service]
Type=notify                      # 或 simple
User=www-data
WorkingDirectory=/srv/myapp
ExecStart=/usr/local/bin/myapp-server --config /etc/myapp.toml
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure               # 崩溃自动拉起
RestartSec=3
LimitNOFILE=65535
EnvironmentFile=-/etc/myapp.env

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now myapp.service
systemctl status myapp.service

改配置的标准流程

systemctl edit myapp.service     # 追加 drop-in（不污染原文件）
# 或直接改 /etc/systemd/system/myapp.service
systemctl daemon-reload          # 关键！改完必须重载
systemctl restart myapp.service

5.9 故障排查套路

# 1. 服务起不来 → 看状态与日志
systemctl status myapp.service
journalctl -u myapp.service -e   # -e 跳到末尾

# 2. 查看系统是否 degraded（有单元失败）
systemctl is-system-running
systemctl --state=failed         # 列出所有失败单元
systemctl list-unit-files --state=enabled

# 3. 查看启动耗时，找最慢的服务
systemd-analyze blame
systemd-analyze critical-chain

# 4. 单元文件语法错误 / 依赖环
systemd-analyze verify /etc/systemd/system/myapp.service
systemctl list-jobs --after --before   # 看 job 互相等待

# 5. 改完单元文件没生效？
systemctl daemon-reload           # 十有八九忘了这步
systemctl status myapp.service -n 50   # 看最近 50 行日志

4.10 退出码（LSB）