首页 > 文章 > linux

Linux tmpfiles.d 临时目录清理规则的部署

来源：17golang原创

时间：2026-10-28 13:37:22 223浏览收藏

Linux 上要让临时目录按保存时间自动清理，比较稳妥的做法是把规则写进独立的 tmpfiles.d 配置，再由 systemd-tmpfiles 负责创建和清理。最小可用规则可以是：

# 创建应用临时目录，并清理其中超过 7 天的内容
d /var/cache/acme-worker - - 7d -

# 让保留目录不参与递归清理
x /var/cache/acme-worker/keep - - - -

其中 d 表示创建目录并允许按年龄清理，7d 是清理年龄；x 则把指定路径及其内容从年龄清理中排除。规则写好后，用 systemd-tmpfiles --create 处理目录创建，用 --clean 处理按年龄清理。官方格式说明可复制保存为：

官方文档：https://www.freedesktop.org/software/systemd/man/latest/tmpfiles.d.html

先确定配置文件和删除范围

系统级规则通常放在 /etc/tmpfiles.d/，例如 /etc/tmpfiles.d/acme-worker.conf。把应用专属规则放在独立文件里，后续修改、回滚和排查都比直接改发行版自带文件清楚。/run/tmpfiles.d/ 适合运行时生成的配置，而 /usr/lib/tmpfiles.d/ 一般由软件包提供；管理员自己的覆盖规则优先放在 /etc/tmpfiles.d/。

先把范围收窄到一个目录，不要一开始就对 /tmp、/var 这类大路径写递归删除规则。年龄清理会依据文件系统时间戳判断是否过期；如果目标目录里有缓存、锁文件和仍被业务使用的临时文件，就应该先拆分目录，再分别设置 age。

tmpfiles.d 配置文件、字段、目标目录和排除规则的静态结构关系图 — 图1：配置来源、age 字段、目标目录与 x/X 排除项的关系示意图；这是原创静态结构图，不是截图或运行证据。

用 d 和 e 写出可读的清理规则

一行规则的常见字段顺序是：类型、路径、权限、用户、组、年龄、参数。对于只管理一个应用目录的场景，先使用最小字段，把暂时不需要改动的字段写成 -：

# d 会创建目录，并让目录内容参与年龄清理
d /var/cache/acme-worker 0750 acme acme 7d -

# e 只处理已经存在的目录，不负责创建目录
e /var/cache/acme-worker/spool - acme acme 2d -

d 适合“目录不存在也要建出来”的场景，e 适合“目录由服务或安装过程创建，这里只负责调整属性和清理内容”的场景。年龄字段可以使用 s、min、h、d、w 等单位，多个时间段可以相加；省略 age 或写成 - 就不会启用自动清理。

不要把 0 当成“关闭清理”。在 age 字段中，0 表示每次运行 --clean 都无条件清理符合该行的内容，只有确认目录内容可以随时丢弃时才使用。

用 x 和 X 保护保留内容

当一个临时目录中同时存在可删除缓存和必须保留的子目录时，使用排除规则把边界写清楚：

# 清理 acme-worker 下符合 age 的内容
d /var/cache/acme-worker - - 7d -

# x：递归跳过该路径及其下面的内容
x /var/cache/acme-worker/keep - - - -

# X：目录本身可以作为排除点，但不把它理解成通用递归清理规则
X /var/cache/acme-worker/marker - - - -

x 和 X 的差别要结合目录层级理解：x 用于递归排除路径，X 只排除匹配到的目录本身。路径中如果需要通配，先确认 glob 实际覆盖的范围，再把保留项单独放到更窄的目录下。排除规则不是权限控制，也不能替代应用对文件生命周期的管理。

分别执行创建和年龄清理

保存配置后，可以指定这一个文件执行创建，避免把本次变更和全机其它规则混在一起：

# 按指定配置创建目录并调整 d/e 行涉及的属性
sudo systemd-tmpfiles --create /etc/tmpfiles.d/acme-worker.conf

# 只按该文件中带 age 的规则执行清理
sudo systemd-tmpfiles --clean /etc/tmpfiles.d/acme-worker.conf

--create 关注目录、文件和属性的创建或调整，--clean 关注带年龄字段的清理；两者不是同一个动作。系统的 systemd-tmpfiles-clean.service 和对应 timer 会周期性执行系统清理，因此配置文件部署后，仍要确认目标目录是否会被系统实例读取，而不是只在用户实例中写了一份规则。

如果修改的是运行时可以安全应用的规则，可以重启清理服务让设置重新载入：

# 让清理服务重新读取可在运行中应用的设置
sudo systemctl restart systemd-tmpfiles-clean.service

不要把 --remove 和按年龄清理混为一谈。--remove 针对 D、R、r 等移除类型，和 d/e + age 的时间型清理职责不同。

规则不生效时看哪些证据

如果目录没有创建，先查配置文件是否位于正确的搜索目录、文件名是否以 .conf 结尾，再看每列是否对齐到类型、路径和 age。若目录创建了但旧文件没有清掉，重点检查该行是否真的有 age、文件时间戳是否超过阈值，以及是否被 x/X 排除。

# 先用 dry-run 查看将要发生的操作，不直接改变文件系统
sudo systemd-tmpfiles --clean --dry-run /etc/tmpfiles.d/acme-worker.conf

# 临时提高日志级别，观察配置解析和路径处理信息
sudo env SYSTEMD_LOG_LEVEL=debug systemd-tmpfiles --clean /etc/tmpfiles.d/acme-worker.conf

如果使用的 systemd 版本支持 --dry-run，优先把它作为部署前的检查入口。调试时把日志级别临时提升即可，不要把全局 debug 常驻到生产环境。对于仍然无法解释的情况，回到一条规则、一个目录、一个 age 的最小配置，逐项恢复其它字段。