Linux systemd路径触发任务如何配置?Path单元、服务依赖与重复触发怎么验证
systemd 的路径触发由 .path 单元负责监视文件或目录,再通过 Unit= 启动对应的 .service 单元。首次部署时,建议把“待处理目录非空”作为触发条件,把服务设置为一次性任务,并让处理程序在一次运行中扫描并处理目录内的全部文件,这样既能验证路径触发,也能观察服务依赖和重复触发行为。

下面以 Debian、Ubuntu、Rocky Linux、AlmaLinux 等使用 systemd 作为 PID 1 的 Linux 系统为例,创建一个文件到达后自动处理的示例。示例目录为 /opt/path-trigger,服务账户为 pathtrigger,处理逻辑是把待处理文件移动到 processed 目录,并记录每次服务执行结果。
对于需要持续接收文件并由后台服务自动处理的业务,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,覆盖常规建站、数据库、接口服务及多任务运行场景,并配备SSD或NVMe存储、不同内存规格和多样带宽线路,为基于Linux systemd的文件处理、日志记录与批量任务部署提供服务器基础。
准备条件与触发方式选择
检查运行环境
需要使用 root 或具备 sudo 权限的账号执行安装和配置命令。先确认系统确实由 systemd 管理:
ps -p 1 -o pid,comm,args
systemd --version
command -v systemctl
预期结果中,PID 1 的进程名称通常为 systemd,并且可以看到 systemd 版本。例如:
PID COMMAND COMMAND
1 systemd /sbin/init
systemd 252 (252.22-1~deb12u1)
如果 PID 1 不是 systemd,systemctl enable 和 .path 单元不会按本文方式工作。容器、精简镜像或采用其他初始化系统的环境,需要先确认是否启用了 systemd。
选择 Path 单元的触发条件
常见路径指令及适用场景如下:
| 指令 | 触发含义 | 适用场景 |
|---|---|---|
PathChanged= | 监视路径发生修改,文件或目录元数据变化时触发 | 关注某个文件或目录本身的变化 |
PathModified= | 监视文件被写入 | 需要关注文件内容写入,但要注意写入过程可能产生多次事件 |
DirectoryNotEmpty= | 目录中存在至少一个目录项时触发 | 文件队列、上传目录、待处理目录 |
Unit= | 指定路径事件发生后启动的服务单元 | 将 .path 与目标 .service 关联 |
本例选择 DirectoryNotEmpty=,原因是文件队列的目标通常是“目录中出现待处理文件”。生产者应先把文件写入临时目录,写完后使用同一文件系统内的 mv 移入 inbox 目录,避免服务读到尚未写完的文件。
不要同时为同一个队列配置多个相近的路径条件,也不要让处理服务把结果写回被监视的 inbox 目录,否则容易产生额外的触发事件。
创建运行目录和服务账户
创建专用账户
如果系统中尚未存在 pathtrigger 用户和用户组,可以执行:
getent group pathtrigger >/dev/null || groupadd --system pathtrigger
getent passwd pathtrigger >/dev/null || useradd \
--system \
--gid pathtrigger \
--home-dir /nonexistent \
--shell /usr/sbin/nologin \
pathtrigger
如果同名账户已经存在,应先检查其 UID、主组和用途,不要直接修改已有业务账户的主组。也可以将下面配置中的 User= 和 Group= 换成已经准备好的专用账号。
检查账户:
id pathtrigger
getent passwd pathtrigger
创建目录并设置权限
本例使用以下目录:
staging:生产者写入临时文件的目录;inbox:文件写完后移入,作为 Path 单元监视目录;processed:服务处理完成后的文件目录;run.log:记录服务每次执行的结果。
执行:
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger/staging
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger/inbox
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger/processed
检查目录权限:
namei -l /opt/path-trigger/inbox
ls -ld /opt/path-trigger /opt/path-trigger/staging \
/opt/path-trigger/inbox /opt/path-trigger/processed
预期结果是这些目录存在,并且服务账户至少对 inbox 和 processed 具有读取、写入和移动文件所需的权限。
如果实际生产者不是 root 或 pathtrigger,不要直接将目录改为 0777。应根据生产者账户加入受控用户组,并单独验证该账户是否可以写入 staging、移动文件到 inbox。
创建一次性处理服务
编写处理脚本
先创建脚本目录:
install -d -o root -g root -m 0755 /usr/local/libexec
写入处理脚本:
cat >/usr/local/libexec/path-trigger-worker <<'EOF'
#!/usr/bin/env bash
set -Eeuo pipefail
inbox="/opt/path-trigger/inbox"
processed_dir="/opt/path-trigger/processed"
log_file="/opt/path-trigger/run.log"
processed_count=0
while IFS= read -r -d '' item; do
filename="${item##*/}"
mv -- "$item" "$processed_dir/$filename"
processed_count=$((processed_count + 1))
done < <(find "$inbox" -maxdepth 1 -type f -print0)
message="$(date --iso-8601=seconds) processed=${processed_count} invocation=${INVOCATION_ID:-unknown}"
printf '%s\n' "$message" | tee -a "$log_file"
EOF
chown root:root /usr/local/libexec/path-trigger-worker
chmod 0755 /usr/local/libexec/path-trigger-worker
脚本使用 find -print0 处理带空格的文件名,并在一次服务执行中扫描 inbox 内的普通文件。mv 成功后,文件才会从待处理目录消失。
检查脚本语法:
bash -n /usr/local/libexec/path-trigger-worker
没有输出表示 Bash 语法检查通过。此时可以先用服务账户检查目录访问权限,但不要在正式测试前手动执行脚本,否则会提前移动待处理文件:
runuser -u pathtrigger -- test -r /opt/path-trigger/inbox
runuser -u pathtrigger -- test -w /opt/path-trigger/inbox
runuser -u pathtrigger -- test -w /opt/path-trigger/processed
创建 Service 单元
写入 /etc/systemd/system/path-trigger.service:
[Unit]
Description=Process files from the path trigger inbox
After=local-fs.target
RequiresMountsFor=/opt/path-trigger
[Service]
Type=oneshot
User=pathtrigger
Group=pathtrigger
WorkingDirectory=/opt/path-trigger
ExecStart=/usr/local/libexec/path-trigger-worker
UMask=0027
NoNewPrivileges=yes
PrivateTmp=yes
这里有几个关键点:
Type=oneshot表示每次触发启动一个处理任务,任务完成后退出;- 不配置
RemainAfterExit=yes,否则服务完成后会保持active (exited),后续路径事件可能无法再次启动已经处于 active 状态的服务; User=和Group=限制处理程序权限,避免因文件处理逻辑被修改而直接以 root 身份运行;RequiresMountsFor=会为/opt/path-trigger所在的挂载点建立必要依赖,适合该目录位于独立数据盘或其他挂载文件系统的场景;- 服务不设置
[Install],因为它不是开机常驻服务,而是由.path单元按事件触发。
创建 Path 单元
写入 /etc/systemd/system/path-trigger.path:
[Unit]
Description=Watch the path trigger inbox
After=local-fs.target
RequiresMountsFor=/opt/path-trigger/inbox
[Path]
DirectoryNotEmpty=/opt/path-trigger/inbox
Unit=path-trigger.service
[Install]
WantedBy=multi-user.target
Unit=path-trigger.service 是路径事件和服务执行之间的关联。它表示当 inbox 满足 DirectoryNotEmpty= 条件时,systemd 尝试启动 path-trigger.service。
这里的 Unit= 不等同于 Requires=。它负责指定“触发哪个单元”,而不是表示 .path 和 .service 始终绑定运行。路径单元本身应该保持 active 并持续等待,服务单元则在触发后运行,成功完成后回到 inactive 状态。
校验单元文件
在重新加载 systemd 前先检查配置:
systemd-analyze verify \
/etc/systemd/system/path-trigger.service \
/etc/systemd/system/path-trigger.path
没有输出通常表示没有发现语法和依赖引用错误。若出现 Executable path is not absolute、User not found 或文件不存在等提示,应先修正对应路径、账户或权限。
加载配置并启动路径监视
重新加载并设置开机启动
执行:
systemctl daemon-reload
systemctl enable --now path-trigger.path
enable 会创建开机启动关系,--now 会立即启动路径单元。检查状态:
systemctl is-enabled path-trigger.path
systemctl is-active path-trigger.path
systemctl status path-trigger.path --no-pager
预期结果类似:
enabled
active
状态中的 active (waiting) 是正常结果,表示 Path 单元正在等待目录事件,并不是服务已经执行完成。
同时检查 systemd 解析到的关联关系:
systemctl show path-trigger.path \
-p FragmentPath \
-p Unit \
-p ActiveState \
-p SubState
systemctl cat path-trigger.path
systemctl cat path-trigger.service
预期可以看到:
Unit=path-trigger.service
ActiveState=active
SubState=waiting
如果启用前 inbox 中已经有文件,Path 单元启动后可能立即触发服务。首次部署前应确认该目录没有尚未决定是否处理的历史文件,否则历史文件可能被当成首次测试数据移动到 processed。
首次触发测试
使用临时目录和原子移动
不要直接把内容长时间写入 inbox 中的最终文件名。先写入 staging,完成后再移动到 inbox:

tag=$(date +%s)
tmp="/opt/path-trigger/staging/.single-${tag}.part"
target="/opt/path-trigger/inbox/single-${tag}.data"
printf 'first path trigger test: %s\n' "$tag" > "$tmp"
chmod 0644 "$tmp"
mv -- "$tmp" "$target"
staging 和 inbox 都位于 /opt/path-trigger 下,通常属于同一文件系统,因此 mv 可以在同一文件系统内完成原子重命名。执行移动时,inbox 从空变为非空,Path 单元应启动服务。
等待一两秒后检查服务:
systemctl status path-trigger.service --no-pager
journalctl -u path-trigger.service -n 20 --no-pager
成功的 oneshot 服务通常会显示 inactive (dead),这不是失败,而是任务已完成并退出。日志中应能看到类似内容:
2025-01-01T10:20:30+08:00 processed=1 invocation=...
检查文件是否已经移动:
find /opt/path-trigger/inbox -maxdepth 1 -type f -printf '%f\n'
find /opt/path-trigger/processed -maxdepth 1 -type f -printf '%f\n'
tail -n 5 /opt/path-trigger/run.log
预期结果:
inbox中不再有刚才的测试文件;processed中出现single-<时间戳>.data;run.log新增一行processed=1;systemctl status path-trigger.path仍为 active、waiting;path-trigger.service的结果为成功,而不是 failed。
也可以直接检查服务的最终结果:
systemctl show path-trigger.service \
-p Type \
-p User \
-p ActiveState \
-p SubState \
-p Result
预期关键字段为:
Type=oneshot
User=pathtrigger
ActiveState=inactive
SubState=dead
Result=success
验证服务依赖和重复触发
验证多个文件是否都能处理
批量创建三个文件,观察一次或多次触发是否都能处理完整:
tag=$(date +%s)
for i in 1 2 3; do
tmp="/opt/path-trigger/staging/.batch-${tag}-${i}.part"
target="/opt/path-trigger/inbox/batch-${tag}-${i}.data"
printf 'batch file %s-%s\n' "$tag" "$i" > "$tmp"
chmod 0644 "$tmp"
mv -- "$tmp" "$target"
done
等待任务结束:
for i in $(seq 1 20); do
if ! find /opt/path-trigger/inbox -maxdepth 1 -type f | grep -q .; then
break
fi
sleep 1
done
grep "batch-${tag}-" /opt/path-trigger/run.log || true
find /opt/path-trigger/processed -maxdepth 1 -type f \
-name "batch-${tag}-*" -printf '%f\n' | sort
预期在 processed 中看到三个文件,每个文件只出现一次。服务启动次数不一定固定为三次:如果三个文件在同一时间进入目录,systemd 可能合并触发请求,由一次服务执行处理三个文件;如果文件分批到达,则可能启动多次服务。验收重点应是“每个输入文件只被处理一次”,而不是强行要求每个文件对应一次服务进程。

