1
# ============================================
2
# [Unit] 段：定义服务的元信息、描述和依赖关系
3
# ============================================
4
[Unit]
5
# 服务的简短描述，会显示在 systemctl status 中
6
Description=My Application
7

8
# 文档链接，可以是 man 手册、网页或本地文件路径
9
# Documentation=man:myapp(8)
10
# Documentation=https://example.com/docs
11

12
# 启动顺序：本服务在 network.target 之后启动
13
# 注意：After 只控制顺序，不控制依赖
14
After=network.target
15

16
# 强依赖：启动本服务前，必须先启动这些服务
17
# 如果依赖服务启动失败，本服务也会失败
18
# Requires=network.target mysql.service
19

20
# 弱依赖：尽可能启动这些服务，但不影响本服务启动
21
# Wants=network.target
22

23
# 反向顺序：本服务应该在哪些服务之前启动
24
# Before=nginx.service
25

26
# 冲突服务：不能与这些服务同时运行，会自动停止冲突服务
27
# Conflicts=another-app.service
28

29
# 启动条件判断：条件不满足时跳过启动（软失败）
30
# ConditionPathExists=/etc/myapp/config.conf
31
# ConditionDirectoryNotEmpty=/var/lib/myapp
32
# ConditionUser=root
33

34
# 断言判断：条件不满足时启动失败（硬错误）
35
# AssertPathExists=/usr/local/bin/myapp
36
# AssertUser=root
37

38
# ============================================
39
# [Service] 段：定义服务的执行方式和生命周期管理
40
# ============================================
41
[Service]
42

43
# ---- 服务类型 ----
44
# simple: 默认，ExecStart 启动的进程保持前台运行
45
# forking: 服务通过 fork 创建守护进程后父进程退出（传统守护进程）
46
# oneshot: 执行一次性任务，执行完即退出
47
# notify: 服务启动后会发送 sd_notify 通知 systemd
48
# dbus: 服务在 D-Bus 上注册后认为启动完成
49
# idle: 延迟到所有其他任务处理完再启动
50
Type=simple
51

52
# ---- 进程执行配置 ----
53
# 启动命令（必须），必须使用绝对路径
54
ExecStart=/usr/local/bin/myapp
55

56
# 启动前的准备命令（可多个，按顺序执行）
57
# ExecStartPre=/usr/local/bin/myapp --check-config
58
# ExecStartPre=/bin/mkdir -p /var/run/myapp
59

60
# 启动后的收尾命令
61
# ExecStartPost=/bin/echo "MyApp started"
62

63
# 停止命令，默认发送 SIGTERM
64
# ExecStop=/usr/local/bin/myapp --shutdown
65

66
# 停止后的收尾命令
67
# ExecStopPost=/bin/rm -f /var/run/myapp.pid
68

69
# 重载配置命令（systemctl reload）
70
ExecReload=/bin/kill -HUP $MAINPID
71

72
# ---- 进程管理 ----
73
# 主进程 PID 变量，可用于 ExecReload 等
74
# $MAINPID 由 systemd 自动设置为服务主进程 PID
75

76
# 服务运行用户
77
User=www-data
78

79
# 服务运行组（默认与用户主组相同）
80
# Group=www-data
81

82
# 工作目录
83
# WorkingDirectory=/var/www/myapp
84

85
# 根目录（chroot），设置后服务无法访问指定目录外文件
86
# RootDirectory=/var/chroot/myapp
87

88
# 环境变量（可多次指定）
89
# Environment="NODE_ENV=production"
90
# Environment="PORT=8080"
91

92
# 环境变量文件（每行一个 KEY=VALUE）
93
# EnvironmentFile=/etc/default/myapp
94
# EnvironmentFile=-/etc/default/myapp  # 减号表示文件不存在也不报错
95

