参考：https://blog.csdn.net/djskl/article/details/46671453
https://zh.opensuse.org/openSUSE:How_to_write_a_systemd_service
https://www.cnblogs.com/yyxianren/articles/10677332.html

速成举例

$systemctl cat sshd.service

  1. [Unit] #控制单元：启动顺序与依赖关系
  2. Description=OpenSSH server daemon #当前服务的简单描述
  3. Documentation=man:sshd(8) man:sshd_config(5)  #文档位置
  4. After=network.target sshd-keygen.service  #after/before 涉及service服务在哪些服务启动顺序前后
  5. Wants=sshd-keygen.service #Wants表示shhd.service与sshd-keygen存在s弱依赖关系，requires存在强依赖关系会导致该服务停止退出
  7. [Service] #定义如何启动当前服务
  8. EnvironmentFile=/etc/sysconfig/sshd #指定当前服务的环境参数文件。该文件内部的key=value键值对，可以用$key的形式，在当前配置文件中获取。
  9. ExecStart=/usr/sbin/sshd -D $OPTIONS  #ExecStart定义启动进程时执行的命令。
  10. ExecReload=/bin/kill -HUP $MAINPID    #ExecReload重启服务时执行的命令
  11.         #ExecStop                停止服务时执行的命令
  12.         #ExecStartPre        启动服务之前执行的命令
  13.         #ExecStartPost    启动服务之后执行的命令
  14.         #ExecStopPost        停止服务之后执行的命令
  16. Type=simple        #定义启动类型
  17.         #    simple：                    ExecStart字段启动的进程为主进程
  18.         #    forking：                ExecStart字段将以fork()方式启动，此时父进程将会退出，子进程将成为主进程
  19.         #    oneshot：                类似于simple，但只执行一次，Systemd 会等它执行完，才启动其他服务
  20.         #    dbus：                        类似于simple，但会等待 D-Bus 信号后启动
  21.         #    notify：                    类似于simple，启动结束后会发出通知信号，然后 Systemd 再启动其他服务
  22.         #    idle：                        类似于simple，但是要等到其他任务都执行完，才会启动该服务。一种使用场合是为让该服务的输出，不与其他服务的输出相混合
  25. KillMode=process    #定义 Systemd 如何停止 sshd 服务。
  26.         #control-group（默认值）：当前控制组里面的所有子进程，都会被杀掉
  27.         #process：只杀主进程
  28.         #mixed：主进程将收到 SIGTERM 信号，子进程收到 SIGKILL 信号
  29.         #none：没有进程会被杀掉，只是执行服务的 stop 命令。
  31. Restart=on-failure    #定义了 sshd 退出后，Systemd 的重启方式
  32.         #no（默认值）：退出后不会重启
  33.         #on-success：只有正常退出时（退出状态码为0），才会重启
  34.         #on-failure：非正常退出时（退出状态码非0），包括被信号终止和超时，才会重启
  35.         #on-abnormal：只有被信号终止和超时，才会重启
  36.         #on-abort：只有在收到没有捕捉到的信号终止时，才会重启
  37.         #on-watchdog：超时退出，才会重启
  38.         #always：不管是什么退出原因，总是重启
  39.         #对于守护进程，推荐设为on-failure。对于那些允许发生错误退出的服务，可以设为on-abnormal
  41. RestartSec=42s    #表示 Systemd 重启服务之前，需要等待的秒数。上面的例子设为等待42秒。
  45. [Install] #定义如何安装这个配置文件，即怎样做到开机启动
  46. WantedBy=multi-user.target     #表示该服务所在的 Target（含义是服务组，表示一组服务）

Systemd 有默认的启动 Target。
$ systemctl get-default
multi-user.target
#上面的结果表示，默认的启动 Target 是multi-user.target。在这个组里的所有服务，都将开机启动

什么是 Systemd service？

一种以 .service 结尾的单元（unit）配置文件，用于控制由 systemd 控制或监视的进程。简单说，用于后台以守护精灵（daemon）的形式运行程序。

编写 Systemd service

基本结构

Systemd 服务的内容主要分为三个部分：Unit、[Service]（服务）、[Install] (安装)。

Systemd 语法

主要格式请见下面的小例子，这里需要说明三点：

  • Systemd 单元文件中的以 “#” 开头的行后面的内容会被认为是注释
  • Systemd 下的布尔值，1、yes、on、true 都是开启，0、no、off、false 都是关闭。注：

