AdGuardHome容器环境下IPv6默认路由缺失问题分析

问题现象

在Docker容器中部署AdGuardHome服务时，发现IPv6网络连接异常。具体表现为：

1. 无法通过IPv6协议访问上游DNS服务器
2. 容器内IPv6测试显示"Network unreachable"错误
3. 手动添加默认路由后IPv6连接恢复正常

技术背景

IPv6网络在容器环境中的路由机制与IPv4存在差异。正常情况下，容器应该通过以下方式获取IPv6路由配置：

• 通过路由器通告(RA)自动获取
• 从DHCPv6服务器接收路由信息
• 由容器运行时自动配置默认路由

根本原因分析

通过技术排查发现核心问题在于：

1. 路由表缺失：容器内缺少default via的IPv6路由条目
2. 动态获取失败：容器未能自动获取父路由器(fd08:192:168:8::1)的默认路由
3. 持久性问题：手动添加的路由在容器重启后丢失

解决方案

临时解决方案

可通过以下命令手动添加默认路由：

ip -6 route add default via fd08:192:168:8::1 dev eth0 metric 1

长期解决方案

1. 检查Docker网络配置：

   • 确保Docker守护进程已启用IPv6支持
   • 检查daemon.json中的ipv6和fixed-cidr-v6配置

2. 调整容器启动参数：

   docker run --sysctl net.ipv6.conf.all.forwarding=1 \
              --sysctl net.ipv6.conf.all.accept_ra=2 \
              adguard/adguardhome
   

3. 使用自定义网络：

   docker network create --ipv6 --subnet=fd08:192:168:8::/64 adguard-net
   

预防措施

1. 在容器启动脚本中加入路由检查逻辑
2. 考虑使用--privileged模式运行容器（安全性需评估）
3. 定期检查Docker和宿主机系统的IPv6支持状态

技术建议

对于Mikrotik路由器环境，建议额外检查：

1. 路由器是否发送正确的RA报文
2. DHCPv6服务是否正常分配路由信息
3. 防火墙规则是否阻止了ICMPv6通信

通过以上措施，可以确保AdGuardHome在容器环境中稳定支持IPv6网络连接，为DNS查询提供完整的双栈支持。