getfattr 怎样读取扩展属性并保留备份

如果一次迁移只复制了文件内容，却发现文件恢复后少了标签、下载来源或程序依赖的元数据，问题往往不在 cp 本身，而在扩展属性没有被单独处理。getfattr 用来读取 Linux 文件系统对象上的 extended attributes（xattr），它既能查看单个属性，也能输出一份交给 setfattr --restore 使用的备份。

官方地址：https://man7.org/linux/man-pages/man1/getfattr.1.html

最稳妥的做法是先用 getfattr -R -h --absolute-names -d -m - 生成属性转储，再把转储文件作为独立元数据备份保存。它不包含文件内容、权限、所有者或 ACL；恢复时还要保证目标路径存在，并准备好读取或写入相应命名空间的权限。

先分清 getfattr 读取的是什么

扩展属性是附着在文件或目录上的名称和值，例如 user.comment、security.selinux。它和常规的大小、时间、权限位不是一回事，也不等同于文件内容。xattr 的名称带命名空间前缀，命名空间会影响访问权限。

getfattr 默认只匹配 user. 命名空间。如果要做完整的属性备份，常见写法是 -m -，表示不使用默认的 ^user\. 过滤器。完整转储可能触碰受保护的 security.、trusted. 或 system. 属性，因此命令报权限错误并不一定是语法问题。

读取单个文件或目录的扩展属性

想查看文件上所有匹配的属性，用 -d（--dump）。下面的命令把匹配范围明确成全部命名空间，便于发现默认过滤器没有显示的属性。

# 读取目标文件的全部可见扩展属性
getfattr -d -m - -- /srv/app/config.yaml

# 只读取一个已知名称，适合确认某个业务标记
getfattr -n user.release -- /srv/app/config.yaml

# 用十六进制编码显示二进制值，避免把不可打印字节当成普通文本
getfattr -d -m - -e hex -- /srv/app/config.yaml

输出中的 # file: 行标识对象，后面的每一行是属性名和值。-e 只改变显示编码，不会改变磁盘上的属性。文本值适合人工阅读，二进制值更适合用 hex 或 base64 保存和传输。

递归读取时把符号链接边界说清楚

目录备份通常需要 -R（--recursive）。如果目录树里有符号链接，再决定是否要用 -h（--no-dereference）查看链接本身。对备份来说，-R -h 是更容易解释的组合：递归遍历目录，但不把符号链接替换成它指向的对象。

# 递归读取目录，并把符号链接当作链接对象处理
getfattr -R -h -d -m - -- /srv/app

# 只筛选用户命名空间，输出更短，适合日常排查
getfattr -R -h -d -m '^user\\.' -- /srv/app

-L 和 -P 只在递归场景下对符号链接遍历策略更有意义：-L 会走向链接到的目录，-P 则不递归进入这类目录。不要把它们和 -h 当成同一开关；前者影响目录遍历，后者强调检查链接本身。

把 getfattr 输出保存成可恢复的备份

属性备份的关键不只是“把屏幕输出重定向到文件”，还要保留恢复时需要的路径。使用 --absolute-names 可以避免 getfattr 默认去掉路径开头的斜杠，然后将 --dump 结果保存为独立文件。

# 保留绝对路径，生成可供 setfattr --restore 使用的属性转储
getfattr -R -h --absolute-names -d -m - -- /srv/app \
  > /var/backups/app.xattrs

# 同时保留一个仅包含用户属性的轻量备份，便于普通用户检查
getfattr -R -h --absolute-names -d -m '^user\\.' -- /srv/app \
  > /var/backups/app.user.xattrs

这里的备份文件只记录扩展属性，不会代替 tar、rsync 或文件系统快照。文件内容、权限位、所有者、ACL、硬链接关系和挂载信息要用各自的备份方案处理。

恢复前先确认三个条件

官方的 setfattr --restore=file 接受 getfattr 的 --dump 格式。恢复前，目标路径应已经存在，转储里的路径应与目标布局一致，执行者还要有写入对应命名空间的权限。

# 从 getfattr --dump 生成的文件恢复扩展属性
setfattr --restore=/var/backups/app.xattrs

# 需要从标准输入恢复时，短横线代表读取 stdin
cat /var/backups/app.user.xattrs | setfattr --restore=-

如果只想恢复普通用户可以管理的元数据，优先使用 user. 命名空间的转储。涉及 SELinux、文件能力或 trusted 属性时，应按系统安全策略使用具备权限的恢复流程；不能因为读取到了属性名，就推断当前用户一定可以写回。

常见误区与适用边界

还有一个容易忽略的边界：扩展属性是否可用、可写以及容量上限与具体文件系统和挂载方式有关。遇到跨机器迁移时，不要把一次成功读取当成所有目标文件系统都支持同样命名空间。

一组可复用的最小命令

# 读取：全部命名空间、递归、保留链接本身
getfattr -R -h -d -m - -- /srv/app

# 备份：保留绝对路径，输出到独立文件
getfattr -R -h --absolute-names -d -m - -- /srv/app \
  > /var/backups/app.xattrs

# 恢复：目标路径准备好后再写回扩展属性
setfattr --restore=/var/backups/app.xattrs

把这三条命令放进脚本前，建议先确定备份范围、是否包含受保护命名空间、符号链接策略和恢复路径。这样排查时能知道每一项属性从哪里来，也不会把一个小型元数据文件误当成完整灾备副本。

相关问题

getfattr 为什么默认看不到所有扩展属性？

默认匹配模式是 ^user\.，只覆盖 user 命名空间。用 -m - 才会请求所有名称匹配范围，但仍受当前用户和系统安全策略限制。

getfattr 的备份能恢复文件内容吗？

不能。它保存的是扩展属性名称和值，文件内容、权限、所有者和 ACL 需要单独的复制或备份工具处理。

为什么恢复前要使用 --absolute-names？

因为转储中的文件标识会参与恢复定位。保留绝对路径可以减少工作目录变化造成的歧义，但也意味着恢复前必须确认路径确实指向正确的目标。