Linux服务器上的Docker镜像越积越多,怎样清理而不影响现有容器?

发布人:A5数据发布时间:2026-11-11 10:45阅读量:51

服务器上的业务容器还在运行,镜像列表却随着发布和构建越来越长。要清理而不影响现有容器,关键不是按镜像名称或大小批量删除,而是先确认容器引用关系,再从悬空镜像开始清理:docker image prune 默认只处理没有标签、也没有容器引用的镜像,不会停止或删除容器。

如果空间主要被仍带标签的旧版本镜像占用,可以在核对部署和回滚需求后扩大清理范围;但“没有容器引用”不等于“以后不会用到”。尚未启动的下一版、准备回滚的上一版,以及只保存在本机的构建结果,都可能属于这一类。日常定时任务宜保守,扩大范围的删除留给有记录的人工操作。

现状与清理边界

先在实际运行容器的 Docker 守护进程上盘点。以下命令以具备 sudo 权限的 Linux 服务器为例;如果服务器使用远程 Docker context,须先确认当前命令连接的是目标主机,不能只凭终端所在机器判断。

sudo docker version --format '{{.Server.Version}}'
sudo docker info --format 'Daemon={{.Name}} Root={{.DockerRootDir}}'
sudo docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'
sudo docker system df -v
sudo docker image ls -a --filter dangling=true

docker ps -a 同时列出运行中和已停止的容器。已停止的容器也可能承担回滚、排障或临时恢复任务,不能因为它当前不提供服务就顺手删除。docker system df -v 则把镜像、容器、卷及构建缓存的占用分开显示;镜像明细中的 SHARED SIZE 是共享层,UNIQUE SIZE 才是该镜像独有的部分。把 docker image ls 每一行的 SIZE 相加,不能准确预测清理后能腾出多少磁盘空间。

现状与清理边界配图

再检查 Docker 数据所在文件系统,而不是只看根分区:

df -hT "$(sudo docker info --format '{{.DockerRootDir}}')"

若服务器采用单独的 containerd 镜像存储,还应核对其所在文件系统。不要因为某个目录看起来很大,就直接在 Docker 或 containerd 的数据目录内手工删除层文件;存储位置会随配置和镜像存储方式而变,绕开守护进程删除可能破坏元数据与运行环境。

清理前,把镜像按用途分成三组会更容易决策:

类别判断依据处理方式
当前容器使用的镜像运行中或已停止的容器仍有关联不作为本次清理目标
无标签、无容器引用的悬空镜像常见于重复构建、更新标签之后确认不需保留本地回滚版本后,优先清理
有标签、但无容器引用的镜像可能是预发布版本、备用版本或未启用服务核对部署清单和恢复来源后,逐项决定

这里有一条重要边界:docker image prune -a 会把范围扩展到所有没有容器引用的镜像,包括仍有仓库名和标签的镜像;它并不会依据“是否写在 Compose 文件里”自动保留镜像。带 until=168h 等时间过滤条件时,判断的是镜像创建时间,不是最后一次使用时间。(docs.docker.com)

现状与清理边界配图

日常操作:先清悬空镜像,再考虑自动化

首次处理时,避开正在发布或构建的时段。先核对部署配置与回滚来源:Compose 项目可在其配置文件所在目录执行 docker compose config --images,查看配置解析后引用的镜像名称;有多个配置文件、环境变量或 profile 时,使用与实际部署一致的参数。镜像列表只能说明配置“需要什么”,还应确认私有仓库、构建产物或离线归档能否重新提供这些版本。

对需要保留、但目前没有容器引用的本地镜像,先保存到独立于 Docker 数据盘且容量足够的备份位置。以下镜像名和路径仅作命令示例,执行时换成已核实的值:

sudo docker image inspect app:release-1 --format '{{.Id}}'
sudo docker image save -o /mnt/backup/app-release-1.tar app:release-1
ls -lh /mnt/backup/app-release-1.tar

记录镜像 ID,并确认归档文件已生成、备份位置可访问。docker image save 保存的是镜像及其层,不是数据库、命名卷或容器写入层的业务数据;这些数据仍按原有备份流程保护。若某个悬空镜像本身就是唯一的回滚版本,应先给它建立可识别的标签并保存,而不是把它纳入定时删除。

完成盘点后,先人工执行一次保守清理:

sudo docker image prune --filter 'until=168h'
sudo docker system df

命令会请求确认;此处不加 -a,只清理符合条件的悬空镜像。168h 是一周的示例保留窗口,应根据发布频率调整。如果当天刚构建出尚未部署的镜像,或团队需要更长的本地回退窗口,就暂缓清理或延长时间。删除前应已有镜像备份或可重建来源;prune 没有撤销按钮,恢复只能重新加载、拉取或构建镜像。(docs.docker.com)

确认人工执行及恢复路径都可用后,再将同一保守策略交给定时任务。下面的脚本使用 flock 防止重复运行;执行失败会以非零状态退出,清理前后输出 Docker 空间统计,供审计对照。写入脚本前,若目标路径已有文件,先备份原文件并由配置管理流程审核差异。

sudo tee /usr/local/sbin/docker-image-prune.sh >/dev/null <<'SH'
#!/bin/sh
set -eu
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
export PATH

exec 9>/run/lock/docker-image-prune.lock
if ! flock -n 9; then
    echo "$(date -Is) skipped: another cleanup is running"
    exit 0
fi

echo "$(date -Is) cleanup started"
docker info --format 'Daemon={{.Name}}' >/dev/null
docker system df
docker image prune --force --filter 'until=168h'
docker system df
echo "$(date -Is) cleanup completed"
SH

