清理容器网络命名空间残留的关键是删除未被任何容器引用的自定义网络，应优先使用docker network prune -f或docker system prune -f，手动验证可用docker network inspect检查Containers字段是否为空，并通过docker-compose down等规范操作预防残留。
清理容器网络命名空间残留，关键在于识别并移除那些不再被任何容器引用的自定义网络。Docker 不会在容器停止或删除后自动回收其关联的网络资源，尤其当使用 docker network create 手动创建网络，或通过 docker-compose 定义自定义网络时，容易留下“孤儿网络”。
哪些网络属于残留？
残留网络通常具备以下特征：
- 没有容器连接（
docker network inspect <network>中Containers字段为空） - 不是默认的
bridge、host或none网络 - 未被任何运行中或已停止的容器显式指定为
--network - 在
docker network ls中显示为driver: bridge或overlay，但状态孤立
安全清理方法
推荐优先使用 Docker 内置的 prune 机制，它会自动扫描引用关系，只删真正无用的网络：
- 清理所有未使用的网络（不含默认网络）：
docker network prune -f - 配合系统级清理，一并处理容器、镜像、卷：
docker system prune -f - 如需强制清理含 dangling 网络（极少数场景），可加
--filter until=24h限定时间范围，避免误删刚停用的网络
手动排查与验证
若需确认某网络是否可删，执行以下步骤：
- 列出全部网络：
docker network ls - 检查目标网络连接情况：
docker network inspect my_custom_net | jq '.Containers'（需安装jq） - 查看该网络创建时间与最后使用时间（
CreatedAt和容器列表为空即为闲置） - 确认无服务依赖：检查
docker-compose.yml或编排脚本是否仍引用该网络名
预防后续残留
从源头减少网络垃圾：
- 使用
docker-compose down（而非仅stop）来释放网络资源 - CI/CD 脚本中，在部署新版本前执行
docker-compose down --volumes或至少down - 避免长期运行
docker run --network mynet后不清理；临时测试建议用默认bridge或加--rm - 对一次性任务容器，优先使用
--rm参数，连带网络连接也会在退出后自动解绑
网络残留本身不占用大量磁盘，但会积累内核网络命名空间对象、iptables 规则和桥接设备，长期不清理可能引发连接异常或 docker network create 失败。定期 prune 是轻量且可靠的选择。
