linux的.service文件配置详解

首次发布:2023-06-29 23:52

[Unit]

  • Description给出当前服务的简单描述。

  • Documentation给出文档位置。

  • After表示在什么服务之后启动。

  • Before表示在什么服务之前启动。

  • Wants表示该服务和某服务存在某种弱依赖关系,即某服务停止运行或退出不影响该服务继续运行。

  • Requires则表示”强依赖”关系,即某服务停止运行或退出,改服务也必须停止运行。

  • Wants与Requires只涉及依赖关系,与启动顺序无关,默认情况下是同时启动的。

  • Conflicts:代表冲突的服务,即这个项目后面接的服务如果有启动,那么我们这个 unit 本身就不能启动,我们 unit 有启动,则此项目后的服务就不能启动,就是冲突性的检查。

注意:After和Before只涉及启动顺序,不涉及依赖关系。


[Service]

Type :定义启动类型
  • simple(默认值):ExecStart启动的进程为主进程

  • forking:ExecStart将以fork()方式启动,此时父进程将会退出,子进程将成为主进程

  • oneshot:类似于simple,但只执行一次,Systemd 会等它执行完,才启动其他服务

  • dbus:类似于simple,但会等待 D-Bus 信号后启动

  • notify:类似于simple,启动结束后会发出通知信号,然后 Systemd 再启动其他服务

  • idle:类似于simple,但是要等到其他任务都执行完,才会启动该服务。一种使用场合是为让该服务的输出,不与其他服务的输出相混

ExecStart:定义启动进程时执行的命令,就是手动启动时执行的命令。
ExecReload:重启服务时执行的命令。
ExecStop:停止服务时执行的命令。
ExecStartPre:启动服务之前执行的命令。
ExecStartPost:启动服务之后执行的命令。
ExecStopPost:停止服务之后执行的命令。
killmod:定义 Systemd 如何停止 sshd 服务。
  • control-group(默认值):当前控制组里面的所有子进程,都会被杀掉

  • process:只杀主进程

  • mixed:主进程将收到 SIGTERM 信号,子进程收到 SIGKILL 信号

  • none:没有进程会被杀掉,只是执行服务的 stop 命令

Restart:定义了 sshd 退出后,Systemd 的重启方式。
  • no(默认值):退出后不会重启

  • on-success:只有正常退出时(退出状态码为0),才会重启

  • on-failure:非正常退出时(退出状态码非0),包括被信号终止和超时,才会重启

  • on-abnormal:只有被信号终止和超时,才会重启

  • on-abort:只有在收到没有捕捉到的信号终止时,才会重启

  • on-watchdog:超时退出,才会重启

  • always:不管是什么退出原因,总是重启

对于守护进程,推荐设为on-failure。对于那些允许发生错误退出的服务,可以设为on-abnormal。


RestartSec:表示 Systemd 重启服务之前,需要等待的秒数。
user可以设置服务的用户名
WorkingDirectory指定服务的安装目录
RemainAfterExit:当设置为 RemainAfterExit=1 时,则当这个 daemon 所属的所有程序都终止之后,此服务会再尝试启动。这对于Type=oneshot 的服务很有帮助
TimeoutSec: 若这个服务在启动或者是关闭时,因为某些缘故导致无法顺利 “ 正常启动或正常结束” 的情况下,则我们要等多久才进入 “ 强制结束 ” 的状态!
EnvironmentFile:可以指定启动脚本的环境配置文件!例如 sshd.service 的配置文件写入到/etc/sysconfig/sshd 当中!你也可以使用 Environment= 后面接多个不同的Shell 变量来给予设置

[Install]

WantedBy:表示该服务所在的 Target。 Target的含义是服务组,表示一组服务。WantedBy=multi-user.target指的是服务所在的Target是multi-user.target。

Systemd 默认的启动 Target就是multi-user.target,在这个组里的所有服务,都将开机启动。

查看 multi-user.target 包含的所有服务:

systemctl list-dependencies multi-user.target
Also:当目前这个 unit 本身被 enable 时, Also 后面接的 unit 也请 enable。 也就是具有相依性的服务可以写在这里。
Alias:进行一个链接的别名,当 systemctl enable 相关的服务时则此服务会进行链接文件的创建,以multi-user.target 为例,这个组是用来作为默认操作环境default.target 的规划,因此当你设置成 default.target时,这个/etc/systemd/system/default.target 就会链接到/usr/lib/systemd/system/multi-user.target。