Shirone

systemctl 日常操作速查#

1
systemctl status nginx       # 状态 + 最近几行日志
2
sudo systemctl start nginx   # 启动
3
sudo systemctl stop nginx    # 停止
4
sudo systemctl restart nginx # 重启
5
sudo systemctl reload nginx  # 重载配置（进程不中断，需服务支持）
6
sudo systemctl enable nginx  # 开机自启（不改当前状态）
7
sudo systemctl enable --now nginx  # 自启 + 立即启动
8
sudo systemctl disable --now nginx # 取消自启并停止

status 输出里最值钱的两行：Active: active (running) since ... 和 Main PID。如果看到 failed，先别急着 restart——失败原因往往就在 status 显示的最近日志里。

几个容易混淆的点：

• enable 只管开机自启，不影响当前运行状态；--now 把两件事一起做。
• reload 依赖服务自己支持（ExecReload），不支持时会报错，这时只能用 restart。
• systemctl is-active nginx、is-enabled、is-failed 返回简单状态，适合写脚本判断。

看懂 unit 文件#

unit 文件通常在 /etc/systemd/system/（自定义）和 /usr/lib/systemd/system/（软件包安装）下。systemctl cat nginx 能直接查看。

一个最小可用的自定义服务，把 /opt/myapp/run.sh 变成服务：

1
[Unit]
2
Description=My App
3
After=network-online.target
4
Wants=network-online.target
5

6
[Service]
7
Type=simple
8
User=myapp
9
WorkingDirectory=/opt/myapp
10
ExecStart=/opt/myapp/run.sh
11
Restart=on-failure
12
RestartSec=5
13

14
[Install]
15
WantedBy=multi-user.target

三个段落的分工：

• [Unit]：元信息和启动顺序。After=network-online.target 保证网络就绪后再启动——依赖网络的服务只写 network.target 是不够的。
• [Service]：怎么跑。Type=simple 表示 ExecStart 的进程就是主进程；Restart=on-failure 异常退出时自动拉起；User= 让服务以非 root 身份运行，是安全基线。
• [Install]：何时被启用。WantedBy=multi-user.target 表示 enable 后随正常多用户模式启动。

改完 unit 文件必须执行 sudo systemctl daemon-reload 让 systemd 重新读取，然后 sudo systemctl enable --now myapp。

journalctl：结构化日志的正确用法#

systemd 把服务标准输出、错误输出和内核日志统一收进 journal。基本用法：

1
journalctl -u myapp              # 某个服务的全部日志
2
journalctl -u myapp -n 200       # 最近 200 行
3
journalctl -u myapp -f           # 实时跟踪（类似 tail -f）
4
journalctl -u myapp --since "1 hour ago"
5
journalctl -u myapp --since "2026-09-12 20:00" --until "2026-09-12 21:00"
6
journalctl -p err                # 只看 err 及以上优先级（所有服务）
7
journalctl -k                    # 内核日志（等价 dmesg）
8
journalctl -b                    # 本次开机以来的日志
9
journalctl --disk-usage          # 日志占了多少磁盘

两个实用技巧：

• -o json-pretty 输出完整结构化字段，能看到 _PID、_EXE 等元数据，写日志收集脚本时用得上。
• -x 给部分日志附加解释文字（如 OOM、core dump），排障时值得一看。

排查套路：服务起不来怎么办#

1. systemctl status myapp：看退出码和最后几行输出。
2. journalctl -u myapp -n 100 --no-pager：看完整错误。
3. 常见根因对号入座：
   • status=203/EXEC：ExecStart 路径错误或文件不可执行；
   • status=217/USER：User= 指定的用户不存在；
   • code=exited, status=1：程序自己报错，去读程序日志；
   • 权限问题：检查 WorkingDirectory、日志目录对 User= 是否可写。
4. 修复后 daemon-reload（改了 unit 才需要）→ reset-failed → start。

journal 默认持久化程度因发行版而异：/var/log/journal/ 存在才持久，否则重启即丢。生产机器建议确认 Storage=persistent（/etc/systemd/journald.conf），并用 SystemMaxUse= 限制体积。

延伸阅读#

• systemd 官方文档
• man 5 systemd.service、man 1 journalctl、man 5 journald.conf
• freedesktop: systemd Service 单元说明