sabrsorensen/caddy-docker-proxy-cloudflare

caddy-docker-proxy-cloudflare

镜像概述

caddy-docker-proxy-cloudflare是一个基于Caddy2的Docker镜像，集成了https://github.com/lucaslorentz/caddy-docker-proxy和https://github.com/caddy-dns/cloudflare插件。该镜像允许通过Docker容器标签自动配置反向代理规则，并利用Cloudflare DNS验证自动获取和续期SSL/TLS证书。

核心功能与特性

• 自动配置反向代理：通过Docker容器标签定义代理规则，无需手动编写Caddyfile
• Cloudflare DNS验证：集成Cloudflare DNS插件，支持通过DNS-01挑战获取Let's Encrypt证书
• 多服务支持：可同时代理多个Docker服务，支持多端口和多子域名配置
• 基本认证保护：支持为整个服务或特定路径配置基本认证
• 数据持久化：Caddy配置和证书数据通过卷挂载持久化存储

使用场景

• 需要为多个Docker服务提供统一反向代理的环境
• 使用Cloudflare DNS管理域名，需要自动获取SSL证书的场景
• 希望通过容器标签而非手动配置管理代理规则的用户
• 需要为特定服务或路径添加访问控制的场景

使用方法与配置说明

基本部署（docker-compose）

yml
version: '3.8'

networks:
  net:
    driver: bridge

services:
  caddy:
    image: docker.xuanyuan.run/sabrsorensen/caddy-docker-proxy-cloudflare
    container_name: caddy
    networks:
      - net
    ports:
      - 80:80      # HTTP端口
      - 443:443    # HTTPS端口
      - 2015:2015  # 管理端口
    environment:
      - CLOUDFLARE_EMAIL=your.cloudflare@email.com  # Cloudflare账户邮箱
      - CLOUDFLARE_API_TOKEN=your.cloudflare.apitoken  # Cloudflare API令牌（需DNS编辑权限）
      - CADDY_DOCKER_PROXY_SERVICE_TASKS=true  # 支持Docker Swarm服务任务
      - CADDY_DOCKER_PROCESS_CADDYFILE=true  # 处理Caddyfile
    volumes:
      - /<path to your docker configs>/caddy/:/data/  # Caddy数据持久化
      - /var/run/docker.sock:/var/run/docker.sock  # 访问Docker socket以监听容器事件
    command: docker-proxy  # 启动docker-proxy模式
    labels:
      caddy.email: "your.letsencrypt@email.com"  # Let's Encrypt证书通知邮箱
    restart: unless-stopped

被代理服务配置示例

1. 基本反向代理服务

yml
proxiedService:
  # ... 其他服务配置 ...
  networks:
    - net
  ports:
    - 8080:8080  # 服务内部端口
  labels:
    caddy: proxiedService.domain.tld  # 代理域名
    caddy.reverse_proxy: "{{ upstreams http 8080 }}"  # 反向代理到服务的8080端口
    caddy.tls.dns: "cloudflare {env.CLOUDFLARE_API_TOKEN}"  # 使用Cloudflare DNS验证

2. 全局基本认证保护的服务

yml
proxiedServiceWithBasicAuthOnAllRoutes:
  # ... 其他服务配置 ...
  networks:
    - net
  ports:
    - 8081:8081
  labels:
    caddy: proxiedServiceWithBasicAuth.domain.tld
    caddy.reverse_proxy: "{{ upstreams http 8081 }}"
    caddy.tls.dns: "cloudflare {env.CLOUDFLARE_API_TOKEN}"
    # 基本认证配置：<username>替换为实际用户名，<password>替换为明文密码
    caddy.basicauth.<username>: "`caddy hash-password --plaintext <password>`"

3. 特定路径基本认证保护的服务

yml
proxiedServiceWithBasicAuthOn/SecretRoute:
  # ... 其他服务配置 ...
  networks:
    - net
  ports:
    - 8082:8082
  labels:
    caddy: proxiedServiceWithBasicAuth.domain.tld
    caddy.reverse_proxy: "{{ upstreams http 8082 }}"
    caddy.tls.dns: "cloudflare {env.CLOUDFLARE_API_TOKEN}"
    # 仅保护/secretroute路径：<username>和<password>替换为实际值
    caddy.basicauth./secretroute.<username>: "`caddy hash-password --plaintext <password>`"

4. 多端口代理服务

yml
proxiedServiceWithMultiplePorts:
  # ... 其他服务配置 ...
  networks:
    - net
  ports:
    - 8083:8083
    - 8084:8084
  labels:
    caddy: proxiedServiceWithMultiplePorts.domain.tld
    # 代理多个端口：8083和8084
    caddy.reverse_proxy: "{{ upstreams http 8083 8084 }}"
    caddy.tls.dns: "cloudflare {env.CLOUDFLARE_API_TOKEN}"

5. 多子域名与多端口代理服务

yml
proxiedServiceWithMultiplePortsAndSubdomains:
  # ... 其他服务配置 ...
  networks:
    - net
  ports:
    - 8085:8085
    - 8086:8086
  labels:
    # 第一个子域名配置
    caddy_0: proxiedServiceWithMultiplePortsAndSubdomains0.domain.tld
    caddy_0.reverse_proxy: "{{ upstreams http 8085 }}"
    caddy_0.tls.dns: "cloudflare {env.CLOUDFLARE_API_TOKEN}"
    # 第二个子域名配置
    caddy_1: proxiedServiceWithMultiplePortsAndSubdomains1.domain.tld
    caddy_1.reverse_proxy: "{{ upstreams http 8086 }}"
    caddy_1.tls.dns: "cloudflare {env.CLOUDFLARE_API_TOKEN}"

关键配置说明

环境变量

卷挂载

• /data/: Caddy配置、证书和其他数据的持久化目录
• /var/run/docker.sock: 必须挂载以允许caddy-docker-proxy监听Docker容器事件

容器标签