Caddy-docker-proxy实现域名重定向配置指南

在使用Caddy-docker-proxy时，经常需要实现主域名到www子域名的重定向功能。本文将详细介绍如何通过Docker标签配置实现这一需求。

配置原理

Caddy-docker-proxy允许通过Docker容器的labels标签动态生成Caddy配置。要实现主域名重定向到www子域名，需要创建两个配置段：

1. www子域名配置段：处理实际请求
2. 主域名配置段：实现重定向逻辑

配置实现

在Docker Compose文件中，我们需要为服务添加特定的labels标签。关键点在于使用数字序号区分不同的配置段：

labels:
  caddy_0: www.mydomain.com:443
  caddy_0.reverse_proxy: "{{upstreams 80}}"
  caddy_0.log:
  caddy_1: mydomain.com
  caddy_1.redir: https://www.{host}{uri}

配置解析

上述配置将生成以下Caddyfile内容：

www.mydomain.com:443 {
    log
    reverse_proxy 172.18.0.4:80
}
mydomain.com {
    redir https://www.{host}{uri}
}

技术要点说明

1. 数字序号：使用caddy_0、caddy_1等前缀可以定义多个独立的Caddy配置段

2. 重定向语法：redir https://www.{host}{uri}会保留原始请求的URI部分

3. 端口处理：主域名配置不需要指定端口，Caddy会自动处理HTTP和HTTPS

4. 日志配置：简单的log指令会启用默认访问日志

常见问题

1. 配置顺序：数字序号必须连续且从0开始
2. 特殊字符：URI中的特殊字符会自动处理
3. HTTPS：Caddy会自动获取并管理SSL证书

最佳实践

1. 建议始终使用www子域名作为主配置
2. 保持重定向配置简洁
3. 在生产环境中考虑添加更多日志细节
4. 测试时可以先使用HTTP验证配置

通过这种配置方式，可以轻松实现主域名到www子域名的无缝重定向，同时保持配置的清晰和可维护性。