Linux 与服务器运维 / 知识点
systemd Unit 配置速查手册
[Service] 用户、目录与权限
RuntimeDirectory=<NAME> [...]由 systemd 在 /run 下创建并管理运行时目录。
RuntimeDirectory=
由 systemd 在 /run 下创建并管理运行时目录。
所属 Section
[Service]
语法
RuntimeDirectory=<NAME> [...]推荐示例
RuntimeDirectory=app关键边界
比 ExecStartPre 手工 mkdir/chown 更可靠。
StateDirectory=<NAME> [...]创建并管理持久状态目录。
StateDirectory=
创建并管理持久状态目录。
所属 Section
[Service]
语法
StateDirectory=<NAME> [...]推荐示例
StateDirectory=app关键边界
系统服务通常映射到 /var/lib/<NAME>。
CacheDirectory=<NAME> [...]创建并管理服务缓存目录。
CacheDirectory=
创建并管理服务缓存目录。
所属 Section
[Service]
语法
CacheDirectory=<NAME> [...]推荐示例
CacheDirectory=app关键边界
系统服务通常位于 /var/cache。
LogsDirectory=<NAME> [...]创建并管理服务专用日志目录。
LogsDirectory=
创建并管理服务专用日志目录。
所属 Section
[Service]
语法
LogsDirectory=<NAME> [...]推荐示例
LogsDirectory=app关键边界
应用能直接写 journald 时未必需要独立日志目录。
UMask=<OCTAL>设置服务创建文件的默认权限掩码。
UMask=
设置服务创建文件的默认权限掩码。
所属 Section
[Service]
语法
UMask=<OCTAL>推荐示例
UMask=0077关键边界
处理敏感文件的服务可显式收紧。
[Service] 安全加固与资源限制
NoNewPrivileges=yes|no禁止服务及子进程通过 exec 获取新的权限。
NoNewPrivileges=
禁止服务及子进程通过 exec 获取新的权限。
所属 Section
[Service]
语法
NoNewPrivileges=yes|no推荐示例
NoNewPrivileges=yes关键边界
通用低成本加固项之一。
PrivateTmp=yes|no给服务独立的 /tmp 与 /var/tmp 视图。
PrivateTmp=
给服务独立的 /tmp 与 /var/tmp 视图。
所属 Section
[Service]
语法
PrivateTmp=yes|no推荐示例
PrivateTmp=yes关键边界
服务若需要和其他进程通过 /tmp 共享文件会受影响。
ProtectSystem=no|yes|full|strict把系统文件树大范围设为只读。
ProtectSystem=
把系统文件树大范围设为只读。
所属 Section
[Service]
语法
ProtectSystem=no|yes|full|strict推荐示例
ProtectSystem=strict关键边界
strict 很强,需要配合 ReadWritePaths/StateDirectory 等开放写路径。
ProtectHome=no|yes|read-only|tmpfs限制服务访问 /home、/root、/run/user。
ProtectHome=
限制服务访问 /home、/root、/run/user。
所属 Section
[Service]
语法
ProtectHome=no|yes|read-only|tmpfs推荐示例
ProtectHome=true关键边界
不需要用户目录的后台服务建议开启。
PrivateDevices=yes|no限制服务看到和访问物理设备。
PrivateDevices=
限制服务看到和访问物理设备。
所属 Section
[Service]
语法
PrivateDevices=yes|no推荐示例
PrivateDevices=yes关键边界
需要 GPU、串口、块设备等服务不能盲开。
CapabilityBoundingSet=<CAPS>限制服务及子进程能够获得的 Linux capabilities。
CapabilityBoundingSet=
限制服务及子进程能够获得的 Linux capabilities。
所属 Section
[Service]
语法
CapabilityBoundingSet=<CAPS>推荐示例
CapabilityBoundingSet=CAP_NET_BIND_SERVICE关键边界
比 root 全权限更细粒度,但需要理解应用实际能力需求。
AmbientCapabilities=<CAPS>把特定 capability 传给非 root 服务。
AmbientCapabilities=
把特定 capability 传给非 root 服务。
所属 Section
[Service]
语法
AmbientCapabilities=<CAPS>推荐示例
AmbientCapabilities=CAP_NET_BIND_SERVICE关键边界
常用于非 root 绑定低端口;应配合 CapabilityBoundingSet 收紧。
ReadWritePaths=<PATH> [...]在文件系统保护下明确允许可写路径。
ReadWritePaths=
在文件系统保护下明确允许可写路径。
所属 Section
[Service]
语法
ReadWritePaths=<PATH> [...]推荐示例
ReadWritePaths=/srv/app/data关键边界
常与 ProtectSystem=strict 搭配。
MemoryMax=<SIZE>为 Unit cgroup 设置硬内存上限。
MemoryMax=
为 Unit cgroup 设置硬内存上限。
所属 Section
[Service]
语法
MemoryMax=<SIZE>推荐示例
MemoryMax=1G关键边界
达到限制后可能触发 cgroup OOM;不是 JVM/应用内部内存配置。
CPUQuota=<PERCENT>限制 Unit 可使用的 CPU 时间比例。
CPUQuota=
限制 Unit 可使用的 CPU 时间比例。
所属 Section
[Service]
语法
CPUQuota=<PERCENT>推荐示例
CPUQuota=200%关键边界
多核系统 200% 大致相当于最多使用两个 CPU 的时间。
TasksMax=<N>限制 Unit cgroup 中可创建的 task 数量。
TasksMax=
限制 Unit cgroup 中可创建的 task 数量。
所属 Section
[Service]
语法
TasksMax=<N>推荐示例
TasksMax=512关键边界
线程也计入 task;Java 等高线程服务不要设置过低。
[Install] 启用关系与模板实例
WantedBy=<TARGET> [...]systemctl enable 时,在目标 .wants/ 目录创建链接。
WantedBy=
systemctl enable 时,在目标 .wants/ 目录创建链接。
所属 Section
[Install]
语法
WantedBy=<TARGET> [...]推荐示例
WantedBy=multi-user.target关键边界
它属于安装/enable 语义,不是运行时 [Unit] Wants= 的直接写法。
RequiredBy=<TARGET> [...]enable 时建立 .requires/ 关系。
RequiredBy=
enable 时建立 .requires/ 关系。
所属 Section
[Install]
语法
RequiredBy=<TARGET> [...]推荐示例
RequiredBy=app.target关键边界
比 WantedBy 强,普通服务较少需要。
Alias=<UNIT_NAME> [...]enable 时创建额外 Unit 名称别名。
Alias=
enable 时创建额外 Unit 名称别名。
所属 Section
[Install]
语法
Alias=<UNIT_NAME> [...]推荐示例
Alias=web.service关键边界
别名受 Unit 类型/命名规则限制。
Also=<UNIT> [...]enable/disable 当前 Unit 时同时处理其他 Unit。
Also=
enable/disable 当前 Unit 时同时处理其他 Unit。
所属 Section
[Install]
语法
Also=<UNIT> [...]推荐示例
Also=app.socket关键边界
常用于需要成套启用的 units。