首页/云/Docker 容器速查/构建缓存导出导入(registry 缓存)
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

构建缓存导出导入(registry 缓存)

把构建缓存推送到镜像仓库并在后续构建拉取,实现跨机器(CI)缓存复用;配合 buildx 使用。

Docker 容器速查云更新于 2026-10-12
用途跨机器共享构建缓存
语法--cache-to type=registry,ref=...,mode=max / --cache-from type=registry,ref=...
modemin 仅最终层 / max 含中间阶段

示例

示例
docker buildx build \
  --cache-from type=registry,ref=registry.example.com/app/web:buildcache \
  --cache-to type=registry,ref=registry.example.com/app/web:buildcache,mode=max \
  --push -t registry.example.com/app/web:1.0 .
第一次构建生成缓存,之后 CI 每次先拉缓存再增量构建;缓存 tag 与发布镜像分开命名更清晰。

易错点

  • mode=max 会把所有中间层也推上去,仓库流量与存储成本上升,按需选择
  • 缓存按内容寻址自动失效,但依赖外部网络拉取的步骤失败会把空缓存推上去,观察缓存体积变化

数据来源与参考

  • Docker 官方文档:Cache storage backends(docs.docker.com/build/cache/backends)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