必须配置"ipv6": true和"fixed-cidr-v6": "你的IPv6子网/前缀长度"两项，缺一不可；推荐添加"ip6tables": true和"experimental": true以提升稳定性与功能完整性。

要在 docker 中启用 ipv6，核心是正确配置 /etc/docker/daemon.json 文件。这个文件控制 docker 守护进程的行为，ipv6 支持必须在这里显式开启，且需搭配合法地址段和可选增强项。

必须配置的两项基础参数

以下两个字段是启用 IPv6 的最低要求，缺一不可：

• "ipv6": true —— 全局开启 Docker 对 IPv6 的支持；不加此项，所有后续 IPv6 设置均无效。
• "fixed-cidr-v6": "你的IPv6子网/前缀长度" —— 指定容器自动获取 IPv6 地址的范围。例如：
  "fixed-cidr-v6": "2607:f0d0:1002:51::/66"（来自你服务器公网 IPv6 地址段）
  或使用私有地址段：
  "fixed-cidr-v6": "fd00:db8:1::/64"

⚠️ 注意：fixed-cidr-v6 不是随便填的测试地址（如 2001:db8::/64），生产环境务必用你实际获得的、可路由的 IPv6 子网，否则容器无法对外通信。

推荐添加的实用增强项

这些选项不是强制，但能显著提升 IPv6 网络稳定性与可控性：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

• "ip6tables": true —— 启用 Docker 自动管理 IPv6 防火墙规则。若关闭，需手动配置 ip6tables 才能实现 NAT、端口转发或跨网络通信。
• "experimental": true —— 开启实验性功能，部分新版 IPv6 行为（如更细粒度的网络策略、docker network inspect 中的 IPv6 显示）依赖此开关。
• "default-gateway-v6": "指定网关地址" —— 可选。用于自定义容器默认 IPv6 网关（如 "fd00:db8:1::ffff"），避免使用默认的 ::1，便于调试和统一策略。

完整示例（生产可用）

假设你从服务商获得的公网 IPv6 段是 2607:f0d0:1002:51::/64，可划分出 /66 子网供 Docker 使用：

{
  "ipv6": true,
  "fixed-cidr-v6": "2607:f0d0:1002:51::/66",
  "ip6tables": true,
  "experimental": true,
  "default-gateway-v6": "2607:f0d0:1002:51::1"
}

保存后执行 sudo systemctl restart docker 生效。运行 ip -6 addr show docker0 应能看到该网段分配给桥接接口的地址。

常见错误提醒

• 配置后容器仍无 IPv6 地址？先确认宿主机已启用 IPv6（sysctl net.ipv6.conf.all.disable_ipv6 返回 0），且网卡有 global scope 的 IPv6 地址。
• 报错 invalid CIDR address？检查 fixed-cidr-v6 格式是否符合标准（如末尾不能漏掉 /64），且前缀长度合理（常用 /64、/66、/80）。
• Docker 重启失败？用 sudo dockerd --config-file /etc/docker/daemon.json --debug 测试配置语法，定位 JSON 错误或冲突参数。