首页/云/Docker 容器速查/自定义网络内指定静态 IP
本包目录(366 条)
基础命令50 条镜像与构建107 条
网络与存储52 条
Compose 编排55 条资源与安全50 条容器排障52 条

自定义网络内指定静态 IP

在划分了子网的网络内给容器指定固定地址:--ip 需落在网络子网内且未被占用,仅用户自定义网络支持。

Docker 容器速查云更新于 2026-10-12
用途容器固定 IP
前提网络创建时已声明 --subnet
语法--network 网络 --ip 地址

示例

示例
docker network create --subnet 172.30.0.0/24 app-net
docker run -d --network app-net --ip 172.30.0.10 --name db postgres:16-alpine
docker network inspect app-net --format '{{range .Containers}}{{.Name}} {{.IPv4Address}}{{"\n"}}{{end}}'
静态 IP 只在容器接入期间有效;容器删除重建后要再次指定,编排工具应由服务名解析替代固定 IP。

易错点

  • 默认 bridge 网络不支持 --ip,报 user specified IP address is supported only when connecting to networks with user configured subnets
  • 依赖固定 IP 的配置在容器重建后容易断链,能用名称解析就不要用 IP

数据来源与参考

  • Docker 官方文档:network connect 的 --ip 与用户自定义网络(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