Kamal部署中动态加载Traefik配置的实践方案

在基于Kamal的Rails应用部署过程中，我们经常需要处理动态域名配置的场景。本文将详细介绍如何通过Traefik的HTTP Provider实现动态路由配置，无需每次修改配置后重新部署应用。

核心思路

通过Rails应用暴露一个配置接口，让Traefik定期轮询获取最新路由配置。这种方式特别适合需要频繁添加或修改域名的场景，例如多租户SaaS应用或营销活动页面。

实现步骤

1. 创建Traefik配置接口

在Rails应用中创建一个控制器，动态生成Traefik所需的YAML配置：

class TraefikController < ApplicationController
  def config
    render plain: generate_traefik_config.to_yaml, content_type: 'text/yaml'
  end

  private

  def tracking_domains
    TrackingDomain.pluck(:name) # 从数据库获取需要路由的域名
  end

  def generate_traefik_config
    {
      http: {
        routers: tracking_domains.each_with_object({}) do |domain, hash|
          hash[domain] = {
            rule: "Host(`#{domain}`)",
            service: domain,
            tls: { certResolver: "letsencrypt" }
          }
        end,
        services: tracking_domains.each_with_object({}) do |domain, hash|
          hash[domain] = {
            loadBalancer: {
              servers: [{ url: ENV['APP_SERVER_URL'] }]
            }
          }
        end
      }
    }
  end
end

2. 配置路由

在config/routes.rb中添加路由配置：

get '/traefik/config', to: 'traefik#config'

3. Kamal部署配置

在config/deploy.yml中配置Traefik参数：

traefik:
  args:
    providers:
      http:
        endpoint: "https://yourdomain.com/traefik/config"
        pollInterval: "10s"

技术要点解析

1. 动态配置生成：控制器从数据库实时获取域名列表，确保每次请求返回的都是最新配置

2. TLS证书自动管理：配置中指定了letsencrypt证书解析器，Traefik会自动为新增域名申请证书

3. 轮询机制：通过pollInterval参数控制配置更新频率，10秒的间隔在大多数场景下都能平衡实时性和性能

4. 负载均衡：所有域名最终都路由到同一个服务集群，由Rails应用根据域名处理不同业务逻辑

生产环境建议

1. 对配置接口添加认证保护，防止未授权访问

2. 考虑添加缓存机制，避免频繁查询数据库

3. 监控Traefik日志，确保配置更新正常

4. 对于大规模域名场景，可以考虑分页或增量更新策略

这种方案完美解决了传统静态配置的局限性，使得域名管理变得灵活高效，特别适合需要频繁变更路由规则的业务场景。