服务配置文件编写

自定义的服务配置文件应当以service为后缀,这些service文件存放于/lib/systemd/system中。

所以我们只要在/usr/lib/systemd/system目录下创建对应后缀名为service的文件,即可创建对应的自定义服务

vim /usr/lib/systemd/system/helloworld.service

服务脚本的三个组成部分

[Unit]

Unit部分的内容让系统知道如何去管理这个服务。

常用的有

Description:简短描述
Documentation:文档地址
Requires:当前 Unit 依赖的其他 Unit,如果它们没有运行,当前 Unit 会启动失败
Wants:与当前 Unit 配合的其他 Unit,如果它们没有运行,当前 Unit 不会启动失败
BindsTo:与Requires类似,它指定的 Unit 如果退出,会导致当前 Unit 停止运行
Before:如果该字段指定的 Unit 也要启动,那么必须在当前 Unit 之后启动
After:如果该字段指定的 Unit 也要启动,那么必须在当前 Unit 之前启动
Conflicts:这里指定的 Unit 不能与当前 Unit 同时运行
Condition...:当前 Unit 运行必须满足的条件,否则不会运行
Assert...:当前 Unit 运行必须满足的条件,否则会报启动失败

[Service]

Service是脚本的关键部分,这一部分用于设置一些关键参数,描述了该服务应当如何执行。

Type:定义启动时的进程行为。它有以下几种值。
Type=simple:默认值,执行ExecStart指定的命令,启动主进程
Type=forking:以 fork 方式从父进程创建子进程,创建后父进程会立即退出
Type=oneshot:一次性进程,Systemd 会等当前服务退出,再继续往下执行
Type=dbus:当前服务通过D-Bus启动
Type=notify:当前服务启动完毕,会通知Systemd,再继续往下执行
Type=idle:若有其他任务执行完毕,当前服务才会运行
ExecStart:启动当前服务的命令
ExecStartPre:启动当前服务之前执行的命令
ExecStartPost:启动当前服务之后执行的命令
ExecReload:重启当前服务时执行的命令
ExecStop:停止当前服务时执行的命令
ExecStopPost:停止当其服务之后执行的命令
RestartSec:自动重启当前服务间隔的秒数
Restart:定义何种情况 Systemd 会自动重启当前服务,可能的值包括always(总是重启)、on-success、on-failure、on-abnormal、on-abort、on-watchdog
TimeoutSec:定义 Systemd 停止当前服务之前等待的秒数
Environment:指定环境变量

[Install]

通常是配置文件的最后一个区块,用来定义如何启动,主要字段如下

WantedBy:它的值是一个或多个 Target,当前 Unit 激活时(enable)符号链接会放入/etc/systemd/system目录下面以 Target 名 + .wants后缀构成的子目录中
RequiredBy:它的值是一个或多个 Target,当前 Unit 激活时,符号链接会放入/etc/systemd/system目录下面以 Target 名 + .required后缀构成的子目录中
Alias:当前 Unit 可用于启动的别名
Also:当前 Unit 激活(enable)时,会被同时激活的其他 Unit

演示

示例1:

在frp.service中输入以下内容

[Unit]
Description=MainFrpService
After=network.target
#在网络启动后执行Frp服务

[Service]
Type=simple
User=root
#以root权限运行
Restart=on-abort
#停止时重启
ExecStart=/root/frp/ssh/frpc -c /root/frp/ssh/frpc.ini

[Install]
WantedBy=multi-user.target

示例2:

helloworld.service中输入以下内容

[Unit]
Description=APK Server Service
#关于该服务的描述信息
StartLimitIntervalSec=0
#启动频率限制,这里设置为0
[Service]
Type=simple
Restart=always
#退出后自动重新启动服务,这里设置为总是
RestartSec=1
#重启延迟,这里设置为一秒
User=root
#运行权限
ExecStart=/usr/bin/env ruby -run -ehttpd /home/webbuild/easy_file_server/  -p8000

#ExecStart等号后面填写运行命令
#遇到EXEC错误时,可以在等号后面像这样跟一个/usr/bin/env

[Install]
WantedBy=multi-user.target

