Docker run指定自定义IPv6地址未生效如何基于现有配置解决

结论 #

无法基于你当前的Docker配置直接分配指定的IPv6地址，核心原因是你指定的IP不在Docker配置的预设IPv6子网范围内。

问题根因 #

你当前在daemon.json中配置的Docker IPv6地址段为2001:637:407:201:db03::/80，该子网的有效地址范围是2001:637:407:201:db03:: ~ 2001:637:407:201:db0f:ffff:ffff:ffff。而你尝试指定的IP2001:637:407:201:db00:cafe:5555/96属于2001:637:407:201:db00::/80段，完全不在Docker的允许分配地址池内，因此Docker会自动忽略该自定义IP参数，从默认地址池分配地址。

可行解决方案 #

方案1：修改全局Docker IPv6子网配置

如果需要自由分配你持有的2001:637:407:201:db00::/78段内的任意IP给容器，直接修改daemon.json中的fixed-cidr-v6参数为你的完整子网，修改后重启Docker daemon即可：

{
  "ipv6": true,
  "fixed-cidr-v6": "2001:637:407:201:db00::/78",
  "ip6tables": true,
  "experimental": true
}

修改完成后，你启动容器时指定该/78段内的任意IPv6地址都会生效。

方案2：新增独立自定义IPv6网络

如果你不想改动全局默认的Docker子网配置，可以单独创建一个绑定目标网段的自定义桥接网络，启动容器时指定该网络即可：

1. 创建包含目标IP段的自定义IPv6网络：

   docker network create --ipv6 --subnet 2001:637:407:201:db00::/96 custom-ipv6-net
   

2. 启动容器时指定该网络，再配置自定义IP：

   docker run -d --network custom-ipv6-net --ip6 2001:637:407:201:db00:cafe:5555 <image>
   

注意事项 #

• 两种方案都需要确保你配置的IPv6子网的路由已经正确指向宿主机的IPv6接口，否则容器即使分配到目标IP也无法正常进行公网通信。
• 如果你使用Docker Compose部署，逻辑和上述操作完全一致，只需要在Compose文件的网络配置段声明对应子网，在服务配置段指定固定ip6即可。

内容的提问来源于stack exchange，提问作者cdadhich