jakewmeyer/caddy-docker

caddy-docker

镜像概述和主要用途

本镜像为基于 https://caddyserver.com/ 的自定义Docker镜像，旨在提供集成特定功能插件的Caddy部署方案，简化需要扩展功能的Web服务搭建流程。

核心功能和特性

包含插件

text
https://github.com/caddy-dns/cloudflare - Cloudflare DNS插件，支持通过Cloudflare DNS进行ACME挑战验证
https://github.com/greenpau/caddy-auth-portal - 认证门户插件，提供用户登录、注册、权限管理等认证功能
https://github.com/greenpau/caddy-auth-jwt - JWT认证插件，支持基于JWT的用户身份验证和授权
https://github.com/mholt/caddy-ratelimit - 速率限制插件，用于限制客户端请求速率，防止滥用

使用场景和适用范围

• 需要集成Cloudflare DNS管理的Web服务部署
• 需实现用户认证（如登录门户、JWT验证）的Web应用
• 需要限制访问速率的API服务或网站
• 需自定义Caddy配置并扩展核心功能的场景

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  docker.xuanyuan.run/jakewmeyer/caddy-docker

Docker Compose配置示例

yaml
version: '3.8'

services:
  caddy:
    image: docker.xuanyuan.run/jakewmeyer/caddy-docker
    container_name: caddy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    restart: unless-stopped

volumes:
  caddy_data:
  caddy_config:

配置说明

1. Caddyfile挂载：通过-v ./Caddyfile:/etc/caddy/Caddyfile挂载自定义Caddy配置文件，配置需包含所需插件的使用指令（如dns cloudflare、auth_portal等）。
2. 数据卷：caddy_data卷用于存储证书、日志等持久化数据；caddy_config卷用于存储配置文件。
3. 环境变量：根据插件需求设置环境变量（如Cloudflare API令牌可通过CLOUDFLARE_API_TOKEN环境变量传入）。

插件配置示例（Caddyfile片段）

caddyfile
example.com {
  # 使用Cloudflare DNS插件进行HTTPS证书申请
  tls {
    dns cloudflare {env.CLOUDFLARE_API_TOKEN}
  }
  
  # 启用速率限制（100次/分钟）
  ratelimit {
    zone static_ip {
      key static.ip
      rate 100r/m
    }
  }
  
  # 配置JWT认证
  jwt {
    trusted_tokens {
      static_secret {env.JWT_SECRET}
    }
  }
  
  # 配置认证门户
  auth_portal {
    path /login
    backend local {
      path /etc/caddy/users.json
    }
    cookie {
      name auth_token
      secret {env.COOKIE_SECRET}
    }
  }
}