Kamal项目IPv6部署实践：解决Rails容器网络优先访问问题

背景与问题场景

在现代云计算环境中，IPv6的采用越来越广泛。本文记录了一个SaaS服务在Hetzner云服务器上从IPv4迁移到IPv6环境时遇到的一个典型网络连接问题。该服务采用的技术栈包括：

• Hetzner云服务器集群
• 专用网络通道实现IPv4到IPv6的桥接
• Rails 8应用容器化部署
• SQLite3数据库

当系统尝试通过SendGrid发送邮件时，出现了ENETUNREACH（网络不可达）错误。经排查发现，SendGrid服务暂不支持IPv6，而我们的Docker容器在双栈网络环境下错误地优先尝试了IPv4连接。

网络架构设计

我们采用了以下IPv6网络配置方案：

1. 主机层配置：

   • 在/etc/docker/daemon.json中启用IPv6支持
   • 配置IPv6转发参数
   • 创建专用的IPv6 Docker网络

2. 网络转换解决方案： 为兼容仅支持IPv4的服务，我们部署了专门的网络转换服务器作为IPv6到IPv4的转换网关。

问题排查过程

通过对比测试发现：

1. 主机直接访问：

   curl -vvv http://smtp.sendgrid.com:25
   

   成功通过网络转换网关建立了IPv6连接

2. 容器内访问：

   curl -vvv http://smtp.sendgrid.com:587
   

   却优先尝试了IPv4直连，导致连接失败

根本原因在于Docker容器内的地址解析策略默认优先返回IPv4地址（A记录），而非IPv6地址（AAAA记录）。

解决方案：调整地址选择策略

Linux系统通过/etc/gai.conf文件控制getaddrinfo()的地址排序策略。我们在Dockerfile中添加了以下配置：

RUN printf '%s\n' \
  'label ::1/128       0' \
  'label ::/0          1' \
  'label 2002::/16     2' \
  'label ::/96         3' \
  'label ::ffff:0:0/96 4' \
  'label fec0::/10     5' \
  'label fc00::/7      6' \
  'label 2001:0::/32   7' \
  'label fd00::/8      1' \
  >> /etc/gai.conf

这个配置实现了：

1. 给本地IPv6回环地址(::1/128)最高优先级(0)
2. 全局IPv6地址(::/0)和私有IPv6地址(fd00::/8)次高优先级(1)
3. 将IPv4映射地址(::ffff:0:0/96)设置为较低优先级(4)

经验总结

1. 双栈环境下的地址选择：在IPv6优先的网络中，必须显式配置地址选择策略

2. 容器网络特殊性：Docker容器内的DNS解析行为与主机存在差异，需要特别关注

3. 渐进式迁移策略：对于依赖IPv4的第三方服务，网络转换是有效的过渡方案

4. 测试验证方法：使用dig和curl -vvv是排查网络连接问题的有效工具

这个案例展示了在现代化容器化部署中实现IPv6优先策略的典型挑战和解决方案，对于类似Kamal这样的部署工具用户具有参考价值。