首页/云/Docker 容器速查/内联缓存 BUILDKIT_INLINE_CACHE
镜像与构建107 条

内联缓存 BUILDKIT_INLINE_CACHE

把缓存元数据写进镜像本身:推送的镜像即缓存来源,后续构建用 --cache-from 指向同一镜像即可复用层。

Docker 容器速查云更新于 2026-10-12
用途镜像自带缓存元数据
语法--build-arg BUILDKIT_INLINE_CACHE=1 + --cache-from 镜像
对比相比独立缓存 tag 更省管理成本

示例

示例
docker buildx build \
  --build-arg BUILDKIT_INLINE_CACHE=1 \
  --cache-from registry.example.com/app/web:1.0 \
  --push -t registry.example.com/app/web:1.0 .
适合层结构简单、镜像本身就是主要缓存的场景;多阶段项目通常配合 registry 缓存更稳。

易错点

  • 内联缓存只包含镜像本身的层,中间阶段不可复用,构建提速有限
  • 忘记推送新镜像时缓存不会前进,CI 脚本确保推送步骤成功再下一步

数据来源与参考

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