systemctl
# 系统服务管理器指令
# 服务器路径
/usr/lib/systemd/system
该路径下文件名以 .service 结尾。
查看mongod.service：systemctl status mongod 或者 systemctl status mongod.service
1
2
3
4
2
3
4
# systemctl 常用命令
start 启动
stop 停止
status 查看状态
reload 加载文件
restart 重启
具体的详细情况可以查看帮助：systemctl -h
1
2
3
4
5
6
7
2
3
4
5
6
7
# 文件详解
# 1. Unit
所有 Unit 文件通用, 该部分主要是对这个服务的说明，以及配置与其他服务的关系。
参数详解如下：
Description ： 一段描述这个 Unit 文件的文字，通常只是简短的一句话。
Documentation：指定服务的文档，可以是一个或多个文档的URL路径。
Requires：依赖的其他 Unit 列表，列在其中的 Unit 模块会在这个服务启动的同时被启动，并且如果其中有任意一个服务启动失败，这个服务也会被终止
After：与 Requires 相似，但会在后面列出的所有模块全部启动完成以后，才会启动当前的服务。
Before：与 After 相反，在启动指定的任一个模块之前，都会首先确保当前服务已经运行。
注意：Before=, After= 是配置服务间的启动顺序，比如一个 foo.service 包含了一行 Before=bar.service，那么当他们同时启动时，bar.service 会等待 foo.service 启动完成后才启动。注意这个设置和 Requires= 的相互独立的，同时包含 After= 和 Requires= 也是常见的。此选项可以指定多次，然后按顺序全部启动
Wants：与 Requires 相似，但只是在被配置的这个 Unit 启- 动时，触发启动列出的每个 Unit 模块，而不去考虑这些模块启动是否成功。
Conflicts：与这个模块有冲突的模块，如果列出模块中有已经在运行的，这个服务就不能启动，反之亦然。
注意：如果这里列出的服务启动，那么本服务就会停止，反之亦然 ，即后启动的才起作用。注意，此设置和 After= 和 Before= 是互相独立的。
OnFailure：当这个模块启动失败时，就自动启动列出的每个模块。
PartOf ：该参数仅作用于单元的停止或重启。其含义是，当停止或重启这里列出的某个单元时， 也会同时停止或重启该单元自身。 注意，这个依赖是单向的， 该单元自身的停止或重启并不影响这里列出的单元。如果 a.service 中包含了 PartOf=b.service ，那么这个依赖关系将在 b.service 的属性列表中显示为 ConsistsOf=a.service 。 也就是说，不能直接设置 ConsistsOf= 依赖。
@ ： Linux 上配置过 openvpn 的同学应该都看到过一些 openvpn@client.service 这样的例子：
若需在系统启动时自动启动 OpenVPN，对服务器端与客户端，都可以采用在对应机器上 启用 openvpn@.service 的方式配置。例如，如果客户端配置文件是 /etc/openvpn/client.conf，则服务名称应为 openvpn@client.service。或者，如果服务器端配置文件是 /etc/openvpn/server.conf，则服务名称应为 openvpn@server.service。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 2. Service
Type：
设置进程的启动类型。必须设为 simple, exec, forking, oneshot, dbus, notify, idle 之一，默认的 simple 类型可以适应于绝大多数的场景，因此一般可以忽略这个参数的配置。而如果服务程序启动后会通过 fork 系统调用创建子进程，然后关闭应用程序本身进程的情况，则应该将 Type 的值设置为 forking，否则 systemd 将不会跟踪子进程的行为，而认为服务已经退出。其他类型说明见文章附录
Environment： 为服务添加环境变量
EnvironmentFile：指定加载一个包含服务所需的环境参数的文件，文件中的每一行都是一个环境变量的定义。
ExecStart：这个参数是几乎每个 .service 文件都会有的，指定服务启动的主要命令，在每个配置文件中只能使用一次。需要使用绝对路径
ExecStartPre：指定在启动执行 ExecStart 的命令前的准备工作，可以有多个，所有命令会按照文件中书写的顺序依次被执行。
ExecStartPost： 指定在启动执行 ExecStart 的命令后的收尾工作，也可以有多个。
ExecStop： 停止服务所需要执行的主要命令。需要使用绝对路径
ExecStopPost：指定在 ExecStop 命令执行后的收尾工作，也可以有多个。
ExecReload：重新加载服务文件所需执行的主要命令。需要使用绝对路径
Restart:这个值用于指定在什么情况下需要重启服务进程，这些不同的值分别表示了在哪些情况下，服务会被重新启动，
no（默认值）：退出后不会重启
always：除了用systemctl stop 或等价的服务停止操作命令，其他情况都可以重启
on-success：只有正常退出时（退出状态码为0），才会重启
on-failure：非正常退出时（退出状态码非0），包括被信号终止和超时，才会重启（守护进程，推荐值）
on-abnormal：只有被信号终止和超时，才会重启（对于允许发生错误退出的服务，推荐值）
on-abort：只有在收到没有捕捉到的信号终止时，才会重启
on-watchdog：超时退出，才会重启
RestartSec: 如果服务需要被重启，这个参数的值为服务被重启前的等待秒数。注意，该重启等待时间只针对上面Restart的参数值起作用时的重启才有效，比如说：因Unit段配置的关系或者人为使用systemctl restart命令导致该服务重启时，该参数无效，会马上重启
Nice:服务的进程优先级，值越小优先级越高，默认为0。-20为最高优先级，19为最低优先级。
WorkingDirectory:指定服务的工作目录。
RootDirectory:指定服务进程的根目录（ / 目录），如果配置了这个参数后，服务将无法访问指定目录以外的任何文件。
User:指定运行服务的用户，会影响服务对本地文件系统的访问权限。可使用root
Group:指定运行服务的用户组，会影响服务对本地文件系统的访问权限。
PrivateTmp:是否给服务分配独立的临时空间（true/false）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 3. Install
Install段是服务的安装信息，它不在 systemd 的运行期间使用，只在使用 systemctl enable 和 systemctl disable 命令启用/禁用服务时有用，所有 Unit 文件通用，用来定义如何启动，以及是否开机启动，参数详解如下：
WantedBy：它的值是一个或多个 target，执行enable命令时，符号链接会放入/etc/systemd/system目录下以
target 名 + .wants后缀构成的子目录中。“WantedBy=multi-user.target” 表明当系统以多用户方式（默认的运行级别）启动时，这个服务需要被自动运行。当然还需要 systemctl enable 激活这个服务以后自动运行才会生效
RequiredBy：依赖当前服务的模块。它的值是一个或多个 target，执行enable命令时，符号链接会放入/etc/systemd/system目录下以 target 名 + .required后缀构成的子目录中
Alias：当前 Unit 可用于启动的别名
Also：当前 Unit 被 enable/disable 时，会被同时操作的其他 Unit
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# 参考
上次更新: 2023/08/08, 20:00:46