sudo chmod 0750 /usr/local/sbin/docker-image-prune.sh
sudo /usr/local/sbin/docker-image-prune.sh

脚本由 root 执行,仅针对该 root 环境连接的 Docker 守护进程;正式上线前,再用 sudo docker info 与人工盘点时的目标核对。--force 只取消交互确认,不会使删除变成可回滚操作。不要未经评审把脚本中的命令改成 docker system prune:后者还会删除已停止的容器、未使用的网络和构建缓存;添加 --volumes 又会扩大到卷。

服务器已有 cron 服务时,可在 /etc/cron.d/docker-image-prune 中设置每周本地时间周日 03:15 执行。先确认该时段不与发布、备份或批量构建重叠;若同名计划已存在,应修改原计划,而不是新增第二份。

15 3 * * 0 root /usr/local/sbin/docker-image-prune.sh >> /var/log/docker-image-prune.log 2>&1

日志应限制访问权限并纳入现有日志轮转,避免审计文件本身持续占用空间。脚本与计划文件纳入版本管理或配置管理时,同时记录保留窗口、执行主机、变更审批人和回退版本;不要把“能定时运行”当作已完成验收。

结果检查:容量与业务状态分别验收

清理结束后,同时核对删除记录、磁盘和容器状态:

sudo tail -n 50 /var/log/docker-image-prune.log
sudo docker system df -v
df -hT "$(sudo docker info --format '{{.DockerRootDir}}')"
sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'
sudo docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'

日志中应有开始与完成时间、镜像删除记录或“回收空间为零”的结果,且没有 Docker 连接错误。对照执行前清单,确认原有容器仍在、关键容器状态正常,再按业务已有的健康检查或应用探针验证服务。容器没有被删除,不代表应用探针一定通过;反过来,磁盘空间变化很小,也不代表清理失败,镜像可能共用大量层,或者空间主要消耗在卷、容器日志和构建缓存。

审计记录至少保留执行时间、目标守护进程、使用的过滤条件、删除结果、前后容量与验收结果。若监控对磁盘空闲量设有阈值,应以实际文件系统的 df 结果判断告警是否解除,而不是只看 Docker 输出的可回收估计值。

异常处理:按影响范围逐层排查

定时任务没有日志或没有运行记录时,先检查 cron 服务、计划文件格式、脚本执行权限和任务所在主机;手工以相同身份执行脚本。如果手工成功、定时失败,重点比较 cron 的环境与 Docker 连接目标,不要直接放宽文件权限。对 Docker 的访问本身具有较高权限,不能为了省去 sudo 随意把普通账号加入有权控制守护进程的用户组。

日志显示无法连接 Docker 时,先核对守护进程状态、context 和 docker info,此时不应继续尝试更激进的删除命令。日志显示清理成功却未释放预期空间时,回到 docker system df -v 分辨镜像、构建缓存和卷;如构建缓存占用较多,应单独评估其重建成本,再决定是否安排缓存维护,而非把缓存清理混入镜像定时任务。

若计划清理带标签的旧镜像,不要仅凭“超过 30 天”就自动使用 docker image prune -a --filter 'until=720h'。先逐项核对待保留的发布版本、未启动服务及离线恢复条件,备份不可重新获取的镜像,再在维护窗口人工执行。prune 的确认提示不会列出准确的待删除清单,负向标签过滤也不便可靠预览,因此它不适合作为未经审查的“按标签保护回滚版本”方案。更稳妥的做法是对已确认废弃的镜像逐个执行 docker image rm,并记录删除对象;该命令同样需要事前备份和事后验证。(docs.docker.com)

必要恢复与上线验收

如果误删的是未来部署才需要的镜像,而现有容器仍正常运行,先暂停下一次发布或重建,不要为验证镜像而重启业务容器。核对备份镜像的标签和原始 ID,再从已验证的归档恢复:

sudo docker image load -i /mnt/backup/app-release-1.tar
sudo docker image inspect app:release-1 --format '{{.Id}}'

若同名标签目前已指向其他版本,加载前应先核对并制定标签处理方式,避免把正在使用的发布标识改指向旧镜像。可从可信仓库重新拉取的镜像,也应使用已记录的版本或摘要核对内容;不要用含义可能变化的标签盲目替代原版本。镜像恢复只解决“本地缺少镜像”,不恢复数据库、卷或容器内尚未备份的变更。

如果是新部署因缺少镜像而失败,先恢复镜像并核对部署配置,再按原发布流程重试和检查健康状态;不要把镜像清理后的恢复动作简化为“重启所有容器”。如果新上线的只是定时策略而策略不合适,先停用对应 cron 计划,恢复备份的脚本或计划文件,确认不会再次执行,再处理已删除镜像。

正式启用定时清理前,逐项完成以下检查:

对于承载Docker容器、业务后台、数据库及构建任务的Linux服务器,A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,覆盖Xeon Gold、AMD EPYC及不同容量的SSD、NVMe存储配置,可为多容器并行运行、镜像缓存、版本归档和持续交付提供硬件基础;香港、美国等地还提供多IP、GPU及大容量存储方案,便于按业务部署规模组合服务器资源。

  • 已确认执行主机和 Docker 守护进程,保存清理前的容器、镜像与磁盘占用记录。
  • 已识别当前版本、待部署版本和回滚版本;无法重新获取的镜像已在独立存储完成备份。
  • 已手工运行一次保守脚本,核对删除日志、实际磁盘空间、关键容器状态和业务探针。
  • 已确认 cron 时间不与发布任务重叠,重复执行有锁保护,失败日志可见且会轮转。
  • 已记录停用定时任务、恢复脚本及重新加载镜像的方法,并指定验收负责人。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8754.html

相关推荐