Systemd service配置文件解析

最新推荐文章于 2025-04-06 14:51:40 发布

permike

最新推荐文章于 2025-04-06 14:51:40 发布

阅读量2.7k

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/permike/article/details/108846912

systemd 的配置文件大部分放置于 /usr/lib/systemd/system/ 目录内。但是 Red Hat 官方文件指出，该目录的文件主要是原本软件所提供的设置，建议不要修改！而要修改的位置应该放置于 /etc/systemd/system/ 目录内。

配置文件示例：


[root@study ~]# cat /usr/lib/systemd/system/sshd.service
[Unit]           # 这个项目与此 unit 的解释、执行服务相依性有关
Description=OpenSSH server daemon
After=network.target sshd-keygen.service
Wants=sshd-keygen.service
 
[Service]        # 这个项目与实际执行的指令参数有关
EnvironmentFile=/etc/sysconfig/sshd
ExecStart=/usr/sbin/sshd -D $OPTIONS
ExecReload=/bin/kill -HUP $MAINPID
KillMode=process
Restart=on-failure
RestartSec=42s
 
[Install]        # 这个项目说明此 unit 要挂载哪个 target 下面
WantedBy=multi-user.target

分析上面的配置文件，我们大概能够将整个设置分为三个部份，就是：

[Unit]： unit 本身的说明，以及与其他相依 daemon 的设置，包括在什么服务之后才启动此 unit 之类的设置值；
[Service], [Socket], [Timer], [Mount], [Path]…：不同的 unit type 就得要使用相对应的设置项目。我们拿的是 sshd.service 来当范本，所以这边就使用 [Service] 来设置。这个项目内主要在规范服务启动的脚本、环境配置文件文件名、重新启动的方式等等。
[Install]：这个项目就是将此 unit 安装到哪个 target 里面去的意思！

至于配置文件内有些设置规则还是得要说明一下：

设置项目通常是可以重复的，例如我可以重复设置两个 After 在配置文件中，不过，后面的设置会取代前面的喔！因此，如果你想要将设置值归零，可以使用类似“ After= ”的设置，亦即该项目的等号后面什么都没有，就将该设置归零了（reset）。
如果设置参数需要有“是/否”的项目（布林值, boolean），你可以使用 1, yes, true, on 代表启动，用 0, no, false, off 代表关闭！随你喜好选择啰！
空白行、开头为 # 或 ; 的那一行，都代表注解！

每个部份里面还有很多的设置细项，我们使用一个简单的表格来说明每个项目好了！

[Unit] 部份
设置参数
Description
Documentation
After
Before
Requires
Wants
Conflicts

接下来了解一下在 [Service] 当中有哪些项目可以使用！

[Service] 部份
设置参数
Type
EnvironmentFile
ExecStart
ExecStop
ExecReload
Restart
RemainAfterExit
TimeoutSec
KillMode
RestartSec

最后，再来看看那么 Install 内还有哪些项目可用？

[Install] 部份
设置参数
WantedBy
Also
Alias

[Service] 区块：启动行为
- 启动命令
  ExecStart字段：定义启动进程时执行的命令
  ExecReload字段：重启服务时执行的命令
  ExecStop字段：停止服务时执行的命令
  ExecStartPre字段：启动服务之前执行的命令
  ExecStartPost字段：启动服务之后执行的命令
  ExecStopPost字段：停止服务之后执行的命令
  
  注：所有的启动设置之前，都可以加上一个连词号（-），表示"抑制错误"，即发生错误的时候，不影响其他命令的执行。比如EnvironmentFile=-/etc/sysconfig/sshd（注意等号后面的那个连词号），就表示即使/etc/sysconfig/sshd文件不存在，也不会抛出错误。
  注意：[Service]中的启动、重启、停止命令全部要求使用绝对路径！
- 启动类型
  Type字段定义启动类型。它可以设置的值如下：
  simple（默认值）：ExecStart字段启动的进程为主进程
  forking：ExecStart字段将以fork()方式启动，此时父进程将会退出，子进程将成为主进程（后台运行）
  oneshot：类似于simple，但只执行一次，Systemd 会等它执行完，才启动其他服务
  dbus：类似于simple，但会等待 D-Bus 信号后启动
  notify：类似于simple，启动结束后会发出通知信号，然后 Systemd 再启动其他服务
  idle：类似于simple，但是要等到其他任务都执行完，才会启动该服务。一种使用场合是为让该服务的输出，不与其他服务的输出相混合
- 重启行为
  Service区块有一些字段，定义了重启行为：
  KillMode字段：定义 Systemd 如何停止 sshd 服务：
  control-group（默认值）：当前控制组里面的所有子进程，都会被杀掉
  process：只杀主进程
  mixed：主进程将收到 SIGTERM 信号，子进程收到 SIGKILL 信号
  none：没有进程会被杀掉，只是执行服务的 stop 命令。
  Restart字段：定义了 sshd 退出后，Systemd 的重启方式
  上面的例子中，Restart设为on-failure，表示任何意外的失败，就将重启sshd。如果 sshd 正常停止（比如执行systemctl stop命令），它就不会重启。
  Restart字段可以设置的值如下。
  no（默认值）：退出后不会重启
  on-success：只有正常退出时（退出状态码为0），才会重启
  on-failure：非正常退出时（退出状态码非0），包括被信号终止和超时，才会重启
  on-abnormal：只有被信号终止和超时，才会重启
  on-abort：只有在收到没有捕捉到的信号终止时，才会重启
  on-watchdog：超时退出，才会重启
  always：不管是什么退出原因，总是重启
  注：对于守护进程，推荐设为on-failure。对于那些允许发生错误退出的服务，可以设为on-abnormal。
  RestartSec字段：表示 Systemd 重启服务之前，需要等待的秒数。

[Install] 区块
Install区块，定义如何安装这个配置文件，即怎样做到开机启动。
WantedBy字段：表示该服务所在的 Target。
Target的含义是服务组，表示一组服务。
WantedBy=multi-user.target指的是：sshd 所在的 Target 是multi-user.target。
这个设置非常重要，因为执行systemctl enable sshd.service命令时，sshd.service的一个符号链接，就会放在/etc/systemd/system目录下面的multi-user.target.wants子目录之中。
Systemd 有默认的启动 Target。