一、前提条件:确保服务器已配置IPv6
在配置Docker之前,必须确保宿主机(即你的服务器)已正确配置并启用了IPv6。如果你的云服务商提供了IPv6地址,但尚未配置,可以参考以下方法:
-
手动配置网络接口 :编辑网卡配置文件(如
/etc/sysconfig/network-scripts/ifcfg-eth0),添加以下参数:-
IPV6INIT=yes -
IPV6ADDR=你的IPv6地址/前缀长度(例如/96或/64) -
IPV6_DEFAULTGW=你的IPv6网关
-
-
配置IPv6 DNS :编辑
/etc/resolv.conf文件,添加公共IPv6 DNS服务器地址,例如阿里云的2400:3200:baba::1。 -
重启网络服务或服务器 使配置生效,并使用
ping6命令测试IPv6连通性。
二、在Docker引擎中全局启用IPv6支持
Docker默认不开启IPv6,需要在守护进程配置中手动启用。
-
编辑Docker配置文件 :创建或修改
/etc/docker/daemon.json文件。 -
添加IPv6配置:在配置文件中加入以下核心参数:
{ "ipv6": true, "fixed-cidr-v6": "2001:db8:1::/64" }-
"ipv6": true:全局启用IPv6。 -
"fixed-cidr-v6":为Docker容器分配IPv6地址的地址段。注意 :2001:db8::/64是文档中常用的测试地址段,在生产环境中应替换为你从服务商处获得的合法IPv6子网。你也可以使用其他私有地址段,如fd00::/80。 -
(可选)根据一些指南,还可以添加
"experimental": true和"ip6tables": true参数以启用实验性功能和IPv6防火墙规则管理。
-
-
重启Docker服务 :执行
sudo systemctl restart docker使配置生效。
三、在宝塔面板中为Docker容器配置IPv6
启用Docker引擎的IPv6后,需要在创建或管理容器时应用IPv6网络。根据宝塔面板论坛的解答,主要有两种方式:
-
在Docker全局设置中开启IPv6 :进入宝塔面板的Docker管理器,在"设置"中开启IPv6选项。"IPv6范围"可以填写,也可以留空,系统可能会使用
daemon.json中配置的地址段。 -
创建或使用支持IPv6的自定义网络:这是更推荐和灵活的方式。
-
通过命令行创建自定义IPv6网络:
docker network create --ipv6 --subnet 2001:db8:1::/64 my_ipv6_network -
在宝塔面板中创建网络 :在Docker管理器的"网络"页面,点击"创建网络",勾选"启用IPv6",并填写IPv6的子网和网关信息。关键提示:根据论坛解答,在纯IPv6服务器或需要独立IPv6配置时,可以只填写IPv6的子网和网关,上面的IPv4信息可以不用填写。
-
为容器指定网络 :在创建容器时,在"网络"设置中选择你创建的IPv6网络(如
my_ipv6_network),或者使用host网络模式(容器直接共享宿主机的网络栈,包括IPv6地址)。
-
四、为Docker容器内的网站服务配置IPv6监听
即使容器获得了IPv6地址,网站服务器软件(如Nginx)也需要配置监听IPv6请求。
-
进入容器或修改配置文件:通过宝塔面板的"容器"页面,找到对应网站服务的容器,进入终端(命令行),或者直接修改容器内挂载的网站配置文件。
-
配置Nginx监听IPv6 :编辑网站的Nginx配置文件,在
server块中,为监听端口添加IPv6配置:listen 80; listen [::]:80; # 添加此行以监听IPv6的80端口 # 如果启用了SSL/HTTPS listen 443 ssl; listen [::]:443 ssl; # 添加此行以监听IPv6的443端口添加
listen [::]:端口;这一行是关键,它告诉Nginx在IPv6地址上监听请求。
五、最终测试与外部访问
完成以上所有步骤后,进行最终验证:
-
测试容器内IPv6连通性 :进入容器命令行,使用
ping6 google.com或ping6 -c 4 2400:3200:baba::1测试外部IPv6连通性。 -
检查容器IPv6地址 :使用命令
docker inspect -f '{``{range .NetworkSettings.Networks}}{``{.GlobalIPv6Address}}{``{end}}' <容器名>查看容器获取到的具体IPv6地址。 -
配置域名解析 :要让外界通过域名访问你的网站,必须在你的域名DNS解析设置中,为域名添加 AAAA记录,指向你的服务器(或容器,如果使用独立地址)的IPv6地址。
-
访问测试 :在支持IPv6的网络环境中,使用域名或直接使用IPv6地址(格式如
http://[2409:8a00:xxxx:xxxx::1])访问你的网站。
总结 :在宝塔Docker中实现网站IPv6访问是一个系统工程,需依次确保宿主机IPv6就绪 -> Docker引擎启用IPv6 -> 容器接入IPv6网络 -> 网站服务监听IPv6端口 -> 域名正确解析。其中,创建独立的IPv6 Docker网络并正确配置Nginx监听是关键环节。