docker info无IPv6显示？检查daemon配置与网络驱动

Question

在Docker环境中执行 `docker info` 时未显示IPv6相关信息，通常表明IPv6支持未正确启用。该问题常见原因为：daemon.json 配置文件中未开启 `"ipv6": true`，或未配置 IPv6 子网（`"fixed-cidr-v6"`）；此外，若使用自定义网络驱动（如 bridge 或 macvlan），需确认其是否支持并正确配置了IPv6。同时，宿主机系统需启用IPv6协议栈且内核参数（如 `net.ipv6.conf.all.disable_ipv6`）设置为0。部分Linux发行版默认禁用IPv6，也会导致Docker无法识别。检查 Docker daemon 日志可进一步定位错误。确保重启Docker服务使配置生效。此问题直接影响容器IPv6通信能力，需综合排查配置、驱动与系统级支持。

Answer 1

深入解析Docker环境中IPv6支持缺失问题

1. 问题背景与现象描述

在现代云原生架构中，IPv6已成为支撑大规模容器化部署的关键网络协议。然而，在执行 docker info 命令时，若输出内容未包含 IPv6 相关字段（如 "IPv6"、"IPv6 CIDR" 等），则表明 Docker 守护进程未正确启用 IPv6 支持。

该现象直接影响容器间的 IPv6 通信能力，尤其在双栈网络环境或纯 IPv6 场景下将导致服务不可达。常见原因包括：daemon.json 配置缺失、宿主机系统级禁用、自定义网络驱动不兼容等。

2. 基础排查流程

1. 确认宿主机是否启用 IPv6 协议栈
2. 检查内核参数 net.ipv6.conf.all.disable_ipv6 是否为 0
3. 查看 /etc/docker/daemon.json 是否配置了 "ipv6": true
4. 验证是否设置了 "fixed-cidr-v6" 子网段
5. 重启 Docker 服务并重新运行 docker info

3. 核心配置详解

Docker 的 IPv6 功能依赖于 daemon.json 中的特定键值对。以下是一个典型支持 IPv6 的配置示例：

{
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:1::/64",
  "experimental": false,
  "ip-forward": true,
  "userland-proxy": false
}

其中：

• ipv6: true — 启用 IPv6 支持
• fixed-cidr-v6 — 指定全局 IPv6 子网，用于分配容器地址

4. 宿主机系统级支持验证

即使 Docker 配置正确，若操作系统层面禁用了 IPv6，仍无法生效。可通过如下命令检测：

sysctl net.ipv6.conf.all.disable_ipv6

期望输出为：

net.ipv6.conf.all.disable_ipv6 = 0

若值为 1，则需修改 /etc/sysctl.conf 或对应发行版的 sysctl.d 配置文件，并执行 sysctl -p 生效。

5. 自定义网络驱动的IPv6兼容性分析

网络驱动类型	是否支持IPv6	配置方式	注意事项
bridge	是（需显式启用）	使用 --ipv6 --subnet	必须指定 v6 CIDR
macvlan	是	创建时添加 IPv6 子网	需底层网络支持
ipvlan	是	同 macvlan	共享 MAC 地址
overlay	部分支持	需配合 swarm mode 和双栈配置	复杂场景建议测试
host	继承宿主	无需额外配置	取决于宿主机设置

6. 日志诊断与错误定位

当配置完成后仍未生效，应检查 Docker daemon 日志以获取详细错误信息：

journalctl -u docker.service --since "5 minutes ago"

关注关键词如：

• failed to enable IPv6
• invalid CIDR address
• address already in use

7. 流程图：IPv6启用排查路径

graph TD
            A[执行 docker info] --> B{显示IPv6信息?}
            B -- 否 --> C[检查 daemon.json 是否启用 ipv6]
            C --> D{已配置?}
            D -- 否 --> E[添加 ipv6:true 和 fixed-cidr-v6]
            D -- 是 --> F[检查宿主机 sysctl 参数]
            F --> G{disable_ipv6=0?}
            G -- 否 --> H[修改 sysctl 并 reload]
            G -- 是 --> I[检查自定义网络驱动]
            I --> J{驱动支持v6?}
            J -- 否 --> K[更换为 bridge/macvlan]
            J -- 是 --> L[重启 dockerd]
            L --> M[再次执行 docker info]
            M --> N[成功显示IPv6信息]

8. 实际案例：CentOS 7 默认禁用 IPv6 的处理

某些 Linux 发行版（如 CentOS 7/8）默认通过 grub 参数禁用 IPv6。此时需编辑 /etc/default/grub，移除或注释：

ipv6.disable=1

然后重新生成 grub 配置：

grub2-mkconfig -o /boot/grub2/grub.cfg

重启后验证 ip a | grep inet6 是否出现链路本地地址。

9. 高级调试技巧

对于生产环境中难以复现的问题，可结合以下手段进行深度分析：

• 使用 strace -f dockerd 跟踪系统调用，观察 IPv6 socket 创建过程
• 通过 tcpdump -i docker0 ip6 抓包验证流量是否生成
• 编写最小化测试用例：docker run --rm alpine ping6 google.com

10. 总结性扩展：未来趋势与最佳实践

随着 IETF 推动 IPv6-only 网络发展，Docker 及 Kubernetes 对双栈（Dual-Stack）的支持日趋完善。建议在新项目中优先设计双栈网络模型，避免后期迁移成本。同时，自动化配置管理工具（如 Ansible、Terraform）应纳入 IPv6 初始化检查清单。

此外，云服务商（AWS、GCP、Azure）均已提供 VPC 级 IPv6 支持，跨云部署时需统一规划 ULA（Unique Local Address）或 GUA（Global Unicast Address）策略。