一、前提条件:确保服务器已配置IPv6

在配置Docker之前,必须确保宿主机(即你的服务器)已正确配置并启用了IPv6。如果你的云服务商提供了IPv6地址,但尚未配置,可以参考以下方法:

  1. 手动配置网络接口:编辑网卡配置文件(如 /etc/sysconfig/network-scripts/ifcfg-eth0),添加以下参数:

    • IPV6INIT=yes

    • IPV6ADDR=你的IPv6地址/前缀长度 (例如 /96 或 /64)

    • IPV6_DEFAULTGW=你的IPv6网关

  2. 配置IPv6 DNS:编辑 /etc/resolv.conf 文件,添加公共IPv6 DNS服务器地址,例如阿里云的 2400:3200:baba::1。

  3. 重启网络服务或服务器使配置生效,并使用 ping6 命令测试IPv6连通性。

二、在Docker引擎中全局启用IPv6支持

Docker默认不开启IPv6,需要在守护进程配置中手动启用。

  1. 编辑Docker配置文件:创建或修改 /etc/docker/daemon.json 文件。

  2. 添加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防火墙规则管理。

  3. 重启Docker服务:执行 sudo systemctl restart docker 使配置生效。

三、在宝塔面板中为Docker容器配置IPv6

启用Docker引擎的IPv6后,需要在创建或管理容器时应用IPv6网络。根据宝塔面板论坛的解答,主要有两种方式:

  1. 在Docker全局设置中开启IPv6:进入宝塔面板的Docker管理器,在“设置”中开启IPv6选项。“IPv6范围”可以填写,也可以留空,系统可能会使用 daemon.json 中配置的地址段。

  2. 创建或使用支持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请求。

  1. 进入容器或修改配置文件:通过宝塔面板的“容器”页面,找到对应网站服务的容器,进入终端(命令行),或者直接修改容器内挂载的网站配置文件。

  2. 配置Nginx监听IPv6:编辑网站的Nginx配置文件,在 server 块中,为监听端口添加IPv6配置:

    listen 80;
    listen [::]:80; # 添加此行以监听IPv6的80端口
    
    # 如果启用了SSL/HTTPS
    listen 443 ssl;
    listen [::]:443 ssl; # 添加此行以监听IPv6的443端口

    添加 listen [::]:端口; 这一行是关键,它告诉Nginx在IPv6地址上监听请求。

五、最终测试与外部访问

完成以上所有步骤后,进行最终验证:

  1. 测试容器内IPv6连通性:进入容器命令行,使用 ping6 google.com 或 ping6 -c 4 2400:3200:baba::1 测试外部IPv6连通性。

  2. 检查容器IPv6地址:使用命令 docker inspect -f '{{range .NetworkSettings.Networks}}{{.GlobalIPv6Address}}{{end}}' <容器名> 查看容器获取到的具体IPv6地址。

  3. 配置域名解析:要让外界通过域名访问你的网站,必须在你的域名DNS解析设置中,为域名添加 AAAA记录,指向你的服务器(或容器,如果使用独立地址)的IPv6地址。

  4. 访问测试:在支持IPv6的网络环境中,使用域名或直接使用IPv6地址(格式如 http://[2409:8a00:xxxx:xxxx::1])访问你的网站。

总结:在宝塔Docker中实现网站IPv6访问是一个系统工程,需依次确保宿主机IPv6就绪 -> Docker引擎启用IPv6 -> 容器接入IPv6网络 -> 网站服务监听IPv6端口 -> 域名正确解析。其中,创建独立的IPv6 Docker网络并正确配置Nginx监听是关键环节。

Logo

码道开发者社区,聚焦华为云码道 CodeArts 代码智能体,沉淀 Agent、Skill、鸿蒙开发实战内容,供开发者查阅资料、交流技术、分享工程实践

更多推荐