96
# ---- 重启策略 ----
97
# no: 不自动重启（默认）
98
# on-success: 退出码为 0 时重启
99
# on-failure: 退出码非 0 时重启
100
# on-abnormal: 被信号终止或超时重启
101
# on-abort: 被信号终止时重启（不含 SIGHUP/SIGINT）
102
# on-watchdog: 看门狗超时重启
103
# always: 总是重启
104
Restart=on-failure
105

106
# 重启间隔秒数
107
RestartSec=5
108

109
# 启动超时时间（0 表示禁用超时检测）
110
# TimeoutStartSec=30
111

112
# 停止超时时间，超时后发送 SIGKILL
113
# TimeoutStopSec=30
114

115
# 同时设置启动和停止超时
116
# TimeoutSec=30
117

118
# 启动频率限制：在指定时间内最多重启次数
119
# StartLimitIntervalSec=60
120
# StartLimitBurst=3
121

122
# ---- 标准输入输出 ----
123
# 标准输出目标：journal/syslog/kern/tty/null/socket/fd/file
124
# StandardOutput=journal
125

126
# 标准错误输出目标
127
# StandardError=journal
128

129
# 标准输入来源：null/tty/tty-force/tty-fail/file/fd/socket
130
# StandardInput=null
131

132
# ---- 资源限制（类似 ulimit） ----
133
# 文件描述符数量限制
134
# LimitNOFILE=65535
135

136
# 进程数量限制
137
# LimitNPROC=4096
138

139
# core dump 文件大小限制
140
# LimitCORE=infinity
141

142
# ---- 进程终止配置 ----
143
# 终止模式：
144
# control-group: 终止控制组内所有进程（默认）
145
# process: 仅终止主进程
146
# mixed: 主进程发 SIGTERM，其他进程发 SIGKILL
147
# none: 不终止任何进程
148
# KillMode=control-group
149

150
# 发送给主进程的终止信号
151
# KillSignal=SIGTERM
152

153
# 最终强制终止信号
154
# FinalKillSignal=SIGKILL
155

156
# 发送 SIGKILL 前的等待时间
157
# TimeoutAbortSec=30
158

159
# ---- 看门狗配置 ----
160
# 启用看门狗，服务需定期调用 sd_notify("WATCHDOG=1")
161
# WatchdogSec=30
162

163
# ---- 其他配置 ----
164
# 是否为 oneshot 类型保持激活状态（即使进程已退出）
165
# RemainAfterExit=yes
166

167
# 服务私有的临时文件目录
168
# RuntimeDirectory=myapp
169
# RuntimeDirectoryMode=0755
170

171
# 状态目录
172
# StateDirectory=myapp
173

174
# 缓存目录
175
# CacheDirectory=myapp
176

177
# 日志目录
178
# LogsDirectory=myapp
179

180
# 配置目录
181
# ConfigurationDirectory=myapp
182

183
# 是否从 /dev、/proc、/sys 挂载私有副本
184
# PrivateDevices=yes
185

186
# 是否启用私有网络命名空间
187
# PrivateNetwork=yes
188

189
# 是否启用私有用户命名空间
190
# PrivateUsers=yes
191

192
# 是否启用私有挂载命名空间
193
# PrivateMounts=yes
194

195
# 能力限制（Linux capabilities）
196
# CapabilityBoundingSet=CAP_NET_BIND_SERVICE CAP_DAC_READ_SEARCH
197

198
# 安全相关选项
199
# NoNewPrivileges=yes
200
# ProtectSystem=strict
201
# ProtectHome=yes
202
# ReadWritePaths=/var/lib/myapp
203

204
# ============================================
205
# [Install] 段：定义服务如何安装到系统中
206
# ============================================
207
[Install]
208

209
# 启用服务时，创建符号链接到该 target 的 .wants 目录
210
# multi-user.target: 多用户命令行模式（类似运行级别3）
211
# graphical.target: 图形界面模式（类似运行级别5）
212
WantedBy=multi-user.target
213

214
# 强依赖版本，服务失败会影响 target
215
# RequiredBy=multi-user.target
216

217
# 别名，可用 systemctl enable/disable 操作别名
218
# Alias=myapp-daemon.service
219

