Docker容器默认使用动态IP分配机制，每次容器重建或重启后，IP地址可能发生变化。对于数据库、注册中心这类需要被其他服务稳定访问的组件来说，动态IP会带来很大的麻烦。本文将详细介绍如何为Docker容器配置固定IP地址，包括原理说明、完整操作步骤以及常见问题的解决方案。
一、为什么容器IP会变化：理解Docker默认网络
在讲解固定IP配置之前，需要先弄清楚Docker的默认网络行为。Docker安装完成后会自动创建三个网络，可以通过以下命令查看：
docker network ls
执行后会看到三个默认网络：bridge、host和none。其中容器默认连接的是bridge网络，也就是Docker在宿主机上创建的虚拟网桥docker0。Docker内置了一个内置DNS服务器之外的DHCP式分配逻辑：容器连接到网络时，Docker会按顺序从子网中分配一个未被占用的IP。
问题就出在这里：IP分配顺序取决于容器启动顺序。假设你有三个容器A、B、C，第一次启动顺序是A、B、C，分别获得.2、.3、.4三个地址。如果某天只启动了C和A，那么C可能拿到原本A的地址，A则拿到别的地址，服务间的连接配置就全部失效了。
另一个重要的点是，默认的bridge网络不支持为容器指定固定IP。如果直接执行docker run --ip命令并连接默认bridge网络，会报错提示user-defined networks才支持该参数。这就是为什么配置固定IP必须从创建自定义网络开始。
二、固定IP配置完整步骤
1. 创建自定义bridge网络并指定子网
使用docker network create命令创建一个用户自定义网络，关键是加上--subnet参数显式指定网段：
docker network create --driver bridge \ --subnet 172.20.0.0/16 \ --gateway 172.20.0.1 \ mynet
参数说明：--driver bridge指定网络驱动为bridge类型；--subnet定义整个网络的网段范围；--gateway设置网关地址，通常是网段的第一个地址。mynet是自定义的网络名称，可以按业务含义命名，比如app-net、db-net等。
如果不指定子网直接创建网络，Docker会自动从内部地址池中挑选一个空闲网段，这样虽然也能用，但不利于地址规划，尤其在多台宿主机的环境中建议显式指定。
2. 启动容器并指定固定IP
网络创建好之后，启动容器时通过--network指定自定义网络，再用--ip参数分配固定地址：
docker run -d \ --name mysql-server \ --network mynet \ --ip 172.20.0.10 \ -e MYSQL_ROOT_PASSWORD=yourpassword \ mysql:8.0
这样MySQL容器将永远使用172.20.0.10这个地址，无论重启多少次，只要网络和IP没有被其他容器占用，地址都不会改变。可以进入容器或使用以下命令验证：
docker inspect mysql-server --format '{{.NetworkSettings.Networks.mynet.IPAddress}}'3. docker-compose方式配置固定IP
实际生产中更多使用docker-compose管理容器，对应的写法如下：
version: "3.8"
services:
mysql:
image: mysql:8.0
container_name: mysql-server
environment:
MYSQL_ROOT_PASSWORD: yourpassword
networks:
mynet:
ipv4_address: 172.20.0.10
networks:
mynet:
driver: bridge
ipam:
config:
- subnet: 172.20.0.0/16
gateway: 172.20.0.1注意yaml文件中的缩进必须严格对齐，ipam部分就是用来定义子网和网关的。使用docker-compose up -d启动后，容器同样会获得指定的固定IP。这种方式的优点是配置即文档，整个网络的拓扑结构一目了然，便于团队协作和版本管理。
三、bridge模式与host模式的区别
很多初学者会混淆bridge和host两种网络模式下容器IP的含义。bridge模式下，容器拥有独立的网络命名空间，IP是Docker虚拟网络中的私有地址，宿主机之外无法直接访问，需要通过端口映射（-p参数）暴露服务。
host模式则完全不同，容器直接共享宿主机的网络栈，容器本身没有独立IP，所谓容器的地址就是宿主机地址。配置代码如下：
docker run -d --name nginx-host --network host nginx:latest
host模式下不存在固定IP的问题，因为容器就用宿主机IP，但端口冲突风险高，多个容器不能监听同一端口。如果你的诉求只是让外部稳定访问容器服务，其实更推荐的做法是端口映射加宿主机IP，或者使用容器名称互访。
值得一提的是，同一个自定义bridge网络内的容器可以通过容器名称互相访问，Docker内置了DNS解析功能。比如上面的例子中，其他容器可以直接用mysql-server这个名称连接数据库，这比硬编码IP更加灵活，也是官方推荐的容器间通信方式。固定IP更适合跨网络访问或与外部系统对接的场景。
四、常见问题与注意事项
1. 指定IP时报错地址不在子网范围内
报错信息通常是Pool overlaps with other one或invalid address。前者说明新网段与已有网络冲突，需要换一个子网，可以先用docker network ls和docker network inspect查看已占用的网段；后者是IP超出了子网范围，例如子网是172.20.0.0/24却分配了172.20.1.5，自然无法成功。
2. 网段与宿主机或公司内网冲突
如果自定义网段恰好与宿主机所在局域网网段相同（比如都是192.168.0.0/24），会导致路由混乱，容器无法访问外网。选择子网时建议避开常用的192.168.x.x和10.0.x.x段，优先使用172.16.0.0到172.31.0.0之间不常见的段。遇到冲突时删除网络重建即可：docker network rm mynet，注意删除前需要先停掉挂载的容器。
3. 容器之间无法通过固定IP互访
首先要确认双方容器是否在同一个自定义网络内。不同网络之间默认是隔离的，即使IP看起来在相邻网段也无法通信。解决办法是把容器同时加入多个网络，例如docker network connect mynet container-name，这样容器会获得该网络中的第二个IP。另外检查宿主机防火墙和iptables规则是否放行了Docker的转发链。
4. 生产环境使用建议
- 固定IP要做好地址规划表，避免多个容器争抢同一地址，IP被占用时容器会启动失败。
- 重要服务优先使用容器名称或服务别名做服务发现，固定IP作为兜底手段。
- 重启容器用
docker restart不会改变IP，但docker rm后重建必须重新指定--ip参数，建议把这些配置固化到docker-compose文件中。 - 大规模集群环境建议使用Kubernetes等编排工具管理网络，Docker原生固定IP方案更适合单机或小规模部署。
总结来说，Docker配置固定IP的核心思路就是三步：创建带子网的自定义网络、启动容器时指定IP、验证连通性。掌握bridge网络的工作原理后，无论是排查网络故障还是规划容器架构都会更加得心应手。
docker固定ipdocker网络配置自定义网络修改时间：2026-09-02 18:53:00