仅限于 Systemd 文件，比如：RemainOnExit=yes
并不适用于该文件中嵌入的 shell 语句，比如：
ExecStartPre=/usr/bin/test "x${NETWORKMANAGER}" = xyes
这里的 yes 就不能替换。因为等号后面是一条嵌入的 shell 语句。

  • Systemd 下的时间单位默认是秒，所以要用毫秒（ms）分钟（m）等请显式说明。

    定义控制单元 [Unit]

    在 Systemd 中，所有引导过程中 Systemd 要控制的东西都是一个单元。Systemd 单元类型有：

  • 系统服务

  • 套接字（socket）
  • 设备
  • 挂载点
  • 自动挂载点
  • SWAP 文件
  • 分区
  • 启动对象（startup target）
  • 文件系统路径
  • 定时器

简单说，Systemd 把 *nix 里那些分散开发因此宏观看变成一团杂碎的东西重新统一命名了。单元名就是你写的这个 .service 文件的名称。但不只有 .service 后缀的文件才可以是一个单元，单元还可以有 .target, .path 等后缀，具体可以去 /usr/lib/systemd/system 下了解。但那种后缀要么由 Systemd 上游开发者写好随 systemd 软件包分发，要么由我们的 Base:system 团队添加，一般用户是不太需要写其它后缀的控制单元的。
单元描述：

  1. [Unit]
  2. Description=Daemon to start He.net IPv6

下面我们要讲解一下 Systemd 是如何控制各个单元之间的关系的。它和 RPM 的 specfile 的依赖关系控制的语法非常相似（毕竟都是红帽一家的）：

  • Requires: 这个单元启动了，那么它“需要”的单元也会被启动; 它“需要”的单元被停止了，它自己也活不了。但是请注意，这个设定并不能控制某单元与它“需要”的单元的启动顺序（启动顺序是另外控制的），即 Systemd 不是先启动 Requires 再启动本单元，而是在本单元被激活时，并行启动两者。于是会产生争分夺秒的问题，如果 Requires 先启动成功，那么皆大欢喜; 如果 Requires 启动得慢，那本单元就会失败（Systemd 没有自动重试）。所以为了系统的健壮性，不建议使用这个标记，而建议使用 Wants 标记。可以使用多个 Requires。
  • RequiresOverridable：跟 Requires 很像。但是如果这条服务是由用户手动启动的，那么 RequiresOverridable 后面的服务即使启动不成功也不报错。跟 Requires 比增加了一定容错性，但是你要确定你的服务是有等待功能的。另外，如果不由用户手动启动而是随系统开机启动，那么依然会有 Requires 面临的问题。
  • Requisite：强势版本的 Requires。要是这里需要的服务启动不成功，那本单元文件不管能不能检测等不能等待都立刻就会失败。
  • Wants：推荐使用。本单元启动了，它“想要”的单元也会被启动。但是启动不成功，对本单元没有影响。
  • Conflicts：一个单元的启动会停止与它“冲突”的单元，反之亦然。注意这里和后面的启动顺序是“正交”的：

两个相互冲突的单元被同时启动，要么两个都启动不了（两者都是第三个单元的 Requires），要么启动一个（有一个是第三个单元的 Requires，另一个不是），不是 Requires 的那个会被停止。要是两者都不是任何一个单元的 Requires，那么 Conflicts 别的那个单元优先启动，被 Conflicts 的后启动，要是互相写了，那么两个都启动不了。

  • OnFailure：很明显，如果本单元失败了，那么启动什么单元作为折衷。

好了，现在我们来想象一下，我们的单元（Ipv6 隧道）应该想要什么呢？很显然是一个连通着的网络。有一个 Systemd 默认提供的对象叫做 network-online.target（默认的 target 列表可见 systemd.special，必看，因为你大多数时候 Wants 的都是一个固定的系统状态而不是其它 systemd 服务），正正好好能够提供我们需要的环境。于是：

  1. [Unit]
  2. Description=Daemon to start He.net IPv6
  3. Wants=network-online.target