220
# 启用/禁用本服务时，同时操作的其他服务
221
# Also=myapp-socket.socket
222

223
# 启用时的默认目标（systemctl enable 时使用）
224
# DefaultInstance=

1
# ============================================
2
# [Unit] 段：定义套接字单元的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# 套接字单元的简短描述
6
Description=My Application Socket
7

8
# 文档链接
9
# Documentation=man:systemd.socket(5)
10

11
# 启动顺序：在 network.target 之后启动
12
After=network.target
13

14
# 启动顺序：在 sockets.target 之前启动
15
# sockets.target 是系统启动时统一启动所有套接字的目标
16
Before=sockets.target
17

18
# 弱依赖：启动本套接字前尽可能启动这些服务
19
# Wants=network.target
20

21
# 强依赖：启动本套接字前必须先启动这些服务
22
# Requires=network.target
23

24
# 冲突服务：不能与这些服务同时运行
25
# Conflicts=shutdown.target
26
# Before=shutdown.target
27

28
# ============================================
29
# [Socket] 段：定义套接字的监听配置
30
# ============================================
31
[Socket]
32

33
# ---- 监听地址与类型（核心配置）----
34

35
# 流式套接字（SOCK_STREAM）- 通常用于 TCP
36
# 格式：IP:PORT 或 [IPv6]:PORT 或 /path/to/socket
37
ListenStream=0.0.0.0:8080
38
# ListenStream=127.0.0.1:8080
39
# ListenStream=/run/myapp.sock
40

41
# 数据报套接字（SOCK_DGRAM）- 通常用于 UDP
42
# ListenDatagram=53
43

44
# 顺序包套接字（SOCK_SEQPACKET）- 用于可靠有序数据传输
45
# ListenSequentialPacket=/run/myapp-seq.sock
46

47
# FIFO 命名管道
48
# ListenFIFO=/run/myapp.fifo
49

50
# Netlink 套接字（用于内核通信）
51
# ListenNetlink=audit 1
52

53
# POSIX 消息队列
54
# ListenMessageQueue=/myapp-queue
55

56
# USB 功能端点（用于 USB gadget 模式）
57
# ListenUSBFunction=ffs.myapp
58

59
# 特殊值：留空表示重置所有已定义的监听地址
60
# ListenStream=
61

62
# ---- 连接处理模式 ----
63

64
# 连接处理方式：
65
# no（默认）：将监听套接字传递给服务，服务自己 accept() 连接
66
# yes：为每个连接创建独立的 [name@.service] 实例（inetd 风格）
67
Accept=no
68

69
# 当 Accept=yes 时，指定要实例化的服务模板
70
# 例如：Accept=yes 且 Service=myapp@.service 时，
71
# 每个连接会创建 myapp@<连接ID>.service 实例
72
# Service=myapp.service
73

74
# ---- 套接字选项 ----
75

76
# 绑定 IPv6 专用模式：
77
# default：根据系统默认（/proc/sys/net/ipv6/bindv6only）
78
# yes：仅绑定 IPv6
79
# no：同时绑定 IPv4 和 IPv6（双栈）
80
BindIPv6Only=default
81

82
# 重用端口（允许多个进程绑定同一端口，用于负载均衡）
83
# ReusePort=yes
84

85
# 监听队列长度（backlog）
86
# Backlog=128
87

88
# 是否延迟激活（接收到数据时才激活服务，而非连接建立时）
89
# DeferAcceptSec=5
90

91
# 是否禁用 Nagle 算法（TCP_NODELAY）
92
# NoDelay=yes
93

94
# 是否启用 TCP keepalive
95
# KeepAlive=yes
96

97
# Keepalive 时间设置（秒）
98
# KeepAliveTimeSec=7200
99

100
# Keepalive 探测间隔（秒）
101
# KeepAliveIntervalSec=75
102

103
# Keepalive 探测次数
104
# KeepAliveProbes=9
105

