Coolify项目中Traefik通配符证书配置实践

背景介绍

在构建SaaS应用时，通配符证书是实现多租户架构的关键组件。Coolify作为一款现代化的部署工具，支持通过Traefik实现通配符证书的自动化管理。本文将详细介绍在Coolify环境中配置Traefik通配符证书的正确方法。

配置要点

1. DNS记录设置

首先需要在DNS服务商处设置通配符A记录，将*.yourdomain.com指向服务器IP地址。这是后续证书申请的基础。

2. Traefik代理配置

在Coolify的proxy配置文件中，需要确保包含以下关键参数：

certificatesresolvers:
  letsencrypt:
    acme:
      httpchallenge: true
      dnschallenge: true
      storage: /traefik/acme.json
      httpchallenge:
        entrypoint: http
      dnschallenge:
        provider: dns-provider
        delaybeforecheck: 0

3. 应用路由规则

对于SaaS应用的路由配置，需要特别注意Traefik v3的语法规则：

traefik.http.routers.app-router-https.rule=HostRegexp(`^.+\.yourdomain\.com$`)
traefik.http.routers.app-router-https.entryPoints=https
traefik.http.routers.app-router-https.tls=true
traefik.http.routers.app-router-https.tls.certresolver=letsencrypt

4. HTTP到HTTPS重定向

必须单独配置HTTP路由来实现安全重定向：

traefik.http.routers.app-router-http.rule=HostRegexp(`^.+\.yourdomain\.com$`)
traefik.http.routers.app-router-http.entryPoints=http
traefik.http.routers.app-router-http.middlewares=redirect-to-https

常见问题解决

1. 证书申请失败：确保DNS解析已生效，并且DNS服务商API凭证正确配置。

2. 路由冲突：为HTTP和HTTPS路由使用不同的名称，避免定义冲突。

3. Traefik版本差异：v3版本中正则表达式语法有所变化，需使用HostRegexp(^.+.domain.com$)格式。

最佳实践建议

1. 为生产环境配置监控，跟踪证书续期状态。

2. 定期备份acme.json文件，防止证书丢失。

3. 考虑设置证书续期提醒机制。

通过以上配置，Coolify可以完美支持基于通配符证书的多租户SaaS架构，实现灵活的域名路由管理。