Docker引擎IPv6网络配置完全指南

Docker引擎IPv6网络配置完全指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

随着IPv6在全球范围内的普及，越来越多的应用需要支持IPv6协议。Docker作为主流的容器化技术，自然也提供了完整的IPv6支持方案。本文将详细介绍如何在Docker引擎中配置和使用IPv6网络，包括创建IPv6网络、配置默认桥接网络以及动态地址分配等核心功能。

基础概念

在开始配置前，我们需要了解几个关键概念：

1. IPv6地址格式：IPv6地址由8组16进制数组成，每组4位，例如2001:db8::1
2. 子网前缀：IPv6使用CIDR表示法，如/64表示前64位是网络前缀
3. ULA地址：唯一本地地址(Unique Local Address)，相当于IPv4的私有地址范围

创建IPv6网络

通过命令行创建

创建基本的IPv6网络：

docker network create --ipv6 ip6net

创建时指定IPv6子网：

docker network create --ipv6 --subnet 2001:db8::/64 ip6net

通过Docker Compose创建

在docker-compose.yml文件中配置：

networks:
  ip6net:
    enable_ipv6: true
    ipam:
      config:
        - subnet: 2001:db8::/64

验证IPv6网络

运行测试容器并验证：

docker run --rm --network ip6net -p 80:80 traefik/whoami

使用curl测试IPv6连接：

curl http://[::1]:80

配置默认桥接网络的IPv6支持

默认桥接网络是Docker安装后自动创建的网络，要为其启用IPv6支持：

1. 编辑Docker守护进程配置文件/etc/docker/daemon.json：

{
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:1::/64"
}

2. 重启Docker服务使配置生效：

sudo systemctl restart docker

3. 运行测试容器：

docker run --rm -p 80:80 traefik/whoami

4. 验证IPv6连接：

curl http://[::1]:80

动态IPv6子网分配机制

当创建用户自定义网络时，如果没有显式指定子网，Docker会使用默认地址池进行动态分配。

默认行为

如果未配置IPv6地址池，Docker会使用ULA地址范围自动分配/64子网。这些子网包含：

• 40位的全局ID（基于Docker引擎随机生成的ID）
• 确保子网的高概率唯一性

自定义地址池配置

要使用自定义IPv6地址池，需要修改default-address-pools配置：

{
  "default-address-pools": [
    {"base": "172.17.0.0/16", "size": 16},
    {"base": "2001:db8::/56", "size": 64}
  ]
}

配置说明：

• base：地址池的基础网络
• size：分配给每个网络的子网大小
• 示例中2001:db8::/56可提供256个/64子网

注意：2001:db8::是文档专用地址，实际使用时请替换为有效的IPv6网络地址。

特殊场景：Docker in Docker

在使用旧版iptables(xtables)而非nftables的主机上，需要注意：

1. 内核模块ip6_tables必须在创建IPv6网络前加载
2. 通常Docker启动时会自动加载该模块
3. 对于非官方Docker镜像构建的Docker in Docker环境，可能需要手动加载：

modprobe ip6_tables

或者禁用容器内Docker引擎的ip6tables：

dockerd --ip6tables=false

最佳实践建议

1. 生产环境规划：提前规划好IPv6地址分配策略，避免后期调整
2. 子网大小：IPv6网络通常使用/64子网，这是大多数IPv6功能的最低要求
3. 安全考虑：虽然IPv6地址空间巨大，但仍需注意网络安全配置
4. 双栈支持：建议同时启用IPv4和IPv6，确保兼容性

常见问题排查

1. IPv6网络无法创建：

   • 检查主机是否启用IPv6
   • 确认Docker配置正确
   • 查看内核是否支持所需模块

2. 容器无法通过IPv6通信：

   • 验证网络配置
   • 检查防火墙设置
   • 确认路由正确

3. 地址分配异常：

   • 检查地址池配置
   • 确认没有地址冲突

总结

本文详细介绍了Docker引擎中IPv6网络的配置和使用方法。通过合理配置，Docker可以完美支持IPv6协议，满足现代网络环境的需求。无论是创建独立的IPv6网络，还是为默认桥接网络添加IPv6支持，Docker都提供了灵活的配置选项。掌握这些知识，将帮助你在容器化环境中更好地部署和管理IPv6网络。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs