Docker buildx du 怎样按构建器查看缓存占用和可回收空间
Docker Buildx 的缓存占用不能只看宿主机目录大小,先要确认查询对应的 builder。docker buildx du 默认查看当前选中的构建器,输出每条缓存记录的可回收标记、大小和最近访问时间;如果要看另一台 builder,使用 --builder 指定名称。整个过程是只读检查,不会执行 prune。
官方地址:https://docs.docker.com/reference/cli/docker/buildx/du/
最稳妥的顺序是:先确认 builder,再看总量和记录,最后用--filter、--format缩小范围。不要把du的检查命令误当成清理命令。
- 默认表格回答“缓存占了多少、哪些记录可回收”。
--builder用来避免查错构建器。--format只改变展示方式,--filter才改变检查范围。
1. 先确认要检查的 builder
Buildx 命令支持全局的 --builder 选择器。日常排查先列出 builder,确认当前使用项和需要检查的远程或专用构建器名称;如果没有特别指定,du 就读取当前选中的 builder。
# 说明:先查看可用 builder,确认当前选中项的名称和状态 docker buildx ls # 说明:只检查名为 team-builder 的 builder,不切换全局默认值 docker buildx du --builder team-builder
这里的关键不是先清理,而是固定检查对象。多 builder 环境中,如果省略 --builder,看到的占用可能来自另一个构建节点,后续判断就会失去上下文。

2. 先用默认表格看清缓存记录
不加其它选项时,docker buildx du 会展示当前 builder 的缓存记录,并在末尾汇总共享、私有、可回收和总占用。常见列可以这样读:
| 列或标记 | 阅读重点 |
|---|---|
| ID | 缓存记录标识;ID 后的星号表示记录可变。 |
| RECLAIMABLE | 判断记录是否可回收,不能只按 SIZE 排序就直接删除。 |
| SIZE | 该记录关联的占用大小;大小后的星号表示共享存储。 |
| LAST ACCESSED | 辅助判断记录的最近使用情况。 |
官方示例说明,ID 后的星号代表 mutable,大小后的星号代表 shared。共享记录被 prune 时,通常只是删除缓存元数据,实际存储层仍可能被镜像等资源使用;而 RECLAIMABLE=false 的记录即使使用 prune --all 也不会被删除。
# 说明:读取当前 builder 的完整缓存占用概览,不执行清理 docker buildx du # 说明:用 pretty 查看可变、共享、描述和最近使用等细节 docker buildx du --verbose
3. 用 filter 和 format 缩小排查范围
du --filter 沿用 Buildx prune 的筛选器语法,但在这里仍然只做查看。筛选器可以按最近使用时间、类型、描述、是否在用、是否共享等条件组合;多个 --filter 会同时生效。
# 说明:只查看最近 24 小时之外的记录,先评估旧缓存规模
docker buildx du --filter "until=24h"
# 说明:排除 exec.cachemount 类型,缩小普通缓存记录的查看范围
docker buildx du --filter "type!=exec.cachemount"
# 说明:只输出 ID 与大小,便于复制到后续报表或人工对照
docker buildx du --format "{{.ID}}: {{.Size}}"
# 说明:以换行 JSON 输出字段,便于脚本逐条读取
docker buildx du --format=json
模板支持 .ID、.Size、.Reclaimable、.Shared、.LastUsedAt 等字段。过滤决定“看哪些记录”,格式化决定“怎么展示这些记录”,两者不要混为一谈。