验证单个文件是否产生重复服务执行
使用唯一文件名进行单次测试:
tag=$(date +%s)
start_time=$(date --iso-8601=seconds)
tmp="/opt/path-trigger/staging/.duplicate-${tag}.part"
target="/opt/path-trigger/inbox/duplicate-${tag}.data"
printf 'duplicate check: %s\n' "$tag" > "$tmp"
chmod 0644 "$tmp"
mv -- "$tmp" "$target"
sleep 2
journalctl -u path-trigger.service \
--since "$start_time" \
--no-pager \
-o cat
grep "duplicate-${tag}.data" /opt/path-trigger/run.log | wc -l
正常情况下,最后的计数为:
1
日志中可能出现一行:
processed=1 invocation=...
如果同一次测试中出现第二次服务启动,但第二次显示 processed=0,说明出现了额外的服务激活请求,不过文件本身没有被重复处理。这种情况需要进一步检查是否同时配置了 PathChanged=、PathModified= 或服务内部又修改了被监视目录。
如果同一个文件名在 run.log 中出现两次,应检查处理脚本是否把文件复制后又重新放回了 inbox,以及 processed 目录是否被其他程序清空或移动文件。
检查 .path 与 .service 的关系
执行:
systemctl show path-trigger.path \
-p Unit \
-p ActiveState \
-p SubState
systemctl show path-trigger.service \
-p Type \
-p User \
-p ActiveState \
-p SubState \
-p Result
systemd-analyze critical-chain path-trigger.path
判断方式如下:
.path为active、waiting:表示路径监视仍在工作;.service为inactive、dead且Result=success:表示一次性任务已成功完成;.service为failed:表示脚本、权限、目录或文件处理过程出现错误;.path为failed:表示路径表达式、被监视目录、挂载关系或单元配置存在问题。
不要因为服务在处理结束后显示 inactive 就重新执行 systemctl start path-trigger.service。对于事件驱动任务,这是正常生命周期。真正需要保持 active 的是 .path 单元。
常见异常处理
Path 单元 active,但服务没有运行
先确认 Unit= 是否指向正确的服务:
systemctl show path-trigger.path -p Unit
systemctl cat path-trigger.path
再检查目录是否真的出现了普通文件:
find /opt/path-trigger/inbox -maxdepth 1 -printf '%y %p\n'
如果生产者只写入了目录、软链接或隐藏的临时文件,需要确认这些文件是否符合处理脚本的 find -type f 条件。建议使用“临时目录写入,完成后移动到 inbox”的方式。
还可以手动重新生成一个唯一测试文件,并查看路径单元日志:
journalctl -u path-trigger.path -b --no-pager
服务启动后失败
查看服务状态和本次启动日志:
systemctl status path-trigger.service --no-pager
journalctl -u path-trigger.service -b -n 100 --no-pager
重点检查:
/usr/local/libexec/path-trigger-worker是否存在且可执行;pathtrigger是否可以读取inbox中的文件;pathtrigger是否可以写入processed和run.log;processed中是否已经存在同名文件;- 生产者是否创建了权限过严的文件,例如只有 root 可读的
0600文件。
可以使用以下命令检查路径上的每一级权限:
namei -l /opt/path-trigger/inbox
namei -l /opt/path-trigger/processed
ls -l /opt/path-trigger/inbox /opt/path-trigger/processed
如需手动复现,应使用专门的测试文件,并注意手动执行脚本也会移动文件:
runuser -u pathtrigger -- /usr/local/libexec/path-trigger-worker
重复触发过多
优先检查以下配置和行为:
- 是否同时使用了
DirectoryNotEmpty=、PathChanged=和PathModified=; - 是否将文件直接写入
inbox,导致文件每次写入都产生事件; - 处理服务是否会向被监视目录写入日志、临时文件或处理结果;
- Service 单元是否错误配置了
RemainAfterExit=yes; - 是否有其他程序重复复制或移动相同文件。
文件队列通常只保留:
[Path]
DirectoryNotEmpty=/opt/path-trigger/inbox
Unit=path-trigger.service
如果业务必须监视单个文件的写入,可以单独使用 PathChanged= 或 PathModified=,同时让生产者采用临时文件加原子重命名,避免把“文件尚未写完”误判成“文件已经可以处理”。
修改单元后没有生效
修改 /etc/systemd/system/path-trigger.path 或 .service 后,必须重新加载配置:
systemctl daemon-reload
systemctl restart path-trigger.path
如果只修改了处理脚本,不需要 daemon-reload,但新进程启动时才会读取脚本内容。修改服务运行账户、ExecStart 或路径条件后,建议同时执行:
systemd-analyze verify \
/etc/systemd/system/path-trigger.service \
/etc/systemd/system/path-trigger.path
systemctl restart path-trigger.path
部署结果检查
首次运行完成后,可以按以下项目验收:
systemd --version可正常返回,且 PID 1 为 systemd;path-trigger.path已通过systemctl enable设置为开机启动;systemctl is-active path-trigger.path返回active;- Path 单元状态为
waiting,正在持续监视目录; .path单元中的Unit=明确指向path-trigger.service;path-trigger.service使用专用账户运行,而不是 root;- 测试文件从
staging写完后移动到inbox,能够触发服务; - 处理后
inbox不再保留该文件,processed出现对应文件; run.log中每个测试文件只记录一次;- 服务成功完成后显示
inactive (dead)且Result=success; - 快速提交多个文件时,所有文件都能被处理,不要求每个文件必须启动一个独立服务进程;
- 未配置
RemainAfterExit=yes,也未把处理结果写回被监视目录; - 重启系统后,
path-trigger.path仍能自动进入 active 状态。
如果需要验证开机持久化,可以在业务允许的维护窗口执行重启。重启前应确认 inbox 中没有不允许自动处理的文件,并保存当前配置:
mkdir -p /root/path-trigger-config-backup
cp -a /etc/systemd/system/path-trigger.path \
/etc/systemd/system/path-trigger.service \
/root/path-trigger-config-backup/
回滚与停用
回滚前先明确影响范围:停止 Path 单元后,不会再接收新的路径触发;如果同时停止正在运行的 Service,当前文件处理可能被中断。inbox、processed 和 run.log 属于业务数据,回滚时不要直接删除。
先备份当前单元和处理脚本:
backup_dir="/root/path-trigger-rollback-$(date +%Y%m%d-%H%M%S)"
install -d -m 0700 "$backup_dir"
cp -a /etc/systemd/system/path-trigger.path "$backup_dir/"
cp -a /etc/systemd/system/path-trigger.service "$backup_dir/"
cp -a /usr/local/libexec/path-trigger-worker "$backup_dir/"
停止路径监视:
systemctl disable --now path-trigger.path
如果确认需要立即中断正在执行的任务,再执行:
systemctl stop path-trigger.service
将新增配置移出 systemd 搜索路径,而不是直接删除:
mv /etc/systemd/system/path-trigger.path \
"$backup_dir/path-trigger.path.disabled"
mv /etc/systemd/system/path-trigger.service \
"$backup_dir/path-trigger.service.disabled"
mv /usr/local/libexec/path-trigger-worker \
"$backup_dir/path-trigger-worker.disabled"
systemctl daemon-reload
systemctl reset-failed path-trigger.path path-trigger.service
完成后检查:
systemctl is-enabled path-trigger.path
systemctl is-active path-trigger.path
如果需要恢复,使用回滚目录中的原文件复制回对应路径,再重新加载并启动:
cp -a "$backup_dir/path-trigger.path.disabled" \
/etc/systemd/system/path-trigger.path
cp -a "$backup_dir/path-trigger.service.disabled" \
/etc/systemd/system/path-trigger.service
cp -a "$backup_dir/path-trigger-worker.disabled" \
/usr/local/libexec/path-trigger-worker
chmod 0755 /usr/local/libexec/path-trigger-worker
systemctl daemon-reload
systemctl enable --now path-trigger.path
恢复后,应重新执行一次唯一文件测试,并同时检查 Path 单元状态、Service 执行结果、处理目录和日志记录,确认回滚没有改变文件权限或触发关系。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5226.html



