参考来源与致谢
- 引用来源:docker如何修改容器ip范围_docker_脚本之家
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
Docker 默认网桥通常占用一个私有网段,若与企业内网、VPN 或其它虚拟化平台网段重叠,会出现路由冲突、容器无法访问外部或跨主机通信异常。本文适用于以下情况:
- 容器网段与办公网、数据中心网段重叠,需要调整默认网桥地址。
- 需要为容器分配相对固定的 IP,便于内部访问与排障。
- 多台 Docker 主机之间需要容器跨主机互访。
不同 Docker 版本对 daemon 配置项、网络驱动与默认行为的支持存在差异,具体可用参数请以对应版本官方文档为准。
准备与风险 #
调整容器网段属于网络层变更,操作前必须完成以下准备:
- 确认当前 Docker 版本、存储驱动与网络驱动,记录现有容器、网络与端口映射关系。
- 在测试环境先行验证,确认新网段不与现有路由、防火墙、NAT 规则冲突。
- 备份 daemon 配置文件与相关网络配置,例如
/etc/docker/daemon.json。 - 准备回退方案:保留原配置文件副本,明确重启 Docker 的时间窗口。
风险提示:修改默认网桥网段或重启 Docker 守护进程,可能导致运行中容器短暂中断;若配置错误,可能造成容器网络不可用。生产环境请在维护窗口执行,并确认业务可容忍重启。
处理步骤 #
一、调整默认网桥网段 #
若仅需避开冲突网段,可在 daemon 配置中指定网桥 IP 与掩码。编辑 /etc/docker/daemon.json,加入类似内容:
{
"bip": "[网桥地址]/24"
}
其中 bip 用于指定默认网桥地址,掩码长度需结合内网规划确定。保存后重启 Docker 服务使配置生效。重启前请确认没有依赖该网段的关键业务正在运行。
二、使用自定义网络分配固定 IP #
若需要容器使用固定 IP,可创建自定义网络并指定子网:
docker network create --subnet=[自定义子网]/24 [网络名称]
启动容器时指定该网络与 IP:
docker run -d --net [网络名称] --ip [容器地址] --name [容器名称] [镜像名称]
说明:自定义网络的子网需为规划中的空闲网段;容器 IP 必须落在该子网内。使用自定义网络后,容器重启一般仍会保留网络配置,但具体行为与版本相关,建议以官方文档为准。
三、跨主机容器互访 #
多台 Docker 主机之间若需容器互访,除各自配置自定义网络外,还需在主机上添加路由规则,使对端容器网段可达。示例形式如下:
ip route add [对端容器网段]/24 via [对端主机地址] dev [出口网卡]
添加后可用 ip route 或 route 查看。删除规则可使用:
ip route del [对端容器网段]/24
注意:路由规则需在通信双方主机上分别配置,且应纳入配置管理,避免重启后丢失。
验证方法 #
- 在主机上查看网桥与路由:
ip addr、ip route。 - 查看容器网络信息:
docker network inspect [网络名称]。 - 进入容器确认地址:
docker exec -it [容器名称] /bin/sh,再执行ip addr或ifconfig。 - 连通性测试:从主机 ping 容器地址,从容器 ping 网关与对端容器地址。
- 检查端口映射与业务访问是否正常,确认无路由环路或冲突。
回退建议 #
- 恢复备份的 daemon 配置文件,重启 Docker 服务。
- 删除新建的自定义网络:
docker network rm [网络名称],注意需先停止使用该网络的容器。 - 删除新增路由规则:
ip route del [对端容器网段]/24。 - 若容器已按新网络启动,需重新按原网络配置启动,并核对端口映射与依赖关系。
常见问题 #
- 修改后容器无法上网:检查网段是否与内网冲突、NAT 与转发规则是否正常。
- 固定 IP 不生效:确认容器启动时指定了自定义网络,且 IP 在子网范围内。
- 跨主机不通:确认双方路由规则、防火墙策略与出口网卡是否正确。
- 重启后配置丢失:daemon 配置与路由规则应纳入配置管理或启动脚本。
- 参数含义不确定:请查阅对应 Docker 版本的官方文档,不要直接套用其它版本配置。
