docker build 报 no space left on device,镜像容器和卷怎么清理才释放空间

先确认空间到底被什么占了

no spaCe left on device 不一定是宿主机根分区满了,Docker 自己的存储目录也可能单独挂在某个分区上。先用 df 看宿主机整体空间,再用 docker system df 看 Docker 自身占用。镜像、容器、卷、构建缓存四类分开统计,构建缓存往往是隐藏的大头,跑过几次多阶段构建就能堆出几十 GB。

df -h
docker system df
docker system df -v

清理已停止的容器和悬空镜像

docker ps -a 里 Exited 状态的容器还占着可写层,悬空镜像(dangling)是构建中途失败留下的中间层。这两类清掉通常能回收不少空间,而且不影响正在运行的服务。

docker container prune -f
docker image prune -f

image prune 默认只删悬空镜像,不会动带标签的。如果想连未被使用的带标签镜像一起删,加 -a 参数,但要确认没有容器在用,否则会被自动跳过。

构建缓存是最大的隐藏占用

docker build 每次都会缓存中间层,Dockerfile 改一行后面的层全部失效,旧层不会自动回收。BuildKit 的缓存更隐蔽,存在 buildx 的缓存区里。docker builder prune 能清掉所有构建缓存,包括 BuildKit 的,首次执行可能回收十几 GB。

docker builder prune -f
docker buildx prune -f

清理后下次构建会变慢,因为缓存没了。如果磁盘还够,优先只清 24 小时前的缓存,保留近期常用的层。

卷和匿名卷单独处理

docker volume prune 会删除所有未被容器挂载的卷,包括匿名卷。数据库容器删掉后留下的匿名卷最容易被忽略,里面可能还有数据,删之前先 docker volume inspect 确认路径,把要的数据备份出来。清理后重新跑容器时数据会重新初始化。

docker volume ls
docker volume inspect 卷名
docker volume prune -f

一键清理和日常预防

docker system prune -a --volumes 是最彻底的清理命令,会删掉未使用的镜像、容器、网络和卷。生产环境用之前先确认没有临时容器在跑。日常预防就是在 Dockerfile 里合并 RUN 层、用多阶段构建减小最终镜像体积,CI 环境定期跑 prune,别让缓存无限增长。

您可以还会对下面的文章感兴趣: