docker volume prune 是清理未被任何容器引用的持久化卷最直接、安全的方式；它只删除未被挂载且非匿名卷目标的本地卷，需先清理停止容器、检查--rm残留及应用依赖，再结合 dangling 过滤与标签保护定期执行。

docker volume prune 是清理未被任何容器引用的持久化卷最直接、安全的方式。它不会误删正在使用的卷，但需要理解它的行为边界和执行前提，才能真正“定期”且“可靠”地释放磁盘空间。

明确 prune 的清理范围

该命令只删除满足两个条件的本地卷：未被任何容器声明挂载（无论运行中或已停止），且不是匿名卷的挂载目标（匿名卷不在此列）。注意：它不看卷里有没有数据、创建多久、有没有标签，只看“是否被容器 --volume 或 --mount 引用过”。

执行前必须做的三件事

• 清空已停止但未删除的容器：运行 docker ps -a，对不再需要的容器执行 docker rm <container-id>。否则它们仍算“引用了卷”，prune 就跳过
• 确认没有 --rm 容器残留命名卷：用 docker run --rm -v myvol:/data ... 启动的容器退出后，myvol 依然存在，且会被 prune 当作“无主卷”删掉——如果你还想保留，就得提前打上保护标签或改用绑定挂载
• 检查关键应用是否依赖命名卷：比如 PostgreSQL 官方镜像若显式指定了 -v pgdata:/var/lib/postgresql/data，这个 pgdata 卷一旦被 prune 删除，数据库就不可恢复

日常定期清理的推荐方式

不建议裸用 docker volume prune -f 加进 crontab，容易在无人值守时误删。更稳妥的做法是：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

• 先用 docker volume ls -f dangling=true 查出纯悬空卷（随机名、无标签、无引用），这类基本可安全清理
• 结合时间筛选：运行 docker volume ls --format '{{.Name}} {{.CreatedAt}}' | sort -k2，人工识别三个月以上未更新的卷，再单独确认
• 给生产相关卷加保护标签，例如 docker volume create --label protected=prod db-data，后续可用脚本过滤掉带该标签的卷，避免被批量操作波及

自动化脚本示例（测试环境可用）

以下命令组合可作为定时任务基础（请先在测试机验证）：

#!/bin/bash
# 清理前先输出将被删的卷名，便于审计
echo "=== Volumes to be pruned ==="
docker volume ls -q --filter dangling=true
<h1>确认无关键容器残留</h1><p>if ! docker ps -a --filter volume=$(docker volume ls -q --filter dangling=true | head -n1) | grep -q '^$'; then
echo "Warning: dangling volume may still be referenced. Abort."
exit 1
fi</p><h1>执行清理</h1><p>docker volume prune -f

不复杂但容易忽略