Btrfs Qgroups配额完全指南btrfs-progs子卷空间管理不超支【免费下载链接】btrfs-progsDevelopment of userspace BTRFS tools项目地址: https://gitcode.com/gh_mirrors/bt/btrfs-progs在 Btrfs 文件系统中Qgroups配额组qgroup是 btrfs-progs 提供的一套子卷空间管理工具让每个子卷或用户目录都能拥有分区级的空间上限同时保留按需调整的灵活性。本指南面向新手讲解 Btrfs Qgroups 配额的核心概念、开通步骤、限额设置与性能注意事项帮助你快速上手不超支的空间管理。上图展示了 Btrfs 底层 B-tree 的叶子节点布局结构定义见 kernel-shared/ctree.c配额统计正是建立在这些块级元数据之上。为什么需要 Btrfs Qgroups 配额传统 Unix 配额按用户限制文件总量对目录无能为力分区方案虽然能给每个目录限额但上限写死在分区里重装前无法调整。Btrfs 的子卷subvolume天生像一个个独立分区而 Qgroups 配额正好为它补上了软分区能力每个子卷自动获得一个 0 级 qgroup可随时设置或取消空间上限支持多级层级组的组一个上限可以同时管住整个用户目录和其中每个子卷快照共享的块只计一次不会快照一打用量翻倍超出限额后写入直接报Quota Exceeded从根上杜绝单一点吃满全盘。完整概念可参考项目文档 Documentation/ch-quota-intro.rst。2个关键数字rfer 与 excl理解 Qgroups 配额只需要看懂btrfs qgroup show输出的两列数字数字含义通俗理解rferreferenced引用量该 qgroup 内所有子卷够得着的空间删除这些子卷不一定能释放的空间exclexclusive独占量只有该 qgroup 内的子卷引用的空间删掉组内全部子卷后实际能释放的空间举例子卷 A 创建快照 B 后A 与 B 的 rfer 几乎相同共享块但 excl 都很小。之后任何一方新写入数据excl 才会增长。限额可以作用在 rfer 上默认也可以用-e只限制 excl。 快照、reflink 复制、去重都会制造共享块这正是 Qgroups 配额比传统配额更聪明的地方共享数据只在真正归属者身上记账。快速开通4步给Btrfs子卷设置空间上限假设文件系统挂载在/mnt/vault以下是从零开始的完整流程第 1 步启用配额btrfs quota enable /mnt/vault建议在写入数据之前启用已有的旧数据不计入初始统计。第 2 步创建子卷并查看 IDcd /mnt/vault btrfs subvolume create a btrfs subvolume create b btrfs subvolume list .输出会显示类似ID 261 ... path a、ID 262 ... path b。第 3 步创建父级 qgroup 并设置 10MiB 上限btrfs qgroup create 1/100 . btrfs qgroup limit 10M 1/100 .第 4 步把子卷的 0 级 qgroup 挂到父组下btrfs qgroup assign 0/261 1/100 . btrfs qgroup assign 0/262 1/100 .层级结构示意摘自官方文档--- |2/1| ← 顶层组管住所有子卷 / \ ---/ \--- |1/1| |1/2| ← 中间组如 /home / \ / \ |0/1| |0/2| |0/3| |0/4| ← 0 级自动对应各子卷现在向a或b写入超过 10MiB 的数据就会触发配额超限错误。常用命令速查查看、调整与清理命令作用btrfs quota status /mnt/vault查看配额是否启用、是否处于不一致状态btrfs qgroup show /mnt/vault列出所有 qgroup 的 rfer/exclbtrfs qgroup show -r /mnt/vault额外显示已设置的限额btrfs qgroup limit 10G 0/261 /mnt/vault直接给某个子卷设限btrfs qgroup limit none 0/261 /mnt/vault取消限制btrfs qgroup remove 0/261 1/100 /mnt/vault解除父子关系btrfs qgroup clear-stale /mnt/vault清理子卷已删除的过期 0 级 qgroupbtrfs quota disable /mnt/vault关闭配额两个实用技巧排序找大户btrfs qgroup show --sort-rfer /mnt/vault按引用量降序一眼定位空间占用最高的子卷用路径代替 ID很多子命令可以直接传子卷路径省去查 ID 的麻烦。命令实现分别位于 cmds/quota.c 与 cmds/qgroup.c帮助文本可用btrfs quota --help随时查看。配额重扫rescan数字不准时怎么办Qgroups 的关系一旦变动比如把子卷挪到另一个父组下旧的统计数字就可能与现状不符此时限额会暂时失效需要先做一次重扫btrfs quota rescan /mnt/vault # 启动重扫 btrfs quota rescan -w /mnt/vault # 启动并等待完成 btrfs quota rescan -s /mnt/vault # 查看进度重扫会重新遍历所有 extent 共享元数据大文件系统上可能需要较长时间。自 4.19 版起qgroup assign/remove默认会自动安排重扫--rescan默认开启批量操作时可加--no-rescan避免反复扫描最后统一重扫一次。轻量替代方案简单配额squota完整 qgroup 为了精确区分共享/独占每次事务提交都要做全局反引用统计——快照越多的场景下延迟越明显甚至可能卡住系统。如果追求轻量Btrfs 提供了squota简单配额mkfs.btrfs --featuressquota /dev/vdb # 格式化时启用 btrfs quota enable -s /mnt/vault # 或对已有文件系统启用squota 的记账规则是块归谁先分配就给谁所有统计都是局部操作性能开销小得多特别适合内容基本不可变的场景如容器镜像、只读快照。代价是看不到精确的共享/独占拆分。两种模式共用同一套 qgroups API 与层级模型官方对比示例见 Documentation/ch-quota-intro.rst 的 Simple quotas 一节。避坑指南3条官方提醒 ⚠️频繁创建/删除快照时慎用完整 qgroup 模式。官方文档 Documentation/btrfs-quota.rst 明确指出qgroup 模式不建议在还会频繁新建、删除快照或子卷的日常环境启用重操作可能造成明显卡顿。限额只在 qgroup 状态一致时生效。任何使统计不一致的操作之后务必执行btrfs quota rescan否则限额形同虚设。不要销毁子卷自身的 0 级 qgroup。0/子卷ID一旦被销毁该子卷的配额在重建之前都不会工作。总结场景推荐做法把/usr、/var等当分区用直接给各子卷的 0 级 qgroup 设限无需层级多用户服务器限制/home建 1 级组管总盘把各用户子卷挂入再逐户设更小的上限快照也算用户头上把用户子卷和它的快照挂进同一个用户组如1/UID大量快照/容器场景改用--featuressquota简单配额性能优先掌握 rfer/excl 两个数字、4 步开通流程和 rescan 机制Btrfs Qgroups 配额就不再是黑盒——空间花在哪、上限管没管住尽在掌握。【免费下载链接】btrfs-progsDevelopment of userspace BTRFS tools项目地址: https://gitcode.com/gh_mirrors/bt/btrfs-progs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考