下面我们需要定义一下服务启动顺序，不然连 / 目录所在的硬盘都没挂载就开始干活，上哪儿找程序去呀。Systemd 服务启动顺序主要使用以下两个标记定义的：

  • Before/After：要是一个服务 Before 另一个服务，那么在并行启动时（Systemd 总是用进程 0 并行启动所有东西，然后通过这两个标记来二次等待排序），那另一个服务这时就会等这个服务先启动并返回状态，注意是先启动而不是启动成功，因为失败也是一种状态，一定要成功才启动另一个服务是通过依赖关系定义的。反之 After 亦然。

下面说下“关机”（可以是挂起，这时候有些服务是依然在跑的，比如网络唤醒）时候的顺序：如果两个服务都是要关掉的，Before 是先关自己，After 是先关别人，这很好理解; 但如果一个服务是要关，而另一个是要开的，那么不管 Before/After 写了什么，总是优先关闭而不是开始。也就是比如服务 A Before 服务 B，但是服务 B 是在关，而服务 A 是在 restart，那么服务 B 的顺序在服务 A 的前面。
好啦，我们的单元应该在什么的前后启动呢？它不需要一定在什么服务前面跑起来，这不像 ifup 和 dhcp，网络起不来获取 ip 肯定没用。我们只需要有网就可以了。“有网”在 Systemd 中也是由一个默认 target：network.target 提供的，于是我们的控制单元就定义好了：

  1. [Unit]
  2. Description=Daemon to start He.net IPv6
  3. Wants=network-online.target
  4. After=network.target

定义服务本体 [service]

在定义完了 Systemd 用来识别服务的单元后，我们来定义服务本体，依然是声明：

  1. [Service]

然后是声明服务类型：

  1. [Service]
  2. Type=

Systemd 支持的服务类型有以下几类：

  • simple 默认，这是最简单的服务类型。意思就是说启动的程序就是主体程序，这个程序要是退出那么一切皆休。这在图形界面里非常好理解，我打开 Amarok，退出它就没有了。但是命令行的大部分程序都不会那么设计，因为命令行的一个最基本原则就是一个好的程序不能独占命令行窗口。所以输入命令，回车，接着马上返回给你提示符，但程序已经执行了。所以只有少数程序比如 python xxx.py 还使用这种方式。在这种类型下面，如果你的主程序是要响应其它程序的，那么你的通信频道应该在启动本服务前就设好（套接字等），因此这种类型的服务，Systemd 运行它后会立刻就运行下面的服务（需要它的服务），这时没有套接字后面的服务会失败，写 After 也没用，因为 simple 类型不存在主进程退出的情况也就不存在有返回状态的情况，所以它一旦启动就认为是成功的，除非没起来。
  • forking 标准 Unix Daemon 使用的启动方式。启动程序后会调用 fork() 函数，把必要的通信频道都设置好之后父进程退出，留下守护精灵的子进程。你要是使用的这种方式，最好也指定下 PIDFILE=，不要让 Systemd 去猜，非要猜也可以，把 GuessMainPID 设为 yes。

判断是 forking 还是 simple 类型非常简单，命令行里运行下你的程序，持续占用命令行要按 Ctrl + C 才可以的，就不会是 forking 类型。
创建 PIDFILE 是你为它写服务的程序的任务而不是 Systemd 的功能，甚至也不是 Sysvinit 脚本的功能。参考 startproc创建pid file的问题了解进一步的知识。因此如果你的程序确实是 forking 类型，但就是没实现创建 PIDFILE 的功能，那么建议使用 ExecStartPost= 结合 shell 命令来手动抓取进程编号并写到 /var/run/xxx.pid。

  • oneshot 顾名思义，打一枪换一个地方。所以这种服务类型就是启动，完成，没进程了。常见比如你设置网络，ifup eth0 up，就是一次性的，不存在 ifup 的子进程（forking 那样），也不存在主进程（simple 那样），它运行完成后便了无痕迹。因为这类服务运行完就没进程了，我们经常会需要 RemainAfterExit=yes。后面配置的意思是说，即使没进程了，我们也要 Systemd 认为该服务是存在并成功了的。所以如果你有一个这样的服务，服务启动后，你再去 ifup eth0 up，这时你再看服务，依然显示是 running 的。因为只要在执行那条一次性命令的时候没出错，那么它就永远认为它是成功并一直存在的，直到你关闭服务。
  • dbus 这个程序启动时需要获取一块 DBus 空间，所以需要和 BusName= 一起用。只有它成功获得了 DBus 空间，依赖它的程序才会被启动。