106
# 标记套接字（用于 SO_MARK）
107
# Mark=1234
108

109
# 最大连接数
110
# MaxConnections=64
111

112
# 每个连接的超时时间（秒）
113
# MaxConnectionsPerSource=256
114

115
# 消息队列最大大小（字节）
116
# MessageQueueMaxMessages=10
117
# MessageQueueMessageSize=8192
118

119
# ---- 文件系统与权限（用于 AF_UNIX/FIFO）----
120

121
# 套接字文件的所有者用户
122
SocketUser=www-data
123

124
# 套接字文件的所属组
125
SocketGroup=www-data
126

127
# 套接字文件的权限模式（八进制）
128
SocketMode=0660
129

130
# 自动创建父目录时的权限模式
131
DirectoryMode=0755
132

133
# 停止套接字单元时是否删除文件系统节点
134
# 注意：通常不推荐使用，因为服务可能仍在使用
135
# RemoveOnStop=no
136

137
# 创建指向套接字的符号链接（别名）
138
# Symlinks=/run/myapp-alias.sock
139

140
# ---- 文件描述符传递 ----
141

142
# 为传递的文件描述符命名，便于服务识别
143
# FileDescriptorName=myapp-socket
144

145
# 是否传递套接字的 credentials（SCM_CREDENTIALS）
146
PassCredentials=yes
147

148
# 是否传递套接字的 security context（SELinux）
149
PassSecurity=yes
150

151
# 接收缓冲区大小（字节）
152
# ReceiveBuffer=8M
153

154
# 发送缓冲区大小（字节）
155
# SendBuffer=8M
156

157
# 是否移除传递的套接字上的 close-on-exec 标志
158
# PassEnvironment=yes
159

160
# ---- 触发限制（防雪崩保护）----
161

162
# 触发间隔时间（秒）
163
# TriggerLimitIntervalSec=2
164

165
# 在触发间隔内允许的最大触发次数
166
# TriggerLimitBurst=200
167

168
# ---- 执行命令（可选）----
169

170
# 启动套接字前的准备命令
171
# ExecStartPre=/bin/mkdir -p /run/myapp
172

173
# 启动套接字后的命令
174
# ExecStartPost=/bin/chown www-data:www-data /run/myapp.sock
175

176
# 停止套接字前的命令
177
# ExecStopPre=
178

179
# 停止套接字后的命令
180
# ExecStopPost=/bin/rm -f /run/myapp.sock
181

182
# ============================================
183
# [Install] 段：定义套接字如何安装到系统
184
# ============================================
185
[Install]
186

187
# 启用时链接到 sockets.target
188
# 这是所有套接字单元的标准目标
189
WantedBy=sockets.target
190

191
# 强依赖版本
192
# RequiredBy=sockets.target
193

194
# 别名
195
# Alias=myapp-daemon.socket
196

197
# 启用/禁用本单元时同时操作的其他单元
198
# Also=myapp.service

1
# ============================================
2
# Socket Activation 配套的服务单元
3
# ============================================
4

5
[Unit]
6
Description=My Application Service
7
# 关键：确保服务在套接字之后启动，且套接字存在
8
Requires=myapp.socket
9
After=myapp.socket
10

11
[Service]
12
Type=simple
13
User=www-data
14
ExecStart=/usr/local/bin/myapp
15

16
# 重启策略
17
Restart=on-failure
18
RestartSec=5
19

20
# 标准输入输出（如果使用 inetd 风格的 Accept=yes）
21
# StandardInput=socket
22
# StandardOutput=socket
23

24
[Install]
25
# 注意：socket 激活的服务通常不需要 WantedBy=multi-user.target
26
# 因为服务是由套接字按需启动的
27
# 但如果需要开机启动，可以启用此配置
28
WantedBy=multi-user.target

1
# ============================================
2
# [Unit] 段：定义 Target 的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Target 的简短描述，显示在 systemctl status 中
6
Description=My Application Target
7

