1. 概述
在使用 Docker 构建和管理微服务时，经常会遇到需要更改容器网络配置的场景。例如，当我们要重新组织基础设施、排查网络连接问题，或者希望调整容器间的通信方式时。但 Docker 的网络模型本身存在一些限制，使得这项操作并不像我们想象的那么灵活。
本文将介绍如何更改正在运行的 Docker 容器的网络配置。我们会先介绍常见的网络问题，接着通过示例演示正确的操作方法，并提供一些最佳实践建议。
2. 为什么 Docker 网络很重要？
Docker 容器虽然轻量且隔离，但它们仍然需要相互通信，或者与外部世界交互。Docker 提供了多种网络驱动来管理这种通信：
- bridge：默认网络模式，创建私有内部网络，适用于单主机上的独立容器
- host：容器共享主机的网络命名空间，失去网络隔离性
- overlay：用于 Docker Swarm 的多主机通信
- macvlan：为容器分配 MAC 地址，使其在网络中表现为物理设备
- none：完全禁用网络
启动容器时，可以通过 --network 指定其使用的网络。但如果我们遗漏了这一步，或者之后想修改网络，就需要了解 Docker 的网络限制。
3. 更改运行中容器网络的限制
默认情况下，未指定网络的容器会被分配到 bridge 网络。如果我们想将其移动到自定义网络，可以使用：
$ docker network connect my-custom-network <container-id>
但若容器使用了 host 网络模式，则会出现如下错误：
Error response from daemon: container sharing network namespace with another container or host cannot be connected to any other network
这是因为 host 模式下容器与主机共享网络命名空间，Docker 无法再为其添加其他网络，否则可能导致命名空间冲突。
4. 实战示例
4.1 使用 bridge 网络
我们先创建一个自定义桥接网络：
$ docker network create --driver bridge app-network
ae1ae3745a4e55c492ea335a46d8e90ebe63f016e0a47e7bb4f562639270bceb
然后运行一个没有指定网络的容器：
$ docker run -d --name web-server nginx
11beef3f1ce532670909f59258f99a745e16b8e4acaba4ee5c2ebdcf4a21e649
接下来，将其连接到新的自定义网络：
$ docker network connect app-network web-server
验证连接情况：
$ docker inspect web-server --format='{{json .NetworkSettings.Networks}}' | jq
{
"app-network": {
...
},
"bridge": {
...
}
}
可以看到，容器现在同时连接了 bridge 和 app-network。
4.2 使用 host 网络
运行一个使用 host 网络的容器：
$ docker run -d --name host-server --network host nginx
215b5a0b841f248ff080683ae1c14071371370019a735f140cdb711586213ae5
尝试将其连接到其他网络会失败：
$ docker network connect app-network host-server
Error response from daemon: container sharing network namespace with another container or host cannot be connected to any other network
4.3 解决方案
对于使用了 host 网络的容器，我们无法更改其网络配置。必须先停止并删除该容器，然后使用相同配置但不同网络重新创建。
例如，原容器的启动命令为：
$ docker run -d --name host-server --network host -e ENV=production nginx
我们可以这样重建：
$ docker stop host-server && docker rm host-server && docker run -d --name host-server --network app-network -e ENV=production nginx
host-server
host-server
150be709ed58e4a9b0bdf14cd9db10b89165a18146f7ff2dce7124f19ddc249f
这样就保留了环境变量、端口映射等设置，同时更换了网络。
4.4 从网络中断开连接
有时我们需要将容器从某个网络中移除。例如清理旧网络或调整连接配置：
$ docker network disconnect bridge web-server
再次验证：
$ docker inspect web-server --format='{{json .NetworkSettings.Networks}}' | jq
{
"app-network": {
...
}
}
✅ 注意：不能将容器从其最后一个网络断开，因为容器必须至少连接一个网络。
4.5 对端口映射和网络别名的影响
更改网络时，需要注意对端口映射和网络别名的影响：
- 端口映射（-p）：在 bridge 网络中有效，但在 host 模式下会被忽略，因为容器直接使用主机端口
- 网络别名（--network-alias）：仅在定义的网络中生效。若将容器连接到新网络并希望使用相同别名，需重新指定：
$ docker network connect --alias my-app app-network container-name
每次更改网络后，务必验证容器是否可访问并按预期运行。
5. 最佳实践
✅ 提前规划网络配置
使用 docker network ls 和 docker network inspect <network> 查看已有网络，避免重复或冲突。
❌ 避免滥用 host 模式
除非对性能有特殊要求，否则应避免使用 host 网络，因其缺乏隔离性且容易引发端口冲突。
✅ 使用自定义 bridge 网络实现容器间通信
同一自定义 bridge 网络中的容器可以通过容器名互相访问：
$ docker run --network app-network --name api-service my-api
$ docker run --network app-network --name web-app my-web
此时，web-app 可以通过 api-service 这个名字访问后端服务。
✅ 保存容器配置便于重建
重建容器前，可以先保存其配置：
$ docker inspect container-name > config.json
✅ 使用 Docker Compose 或 Kubernetes 管理网络
对于复杂项目，建议使用 Docker Compose 或 Kubernetes 进行网络的声明式管理，提升可维护性。
6. 总结
本文介绍了如何更改正在运行的 Docker 容器的网络配置。我们了解到：
- ✅ 可以通过
docker network connect为容器添加新网络 - ❌ 若容器使用了 host 网络，则无法更改网络配置
- ✅ 可以通过停止并重新创建容器的方式实现网络切换
- ✅ 更改网络时需注意端口映射和别名的更新
- ✅ 建议使用自定义 bridge 网络或编排工具管理容器网络
合理规划网络配置，有助于构建更灵活、稳定的容器化基础设施。