不能直接在默认 bridge 网络上设固定 ip,因为其不支持 --ip 参数,强行使用会报错;必须创建自定义 bridge 网络并指定子网,再通过 --network 与 --ip 配合分配静态 ip。

为什么不能直接在默认 bridge 网络上设固定 IP
因为 docker0 默认桥接网络不支持 --ip 参数,强行加会报错:Invalid container specified: bridge 或 could not find an available, non-overlapping IPv4 address pool。Docker 设计上只允许自定义 bridge 网络(或 macvlan)才能显式分配静态 IPv4 地址。
- 默认
bridge网络由 Docker 自动管理子网和 DHCP 分配,没有预留 IP 池供手动指定 -
--ip必须配合--network使用,且目标网络必须已通过--subnet显式定义 - 宿主机若未启用
net.ipv4.ip_forward=1,即使 IP 配置成功,容器也可能无法访问外网
创建带子网的自定义 bridge 网络
这一步是前提,漏掉就会在 run 时直接失败。子网 CIDR 必须足够大、不与宿主机现有网段冲突(比如避开 192.168.1.0/24 或 10.0.0.0/8)。
- 运行命令:
docker network create --driver bridge --subnet=172.30.0.0/16 --gateway=172.30.0.1 php-net -
--subnet是强制项,--gateway推荐指定,否则 Docker 会自动选一个(如172.30.0.1),但可能不可达 - 避免用
172.17.0.0/16(Docker 默认docker0的范围),防止路由混淆 - 创建后可用
docker network inspect php-net确认Subnet和Gateway字段是否符合预期
启动 PHP 容器并绑定固定 IP
PHP 容器本身不需要改任何配置——IP 是由 Docker 在网络命名空间初始化阶段注入的,PHP 应用层完全无感。
- 示例命令:
docker run -d --name php-app --network php-net --ip=172.30.10.5 -v $(pwd)/app:/var/www/html -p 8080:80 php:8.2-apache -
172.30.10.5必须落在172.30.0.0/16范围内,且不能是网关地址(如172.30.0.1)或广播地址 - 如果该 IP 已被占用,容器启动会卡住并报错:
address already in use - 多个 PHP 容器可共用同一网络,只要 IP 不重复,它们能直接用固定 IP 互访(例如
curl http://172.30.10.5/api)
验证与常见连通性问题
光看 docker inspect 显示 IP 并不等于网络就通了。很多故障出在网关或转发环节。
- 确认容器内 IP:
docker exec php-app hostname -I→ 应输出172.30.10.5 - 检查默认路由:
docker exec php-app ip route | grep default→ 应指向172.30.0.1 - 从容器 ping 网关:
docker exec php-app ping -c2 172.30.0.1,不通则查宿主机sysctl net.ipv4.ip_forward是否为 1 - 从宿主机 ping 容器:
ping 172.30.10.5,失败可能是防火墙拦截了桥接网卡(如br-xxxx)流量 - 容器访问外网失败?检查 Docker daemon 是否禁用了 iptables:
grep 'iptables' /etc/docker/daemon.json,若为false需设为true并重启 dockerd
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











