docker network rm

描述

删除一个或多个用户自定义的 Docker 网络。

⚠️ 注意：只有未被任何容器使用的网络才能被删除。如果网络仍有容器连接（包括已停止的容器），Docker 会拒绝删除并报错。

内置网络（如 bridge、host、none）无法被删除。

用法

docker network rm NETWORK [NETWORK...]

你可以同时指定多个网络名称或 ID 进行批量删除。

别名

• docker network remove 是 docker network rm 的等效别名。

示例

1. 删除单个网络

$ docker network rm my_network
my_network

成功时，命令会回显被删除的网络名称。

2. 批量删除多个网络

$ docker network rm net1 net2 net3
net1
net2
net3

3. 结合 docker network ls -q 批量清理（谨慎使用！）

# 删除所有用户自定义且未使用的网络（等价于 prune）
$ docker network rm $(docker network ls --filter type=custom -q)

🔒 安全提示：如果某个网络正被容器使用，该命令会跳过它并报错，不会影响其他网络的删除。

常见错误与处理

❌ 错误：网络正在被容器使用

Error response from daemon: network my_network is in use by container abc123def456

✅ 解决方法：

1. 先断开容器连接：

   docker network disconnect my_network abc123def456

2. 或直接删除容器（如果不再需要）：

   docker rm abc123def456

3. 然后再删除网络。

❌ 错误：尝试删除内置网络

$ docker network rm bridge
Error response from daemon: bridge is a pre-defined network and cannot be removed

✅ 说明：bridge、host、none 是 Docker 内置网络，禁止删除。

与 docker network prune 的区别

命令	行为
docker network rm <name>	删除指定的一个或多个网络（必须未被使用）
docker network prune	自动删除所有未被使用的用户自定义网络

• 如果你知道要删哪个网络 → 用 rm

• 如果你想清理所有“悬空”网络 → 用 prune

验证是否删除成功

删除后可通过以下方式确认：

# 1. 检查列表中是否还存在
docker network ls --filter name=my_network

# 2. 尝试 inspect（应报错）
docker network inspect my_network

预期输出：无结果 或 Error: No such network: my_network