8
# 文档链接，可以是 man 手册或网页
9
Documentation=man:systemd.special(7)
10
# Documentation=https://example.com/docs/myapp-target
11

12
# ---- 依赖关系配置 ----
13

14
# 强依赖：启动本 Target 前必须先启动这些 Unit
15
# 如果依赖的 Unit 启动失败，本 Target 也会失败
16
Requires=basic.target
17
# Requires=network.target mysql.service
18

19
# 弱依赖：尽可能启动这些 Unit，但不影响本 Target 启动
20
# Wants=myapp-database.service myapp-cache.service
21

22
# 启动顺序：本 Target 在这些 Unit 之后启动
23
# 注意：After 只控制顺序，不控制依赖
24
After=basic.target network.target
25
# After=myapp-database.service
26

27
# 启动顺序：本 Target 在这些 Unit 之前启动
28
# Before=multi-user.target
29

30
# 冲突 Unit：不能与这些 Unit 同时运行
31
# 当切换到本 Target 时，会自动停止冲突的 Unit
32
Conflicts=rescue.service rescue.target
33
# Conflicts=shutdown.target
34

35
# 反向依赖：哪些 Unit 依赖于本 Target（用于 systemctl enable）
36
# 通常不需要手动设置，由其他 Unit 的 WantedBy/RequiredBy 决定
37
# WantedBy=
38
# RequiredBy=
39

40
# ---- 启动条件与断言 ----
41

42
# 条件判断：条件不满足时跳过启动（软失败）
43
# ConditionPathExists=/etc/myapp/enabled
44
# ConditionDirectoryNotEmpty=/var/lib/myapp
45

46
# 断言判断：条件不满足时启动失败（硬错误）
47
# AssertPathExists=/usr/bin/myapp
48

49
# ---- 隔离模式配置 ----
50

51
# 允许使用 systemctl isolate 命令切换到此 Target
52
# 为 yes 时，切换到本 Target 会停止不属于本 Target 的其他 Unit
53
# 为 no（默认）时，isolate 命令会拒绝执行
54
AllowIsolate=yes
55

56
# 忽略隔离请求（当其他 Target 执行 isolate 时，本 Target 保持运行）
57
# IgnoreOnIsolate=no
58

59
# ---- 停止行为配置 ----
60

61
# 停止本 Target 时，是否同时停止依赖它的 Unit
62
# StopWhenUnneeded=no
63

64
# 忽略停止信号（systemctl stop 时保持运行）
65
# RefuseManualStop=no
66

67
# 忽略启动信号（systemctl start 时拒绝启动）
68
# RefuseManualStart=no
69

70
# ---- 其他元信息 ----
71

72
# 启动失败时的默认依赖行为
73
# DefaultDependencies=yes
74

75
# 任务超时时间
76
# JobTimeoutSec=0
77
# JobRunningTimeoutSec=0
78

79
# 超时后的动作：fail/replace/ignore/isolate
80
# JobTimeoutAction=fail
81
# JobTimeoutRebootArgument=
82

83
# ============================================
84
# [Install] 段：定义 Target 如何安装到系统
85
# ============================================
86
[Install]
87

88
# 启用时创建符号链接到该 Target 的 .wants 目录
89
# 通常不需要设置，因为 Target 一般直接由其他 Unit 引用
90
# WantedBy=multi-user.target
91

92
# 强依赖版本
93
# RequiredBy=
94

95
# 别名
96
# Alias=myapp-group.target
97

98
# 启用/禁用本 Target 时同时操作的其他 Unit
99
# Also=myapp.service myapp.socket

1
# ============================================
2
# [Unit] 段：定义 Timer 的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Timer 单元的简短描述
6
Description=My Application Timer
7

8
# 文档链接
9
Documentation=man:systemd.timer(5)
10
# Documentation=https://example.com/docs/myapp-timer
11

12
# 启动顺序：在这些 Unit 之后启动
13
After=network.target
14

15
# 弱依赖：尽可能启动这些 Unit
16
# Wants=network.target
17