4. 根据结果判断是否需要进一步处理
看到较大的 SIZE 不等于它一定可以安全清理。先看 RECLAIMABLE、shared 标记和最近使用时间,再结合业务构建频率决定后续动作。若只是想确认空间来源,到这里就足够;不要为了验证查询结果而直接执行 prune。
| 现象 | 建议判断 |
|---|---|
| 总量很大,但可回收量很小 | 先检查是否有在用或共享记录,不要按总量盲删。 |
| 指定 builder 与默认结果差异明显 | 保留 --builder 参数,分别记录节点上下文。 |
| 输出太长 | 优先用 until、type 或 description 过滤,再用模板输出。 |
常见疑问
docker buildx du 会删除缓存吗?不会。它只读取选定 builder 的磁盘使用记录;删除动作属于 docker buildx prune,两者应当分开操作。
为什么同一条记录有两个星号含义?ID 后的星号表示 mutable,SIZE 后的星号表示 shared。前者说明记录可能继续变化,后者说明存储可能被其它资源共享。
什么时候应该使用 --format=json?当需要把每条记录交给脚本或报表处理时使用。它输出换行分隔的 JSON 记录,仍然是查询结果,不代表已经执行清理。
Postman 怎样为请求设置环境变量而不写死地址
- 上一篇
- Postman 怎样为请求设置环境变量而不写死地址
- 下一篇
- Audacity 怎样按 LUFS 目标统一录音响度
-
- 文章 · 软件教程 | 21分钟前 | Docker Compose docker compose ls Compose项目 容器运维 项目状态
- Docker Compose ls 怎样汇总多个项目的运行状态
- 398浏览 收藏
-
- 文章 · 软件教程 | 27分钟前 | 持续集成 · CI/CD Matrix Fail-Fast GitHub Actions continue-on-error 工作流排错
- GitHub Actions 怎样把矩阵失败保留为可诊断结果
- 431浏览 收藏
-
- 文章 · 软件教程 | 29分钟前 | VS Code 远程开发 Remote SSH SSH config 主机别名 Remote Explorer
- VS Code Remote SSH 怎样配置多台主机的连接别名
- 152浏览 收藏
-
- 文章 · 软件教程 | 29分钟前 | 持续集成 · CI/CD GitHub Actions GITHUB_OUTPUT job outputs needs 下游作业
- GitHub Actions job outputs 怎样把构建信息传给下游作业
- 100浏览 收藏
-
- 文章 · 软件教程 | 32分钟前 |
- Git submodule absorbgitdirs 怎样整理子模块的 Git 目录
- 166浏览 收藏
-
- 文章 · 软件教程 | 39分钟前 | 开发工具 · VS Code Debug launch.json Compound 多配置调试 同时启动
- VS Code Debug 怎样用 compound 同时启动多个配置
- 294浏览 收藏
-
- 文章 · 软件教程 | 41分钟前 | 软件教程 · VS Code Screencast Mode 快捷键提示 Only Keyboard Shortcuts Developer Toggle Screencast Mode
- VS Code 怎样在演示时显示快捷键提示
- 188浏览 收藏
-
- 文章 · 软件教程 | 42分钟前 |
- VS Code Tasks 怎样把问题匹配器绑定到构建任务
- 432浏览 收藏
-
- 文章 · 软件教程 | 17小时前 | 软件教程 · Blender Unit Scale 场景单位 物体缩放
- Blender 怎样调整场景单位比例而不直接缩放物体
- 308浏览 收藏
-
- 文章 · 软件教程 | 18小时前 | 软件教程 · Audacity Selection Toolbar 选区工具栏 时间显示格式 Start and End Start and Length
- Audacity 怎样切换选区工具栏的时间显示格式
- 201浏览 收藏
-
- 文章 · 软件教程 | 20小时前 |
- LibreOffice Calc 怎样清除手动定义的打印区域
- 417浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1115次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1104次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1276次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1218次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1066次使用
-
- Redis 过期键区分主动过期与访问时删除的实现方法
- 2026-09-19 324浏览
-
- Redis 对象空闲时间为什么不是键的剩余寿命
- 2026-10-31 177浏览
-
- Docker buildx 构建多平台镜像时如何查看目标架构
- 2026-09-15 373浏览
-
- Docker volume为有状态容器规划备份入口的实现方法
- 2026-09-19 329浏览
-
- Docker Build 怎么用缓存挂载加速依赖安装
- 2026-09-27 253浏览
