首页/云/Docker 容器速查/docker network rm 删除与清理网络
网络与存储52 条

docker network rm 删除与清理网络

删除不再使用的自定义网络;有容器(含已停止容器)仍接入时删除会被拒绝,批量清理用 network prune。

Docker 容器速查云更新于 2026-10-13

删除不再使用的网络

docker network rm 按名字删除用户自定义网络,docker network prune 批量清理没有被任何容器使用的网络。删除会被拒绝的典型情况是仍有容器(包括已停止的容器)接入该网络——接入关系不随容器停止而解除。预置的 bridge、host、none 三类网络不能删除。清理网络要放在容器清理之后,顺序反了只会得到一串报错。

基本信息

单个删除docker network rm 网络名(可一次多个)
批量清理docker network prune,可加 --filter until=24h
拒绝条件仍有容器接入,含已停止的容器
预置网络bridge / host / none 不可删除

典型使用场景

  • 项目下线后收尾:容器删完再删网络,避免端口与网段长期被占
  • 排障后清理临时网络:验证用的网络留在机器上会干扰后续排查
  • IP 段冲突处理:自定义网络的子网与内网规划冲突时需要重建
  • 定期盘点:用 prune 清掉无人使用的网络,让 network ls 保持可读
  • 迁移前的环境整理:换编排方式前把手写网络的残留清理干净

删除与清理

删除与清理
# 先看有哪些网络在用
docker network ls
docker network inspect app-net --format '{{range .Containers}}{{.Name}} {{end}}'

# 删除指定网络
docker network rm app-net

# 批量清理未被使用的网络(含已停止容器占用的不会删)
docker network prune

# 按时间过滤批量清理
docker network prune -f --filter 'until=24h'

rm 与 prune 对照

维度network rmnetwork prune
作用范围指定的一个或多个网络所有未被容器使用的网络
误删风险低,按名字精确删除较高,范围是全集
失败场景有容器接入时被拒绝预置与在用网络自动跳过
常用参数一次传多个网络名-f 跳过确认,可加时间过滤
删除网络不会删除容器,但容器会脱离该网络的连通关系;重建网络后容器需要重新加入,静态 IP 一类配置要一并补上。
prune 不会动正在被任何容器使用的网络,所以它相对安全;真正需要警惕的是删错了后续重建时子网与网段被其他项目占用。

易错点

  • 删网络前不查接入关系:容器(含已停止)仍在网络上时删除会被拒绝,先 docker ps -a 确认
  • 用 prune 清理共享网络:其它项目正在用的网络虽然不会被删,但依赖名字重新加入的脚本会失效
  • 把删网络当删数据:网络本身不存数据,真正要确认的是接入容器的存亡与后续重建计划
  • 批量清理时盲加 -f:跳过确认后没有二次机会,重要环境先列出候选网络再执行

数据来源与参考

  • Docker 官方 CLI 参考:docker network rm / prune(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