18
# 强依赖：必须先启动这些 Unit
19
# Requires=network.target
20

21
# 冲突 Unit：不能与这些同时运行
22
# Conflicts=shutdown.target
23

24
# 启动条件
25
# ConditionPathExists=/etc/myapp/enabled
26

27
# ============================================
28
# [Timer] 段：定义定时触发规则（核心配置）
29
# ============================================
30
[Timer]
31

32
# ---- 基础定时触发（OnCalendar）----
33

34
# 日历时间触发（类似 cron，但语法更强大）
35
# 格式：DayOfWeek Year-Month-Day Hour:Minute:Second
36
# 支持通配符 * 和范围
37
OnCalendar=*-*-* *:*:00           # 每分钟
38
# OnCalendar=*-*-* 02:00:00        # 每天凌晨 2 点
39
# OnCalendar=Mon *-*-* 09:00:00    # 每周一 9 点
40
# OnCalendar=*-*-01 00:00:00       # 每月 1 号
41
# OnCalendar=*-01-01 00:00:00      # 每年 1 月 1 号
42
# OnCalendar=Mon..Fri 09:00:00     # 工作日 9 点
43
# OnCalendar=*-*-* 09:00,15:00:00  # 每天 9 点和 15 点
44

45
# 使用具体日期
46
# OnCalendar=2024-12-25 00:00:00
47

48
# 相对时间语法
49
# OnCalendar=*:0/10                # 每 10 分钟
50
# OnCalendar=*-01/3-01 00:00:00    # 每 3 个月的 1 号
51

52
# 时区指定（默认系统时区）
53
# OnCalendar=*-*-* 09:00:00 Asia/Shanghai
54

55
# ---- 单调时钟触发（Monotonic Timers）----
56

57
# 系统启动后触发（开机后）
58
# OnBootSec=5min                   # 开机 5 分钟后
59
# OnBootSec=10s
60

61
# 系统首次激活后触发（systemd 第一次启动）
62
# OnStartupSec=1min
63

64
# 本 Timer 单元激活后触发
65
# OnActiveSec=30min                # Timer 启动 30 分钟后
66

67
# 关联 Unit 激活后触发
68
# OnUnitActiveSec=1h               # 上次运行后 1 小时
69
# OnUnitInactiveSec=30min          # 上次停止后 30 分钟
70

71
# ---- 持久化配置 ----
72

73
# 持久化模式：如果系统关机时错过了触发，开机后补执行
74
# 适用于定时备份、日志轮转等不能错过的任务
75
Persistent=true
76

77
# 持久化精度（秒），控制补执行的精度范围
78
# AccuracySec=1min
79

80
# ---- 随机延迟 ----
81

82
# 随机延迟时间，防止多个 Timer 同时触发造成负载高峰
83
# 格式：秒、分钟、小时等
84
RandomizedDelaySec=30             # 随机延迟 0-30 秒
85
# RandomizedDelaySec=5min
86

87
# 是否固定随机种子（相同配置产生相同随机数）
88
# FixedRandomDelay=no
89

90
# ---- 触发精度 ----
91

92
# 触发精度，用于合并相近时间的触发以节省资源
93
# AccuracySec=1min                 # 默认 1 分钟
94
# AccuracySec=1us                  # 微秒级（高精度但费电）
95

96
# ---- 触发关联配置 ----
97

98
# 要触发的 Unit（默认是同名的 .service）
99
# 例如：myapp.timer 默认触发 myapp.service
100
Unit=myapp.service
101

102
# 触发时传递给 Unit 的属性
103
# 可以覆盖被触发 Unit 的某些设置
104
# PropagatesReloadTo=myapp.service
105

106
# ---- 触发限制 ----
107

108
# 在日历事件触发后，延迟多久才执行
109
# OnCalendarSec=5min
110

111
# 两次触发之间的最小间隔（防抖动）
112
# OnClockChange=yes               # 系统时间调整时是否触发
113

114
# ---- 其他配置 ----
115

