背景
在多 Compose 栈并存的环境里，迁移完成后常见现象是：
- 业务容器已切换为 bind mount（宿主机目录持久化）
- 同时系统里仍残留若干 named volume / 匿名 volume
- 迁移过程中临时创建的“搬运容器”可能仍存在，从而导致旧卷仍被引用，无法判断是否可清理
目标是：先盘点，再确认引用关系，最后最小化删除，避免误删关键数据。
核心原则
1) 先确认“新数据落点”是否稳定
迁移成功的强信号通常是：关键服务容器的持久化目录全部使用 bind mount，且映射到统一的宿主机工作目录结构。
2) named volume 的风险等级更高
在多栈环境里，named volume 很可能承载关键数据，例如：
- 模型与 WebUI 数据（模型目录、向量库、内部数据库等）
- 管理面板数据（配置、用户、连接信息等）
- IM/协作系统数据库卷（如 MongoDB、PostgreSQL 等）
- 邮件系统（MySQL、邮件存储、反垃圾/索引等）
- 游戏服务日志卷（即使可删，也建议先确认用途再动）
结论：只有当卷确认“零引用”且业务已稳定使用 bind mount 时，才进入删除阶段。
盘点步骤
Step A：列出所有卷（建立资产清单）
docker volume ls
只列出“无引用候选”（只做名单，不删除）：
docker volume ls -qf dangling=true
Step B：列出所有容器（包含已停止）
docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'
目的：
- 找出迁移后遗留的临时容器
- 找出已停止但仍挂着卷的旧容器
- 分清“运行中业务容器”和“历史遗迹容器”
Step C：从容器侧确认挂载类型（关键确认）
对“目标业务容器”查看挂载：
docker inspect <container> --format '{{json .Mounts}}' | jq .
关注点：
Type: "bind"：说明数据落在宿主机目录（可控、可迁移、可备份）Type: "volume"：说明仍依赖 named volume（需要额外谨慎）
若目标业务容器已完全为 bind mount，说明迁移落点基本完成。
识别“迁移搬运容器”
迁移时常用方式是：
- 旧卷挂载到
/from - 新目录（bind）挂载到
/to - 通过一次性容器执行 copy / rsync
这类容器特征：
- 名称通常是随机生成（或临时命名）
- 只为搬运存在，迁移完成后应删除
- 其存在会导致旧卷看起来“仍在使用”
验证方式：列出某个卷当前被哪些容器引用（最重要的安全检查）：
docker ps -a --filter volume="<volume_name>" --format ' {{.Names}}\t{{.Status}}'
安全清理顺序
① 先删“迁移搬运容器”
前提：确认这些容器不再需要、并且目标业务已稳定运行。
docker rm -f <migrate_tmp_container_1> <migrate_tmp_container_2> ...
② 再做“卷引用归零”验证
对每个旧卷执行：
docker ps -a --filter volume="<volume_name>" --format ' {{.Names}}\t{{.Status}}'
判定规则：
- 输出为空：该卷当前无容器引用 → 进入可删除候选
- 输出非空：仍被容器引用 → 先处理引用容器，再评估
③ 最后删除确认无引用的旧卷
只对已确认无引用、且确认为迁移前遗留的数据卷执行删除：
docker volume rm <volume_name_1> <volume_name_2> ...
建议的“最低风险工作流”
- 先盘点：
docker volume ls+docker ps -a - 确认目标业务容器已 bind 化：
docker inspect <container> | jq .Mounts - 定位迁移搬运容器（from/to 模式，或停止状态的临时容器）
- 先删容器，再判卷：先容器、后卷
- 严格按“引用归零”判定删除：
docker ps -a --filter volume=...
常见误区
- 仅凭卷名长短/随机与否来判断可删（不可靠）
- 仅凭
dangling=true就立刻删除（在迁移场景仍需核对） - 忽略“停止容器也会引用卷”（导致误判卷仍在用）
附：可复用命令模板（批量检查）
批量检查多个卷的引用者：
for v in <volume1> <volume2> <volume3>; do
echo "=== $v ==="
docker ps -a --filter volume="$v" --format ' {{.Names}}\t{{.Status}}'
done