示例3:

一个简单的clash服务

[Unit]
Description=Freedom
#身在墻国,心向自由
After=network.target
#在网络启动后再执行

[Service]
Type=simple
User=root
#以root权限运行
Restart=on-abort
#停止时重启
ExecStart=/usr/bin/clash
#这个clash指的是是可执行文件,不是指目录

[Install]
WantedBy=multi-user.target

示例4:

MJGP启动服务

[Unit]
Description=MJGP
After=network.target

[Service]
Type=simple
User=root
Restart=on-abort
WorkingDirectory=/root/mjpg/mjpg-streamer/mjpg-streamer-experimental/
ExecStart=/root/mjpg/mjpg-streamer/mjpg-streamer-experimental/start.sh
[Install]
WantedBy=multi-user.target

示例5:

使用Service启动Jar包

[Unit]
Description=ipviewer  #服务描述
[Service]
Type=simple
User=root
Restart=on-abort
WorkingDirectory=/root/mycode/
ExecStart=/usr/java/jdk1.8.0_121/bin/java -Xmx1024m -Xms512m -Xss256k -jar /root/mycode/MyIPViewer.jar  
[Install]
WantedBy=multi-user.target

使用服务

启动服务[Start]

systemctl start helloworld.service

停止服务[Stop]

systemctl stop helloworld.service

重新启动服务[Restart]

systemctl restart helloworld.service

设置开机自启动

systemctl enable helloworld.service
#同理,关闭自启动应该是disable

查看服务状态[Status]

systemctl status helloworld.service

更新服务配置并使之生效

#修改服务的配置文件后,需要执行deamon-reload确保生效
systemctl daemon-reload

添加工作目录[WorkingDirectory]

在执行一个程序时,我们通常需要先进入一个文件夹,然后再执行文件。

这时我们可以添加一个工作目录来免去这一步,命令将直接在工作目录中执行。

在Service段落中,指定WorkingDirectory=[yourDictionary]

[Service]
...
WorkingDirectory=/root/yourdir
...

设置环境变量

[Service]
...
Environment="ANDROID_HOME=/opt/android-sdk-linux"
Environment="ANDROID_HOME=/opt/java"
...

EXEC错误

解决方案:增加/usr/bin/env

ExecStart=/usr/bin/env bash /root/automan/xxxxx/gradlew run

总结

systemctl start 服务名            开启服务
systemctl stop 服务名            关闭服务
systemctl status 服务名        显示状态
systemctl restart 服务名        重启服务
systemctl enable 服务名        开机启动服务
systemctl disable 服务名        禁止开机启动
systemctl list-units              查看系统中所有正在运行的服务
systemctl list-unit-files        查看系统中所有服务的开机启动状态
systemctl list-dependencies 服务名          查看系统中服务的依赖关系
systemctl mask 服务名                        冻结服务
systemctl unmask 服务名                      解冻服务
systemctl set-default multi-user.target     开机时不启动图形界面
systemctl set-default graphical.target      开机时启动图形界面
修改服务配置文件后需要
systemctl daemon-reload
设置服务开机自启动
systemctl enable postgresql.service

查询是否自启动服务
systemctl is-enabled postgresql.service

取消服务器开机自启动
systemctl disable postgresql.service
# 显示某个 Unit 是否正在运行
$ systemctl is-active application.service
# 显示某个 Unit 是否处于启动失败状态
$ systemctl is-failed application.service
# 显示某个 Unit 服务是否建立了启动链接
$ systemctl is-enabled application.service
# 查看当前运行的所有服务
systemctl list-units
# 查看每个服务的启动耗时
systemd-analyze blame
# 查看所有服务的开机启动状态
systemctl list-unit-files

关于服务状态的解析

以这个sshd服务的状态为例

1670036167738.webp

  • Loaded:配置文件的位置、是否开机启动
  • Active:当前是否正在运行
  • (running:正在运行;exited:执行完成并已退出;waiting:正在执行中;处于阻塞状态,可能正在等待其他应用程序;inactive dead:未启动状态)
  • Main PID:主进程PID
  • CGroup:该应用的所有子进程

Q.E.D.