116
# 是否保持 Timer 运行（即使关联的 Unit 失败）
117
# RemainAfterElapse=yes
118

119
# 是否唤醒休眠的系统
120
# WakeSystem=no                    # 需要硬件支持 RTC 唤醒
121

122
# 硬件时钟使用 UTC 还是本地时间
123
# UTC=no
124

125
# ============================================
126
# [Install] 段：定义 Timer 如何安装到系统
127
# ============================================
128
[Install]
129

130
# 启用时链接到 timers.target（所有 Timer 的默认目标）
131
WantedBy=timers.target
132

133
# 强依赖版本
134
# RequiredBy=timers.target
135

136
# 别名
137
# Alias=myapp-cron.timer
138

139
# 启用/禁用时同时操作的其他 Unit
140
# Also=myapp.service

1
[Unit]
2
Description=My Application Service
3
# 不需要 [Install] 段，因为由 Timer 触发
4

5
[Service]
6
Type=oneshot                      # 一次性任务，执行完即退出
7
ExecStart=/usr/local/bin/myapp --run-task
8

9
# 如果任务可能运行时间较长，可使用 simple 类型
10
# Type=simple
11
# ExecStart=/usr/local/bin/myapp-daemon
12

13
# 环境变量
14
Environment="TASK_TYPE=scheduled"
15

16
# 工作目录
17
WorkingDirectory=/var/lib/myapp
18

19
[Install]
20
# 通常不需要 WantedBy，因为由 Timer 管理
21
# 但如果需要手动启动，可以保留
22
# WantedBy=multi-user.target

1
# ============================================
2
# [Unit] 段：定义 Mount 的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Mount 单元的描述
6
Description=Data Partition Mount
7

8
# 文档链接
9
Documentation=man:systemd.mount(5)
10

11
# ---- 依赖关系 ----
12

13
# 强依赖：挂载前必须先启动这些 Unit
14
# 通常需要 local-fs-pre.target 和块设备
15
Requires=local-fs-pre.target
16
Requires=dev-disk-by\x2duuid-12345678\x2d1234\x2d1234\x2d1234\x2d123456789abc.device
17

18
# 弱依赖
19
# Wants=
20

21
# 启动顺序：在这些 Unit 之后挂载
22
After=local-fs-pre.target
23
After=dev-disk-by\x2duuid-12345678\x2d1234\x2d1234\x2d1234\x2d123456789abc.device
24
# After=network.target              # 网络文件系统需要
25

26
# 启动顺序：在这些 Unit 之前挂载
27
Before=local-fs.target
28

29
# 冲突 Unit
30
Conflicts=umount.target
31
# Conflicts=shutdown.target
32

33
# ---- 启动条件 ----
34

35
# 条件判断
36
# ConditionPathExists=/dev/sdb1
37
# ConditionDirectoryNotEmpty=/mnt/data
38

39
# ============================================
40
# [Mount] 段：定义挂载参数（核心配置）
41
# ============================================
42
[Mount]
43

44
# ---- 挂载源和目标（必需）----
45

46
# 要挂载的设备或远程路径
47
What=/dev/disk/by-uuid/12345678-1234-1234-1234-123456789abc
48
# What=/dev/sdb1
49
# What=192.168.1.100:/nfs/export    # NFS 远程路径
50
# What=//192.168.1.100/share        # SMB/CIFS 路径
51

52
# 挂载点（必须是绝对路径，且单元文件名必须匹配）
53
# 例如：mnt-data.mount 对应 /mnt/data
54
Where=/mnt/data
55

56
# ---- 文件系统类型 ----
57

58
# 文件系统类型
59
Type=ext4
60
# Type=xfs
61
# Type=btrfs
62
# Type=nfs
63
# Type=cifs
64
# Type=vfat
65
# Type=auto                         # 自动检测
66

67
# ---- 挂载选项 ----
68

69
# 挂载选项（逗号分隔，无空格）
70
Options=defaults,noatime,discard
71
# Options=rw,sync,noexec,nosuid,nodev
72
# Options=username=user,password=pass,uid=1000  # CIFS 认证
73

