systemd-tmpfiles --cat-config 怎么查看最终采用的配置片段

服务器上的 tmpfiles 规则明明写过，实际排查时却常常先陷入“到底读的是哪一个文件”。这类问题不要一上来执行 --create 或 --clean，先用 systemd-tmpfiles --cat-config 把参与计算的配置片段和文件名一起展开。它负责查看配置来源，不负责执行规则。

官方地址：https://www.freedesktop.org/software/systemd/man/latest/systemd-tmpfiles.html

先把 --cat-config 当成来源查看器

systemd-tmpfiles 的“查看”和“执行”是两件事。--cat-config、--tldr 属于输出配置的选项；--create、--clean、--remove 才会选择相应的文件操作。题目中的“最终采用”更准确地说，是把当前配置目录搜索结果中会被读取的文件片段按顺序展示出来，并不是提前执行一次规则得到某种文件系统快照。

# 只查看系统实例的配置片段，不执行创建、清理或删除
systemd-tmpfiles --cat-config --no-pager

# 只查看用户实例的配置片段，避免把两套配置混在一起
systemd-tmpfiles --user --cat-config --no-pager

--no-pager 只是避免输出被送进分页器，适合保存日志或交给 grep。输出中的文件名注释是排查的关键：先记住它来自哪个目录，再判断规则行是否覆盖了你关心的路径。

理解同名替换和不同文件名共存

系统实例通常会从多个 tmpfiles.d 目录读取配置。常见的层次可以理解为：发行版或软件包提供的 /usr/lib/tmpfiles.d/，本机安装的软件可使用的 /usr/local/lib/tmpfiles.d/，运行时配置所在的 /run/tmpfiles.d/，以及管理员配置所在的 /etc/tmpfiles.d/。具体可用目录仍以当前系统的 tmpfiles.d(5) 说明为准。

这里最容易混淆的是“优先级”与“合并”：

因此，看到某条规则“消失”时，第一反应不应是它没有安装，而是检查是否存在同名的高优先级片段。反过来，看到两条相似规则时，也不要直接认为后者覆盖前者；如果文件名不同，它们可能都被读入，最终还要结合规则类型和目标路径判断。

用完整输出定位一条规则的来源

一次完整查看适合建立全局认知，之后再用过滤缩小范围。下面的写法只读取并筛选文本，不改变文件系统：

# 保留文件名注释和规则正文，先定位所有 tmpfiles 相关路径
systemd-tmpfiles --cat-config --no-pager | grep -nE 'tmpfiles\\.d|/var/cache|/run/|/tmp/'

# 只查看某个片段名的高优先级匹配，参数是文件名而不是带斜杠的路径
systemd-tmpfiles --cat-config --no-pager systemd.conf

# 将完整配置保存为排查材料，便于和软件包升级前的记录对比
systemd-tmpfiles --cat-config --no-pager > /tmp/tmpfiles-effective.txt

第二条命令适合回答“这个名字最终匹配到了哪个片段”。如果你的问题是“所有来源中有哪些规则影响某个目录”，就不要过早传入文件名，先保留完整输出，再用路径或规则类型过滤。保存文件也只是重定向标准输出，不会让 tmpfiles 规则在目标目录上执行。

--tldr 适合速览，不适合第一次取证

--tldr 会跳过注释和空行，只输出配置里较有信息量的部分，并且仍会在片段前显示文件名。它适合快速回答“有哪些有效规则”，但不适合第一次判断一个片段为何生效：注释中可能包含软件包说明、禁用意图或维护者留下的上下文。

# 先用完整模式确认来源，再用 tldr 做规则速览
systemd-tmpfiles --cat-config --no-pager > /tmp/tmpfiles-full.txt
systemd-tmpfiles --tldr --no-pager > /tmp/tmpfiles-short.txt

# 对照同一目录路径，避免只凭精简结果猜测来源
paste /tmp/tmpfiles-full.txt /tmp/tmpfiles-short.txt | sed -n '1,80p'

如果精简结果中出现了目标路径，而完整结果看不到你预期的文件名，应优先检查过滤方式、用户/系统实例和文件名替换关系，而不是立即修改规则。

按三层顺序排查“配置不生效”

1. 先分实例：确认问题来自系统服务还是用户服务；前者使用系统配置，后者可能需要 --user。
2. 再看文件名：在完整输出的文件名注释中确认高优先级同名片段是否替代了供应商版本。
3. 最后看规则：检查类型字段、目标路径、时间参数和权限字段，区分“没有读到”和“读到了但语义不同”。

这个顺序能减少一个常见误区：把“查看到规则”当成“规则已经执行”。如果确实要让配置产生文件系统变化，那是另一个需要明确授权、选择执行动词并评估影响的操作；本文的 --cat-config 排查阶段不包含这些动作。

一张只读排查清单

常见问题

--cat-config 会创建或删除文件吗？

不会。它输出配置内容；创建、清理和删除分别由其他执行选项选择。把查看命令和执行命令分开，有助于在生产机上先完成来源排查。

为什么 grep 能找到规则，却找不到原来的软件包文件？

因为规则可能来自另一个目录中的同名片段，也可能来自不同文件名的额外片段。先看 --cat-config 在规则前打印的文件名和路径，再判断包管理器或本地配置的归属。

什么时候应该用 --tldr？

当你已经确认来源，只想快速浏览非空、非注释规则时使用。首次排查或需要理解配置意图时，保留完整的 --cat-config 输出更稳妥。

只传入一个文件名和直接传入完整路径有什么区别？

不带斜杠的文件名会按配置目录寻找匹配项并采用优先级最高的一份；直接传入路径则指定那个文件本身。需要判断“系统最终选了谁”时，优先使用文件名方式并记录输出的来源注释。

总结一下：systemd-tmpfiles --cat-config --no-pager 的价值在于把“规则内容”和“规则来源”同时摆到眼前。遇到配置不生效时，先分系统/用户实例，再查同名替换，最后分析规则语义；整个过程可以保持只读，避免把排查动作误变成系统变更。