一般人也就能用到上面四个，还有两种少见的类型：

  • notify 这个程序在启动完成后会通过 sd_notify 发送一个通知消息。所以还需要配合 NotifyAccess 来让 Systemd 接收消息，后者有三个级别：none，所有消息都忽略掉; main，只接受我们程序的主进程发过去的消息; all，我们程序的所有进程发过去的消息都算。NotifyAccess 要是不写的话默认是 main。
  • idle 这个程序要等它里面调度的全部其它东西都跑完才会跑它自己。比如你 ExecStart 的是个 shell 脚本，里面可能跑了一些别的东西，如果不这样的话，那很可能别的东西的控制台输出里会多一个“启动成功”这样的 Systemd 消息。

由于 He.net 的 IPv6 是用 iproute2 的 ip 命令来弄的，所以是一个 oneshot 一次性服务。

  1. [Service]
  2. Type=oneshot
  3. RemainAfterExit=yes

接下来要设置 ExecStart, ExecStop。如果程序支持的话，你还可以去设置 ExecReload，Restart 等。注意，这里设置的是它们 Reload/Restart 的方式，但并不代表没有它们 Systemd 就不能完成比如 systemctl restart xxx.service 这样的任务，程序有支持自然最好，程序不支持那就先 stop 再 start 咯。同样有特殊要求的时候你也可以去设置比如 ExecStartPre/ExecStartPost,RestartSec,TimeoutSec 等其它东西，参考链接里都有使用方法。
这里要特殊讲一下 ExecStart：

  • 如果你服务的类型不是 oneshot，那么它只可以接受一个命令，参数不限，比如你先 ip tunnel create 再 ip tunnel0 up，那是两个 ip 命令，如果你不是 oneshot 类型这样是不行的。
  • 如果有多条命令（oneshot 类型），命令之间以分号 ; 分隔，跨行可用反斜杠 \。
  • 除非你的服务类型是 forking，否则你在这里输入的命令都会被认为是主进程，不管它是不是。

于是我们的 [Service] 就写好了：

  1.  [Service]
  2.  Type=oneshot
  3.  RemainAfterExit=yes
  4.  ExecStart=/usr/sbin/ip tunnel add he-ipv6 mode sit remote 66.220.18.42 local 108.170.7.158     ttl 255 ; \
  5.            /usr/sbin/ip link set he-ipv6 up ; \
  6.            /usr/sbin/ip addr add 2001:470:c:1184::2/64 dev he-ipv6 ; \
  7.            /usr/sbin/ip route add ::/0 dev he-ipv6 ; \
  8.            /usr/sbin/ip -6 addr
  9.  ExecStop=/usr/sbin/ip route delete ::/0 dev he-ipv6 ; \
  10.           /usr/sbin/ip -6 addr del 2001:470:c:1184::2/64 dev he-ipv6 ; \
  11.           /usr/sbin/ip link set he-ipv6 down ; \
  12.           /usr/sbin/ip tunnel del he-ipv6

安装服务 [install]

这可能有点绕，我服务文件都弄好了，放到 /etc/systemd/system（供系统管理员和用户使用），/usr/lib/systemd/system（供发行版打包者使用）了，不就是安装好了嘛。
这里说的是一种内部状态，默认你放对位置它显示的是 disabled，unloaded，所以我们要在 Systemd 内部对它进行一下 load，没人要的东西是不需要安装的（我们不收渣渣），所以我们要告诉 Systemd 它是有人要的，被谁要。一般都是被

  1. [Install]
  2. WantedBy=multi-user.target

要（multi-user.target 表示多用户系统好了，简单理解就是你可以登入了）。这样在 multi-user.target 启用时，我们的服务也就会被启用了。
[Install] 部分下除了 WantedBy 还有两种属性，分别是：

  • Alias= 给你自己的别名，这样 systemctl command xxx.service 的时候就可以不输入完整的单元名称。比如你给 NetworkManager 一个别名叫 Alias=nm，那你就可以 systemctl status nm.service 查看实际是 NetworkManager.service 的服务了。
  • Also= 安装本服务的时候还要安装别的什么服务。比如我们的 He.net 脚本按理应该需要一个 iproute2.service 作为 also，但是 iproute2 实际上不需要 systemd 控制，所以就没写。它和 [Unit] 定义里面的依赖关系相比，它管理的不是运行时依赖，而是安装时。安装好了之后启动谁先谁后，谁依赖谁，和 Also= 都没有关系。