74
# 额外的挂载标志
75
# SloppyOptions=no                  # 是否忽略不支持的挂载选项
76

77
# ---- 挂载模式 ----
78

79
# 是否以只读方式挂载
80
# ReadOnlyOnly=no                   # 只尝试只读挂载
81

82
# 是否强制作为绑定挂载
83
# BindPaths=
84
# BindReadOnlyPaths=
85

86
# 是否作为移动挂载（mount --move）
87
# MoveDirectory=no
88

89
# ---- 挂载前准备 ----
90

91
# 挂载前执行的命令
92
# ExecMount=/bin/mount ...
93

94
# 挂载后执行的命令
95
# ExecUnmount=/bin/umount ...
96

97
# 挂载前创建挂载点目录
98
# DirectoryMode=0755
99

100
# ---- 超时与重试 ----
101

102
# 挂载超时时间
103
TimeoutSec=30
104
# TimeoutSec=0                      # 0 表示无超时
105

106
# 挂载失败时的重试次数
107
# Retry=0
108

109
# ============================================
110
# [Install] 段：定义 Mount 如何安装到系统
111
# ============================================
112
[Install]
113

114
# 启用时链接到 local-fs.target（本地文件系统目标）
115
WantedBy=local-fs.target
116

117
# 网络文件系统应使用 remote-fs.target
118
# WantedBy=remote-fs.target
119

120
# 强依赖版本
121
# RequiredBy=local-fs.target
122

123
# 别名
124
# Alias=data.mount

1
# ============================================
2
# [Unit] 段：定义 Path 单元的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Path 单元的描述
6
Description=Monitor /var/lib/myapp for changes
7

8
# 文档链接
9
Documentation=man:systemd.path(5)
10

11
# ---- 依赖关系 ----
12

13
# 启动顺序：在这些 Unit 之后启动
14
After=basic.target
15

16
# 弱依赖
17
# Wants=
18

19
# 强依赖
20
# Requires=
21

22
# 冲突 Unit
23
Conflicts=shutdown.target
24

25
# ============================================
26
# [Path] 段：定义路径监控规则（核心配置）
27
# ============================================
28
[Path]
29

30
# ---- 监控路径类型（四种触发条件）----
31

32
# 1. 监控目录存在性：当指定目录存在时触发
33
PathExists=/var/lib/myapp/ready
34

35
# 2. 监控目录非空：当指定目录存在且非空时触发
36
# PathExistsGlob=/var/lib/myapp/uploads/*
37

38
# 3. 监控目录内容变化：当目录内文件被创建、修改、删除时触发
39
PathChanged=/var/lib/myapp/data/
40

41
# 4. 监控目录修改时间变化：当目录本身被修改（权限、时间戳等）时触发
42
# PathModified=/var/lib/myapp/config/
43

44
# ---- 触发关联配置 ----
45

46
# 要触发的 Unit（默认是同名的 .service）
47
# 例如：myapp-monitor.path 默认触发 myapp-monitor.service
48
Unit=myapp-processor.service
49

50
# 触发时传递给 Unit 的属性
51
# MakeDirectory=yes                 # 如果路径不存在，是否创建目录
52
# DirectoryMode=0755                # 创建目录时的权限
53

54
# ---- 触发行为配置 ----
55

56
# 是否触发一次后停止监控（默认 no，持续监控）
57
# TriggerLimitIntervalSec=0
58
# TriggerLimitBurst=0
59

60
# 触发间隔限制（防雪崩）
61
# TriggerLimitIntervalSec=2
62
# TriggerLimitBurst=200
63

64
# ============================================
65
# [Install] 段：定义 Path 单元如何安装到系统
66
# ============================================
67
[Install]
68

69
# 启用时链接到默认目标
70
WantedBy=multi-user.target
71

72
# 或者使用 paths.target（所有 path 单元的标准目标）
73
# WantedBy=paths.target