seven94/caddy-custom-crowdsec

自定义Caddy镜像（集成CrowdSec Bouncer和GeoIp模块）

镜像概述

该镜像基于Caddy Web服务器构建，是一个自定义版本，集成了CrowdSec Bouncer安全模块和GeoIp地理定位模块。旨在提供高性能Web服务的同时，增强安全防护能力和地理位置感知功能，适用于需要安全加固和地理访问控制的Web应用场景。

核心功能与特性

Caddy基础功能

• 自动HTTPS配置与证书管理
• 高性能反向代理与负载均衡
• 静态文件服务与URL重写
• 简洁的Caddyfile配置语法

CrowdSec Bouncer模块

• 实时***IP检测与阻止
• 与CrowdSec安全引擎联动，共享威胁情报
• 支持自定义防护规则与响应策略
• 低资源占用，不影响Web服务性能

GeoIp模块

• 基于IP地址的地理位置解析（国家、城市等）
• 支持地理访问控制（允许/阻止特定区域访问）
• 地理位置信息集成到访问日志
• 兼容MaxMind GeoLite2数据库

使用场景

• 需要增强安全防护的公开Web服务（如博客、电商平台）
• 需基于用户地理位置限制内容访问的应用（如区域服务）
• 需收集客户端地理信息用于分析的网站
• 对***流量防护有较高要求的企业Web应用

使用方法

基本部署命令

bash
docker run -d \
  --name caddy-custom \
  -p 80:80 \
  -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  -v $(pwd)/geoip:/etc/caddy/geoip \  # 挂载GeoIp数据库目录
  [镜像名称]

配置示例（Caddyfile）

caddyfile
example.com {
  # GeoIp配置
  geoip {
    database /etc/caddy/geoip/GeoLite2-City.mmdb  # 指定GeoIp数据库路径
    allow country US CA  # 允许美国和加拿大访问
    deny country RU CN  # 阻止俄罗斯和中国访问（示例）
    log_geoip on  # 记录地理信息到日志
  }

  # CrowdSec Bouncer配置
  crowdsec_bouncer {
    api_url http://crowdsec-server:8080  # CrowdSec服务器API地址
    api_key "your-crowdsec-api-key"  # CrowdSec API密钥
    timeout 5s  # 连接超时时间
    refresh_interval 10m  # 规则刷新间隔
  }

  # 静态文件服务配置
  root * /srv
  file_server
}

环境变量配置

数据持久化

建议挂载以下目录以实现数据持久化：

• /etc/caddy/Caddyfile: 配置文件
• /data: Caddy证书和数据存储
• /config: Caddy运行时配置
• /etc/caddy/geoip: GeoIp数据库文件目录

Docker Compose示例

yaml
version: "3.8"

services:
  caddy:
    image: [镜像名称]
    container_name: caddy-custom
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
      - ./geoip:/etc/caddy/geoip
    environment:
      - CROWDSEC_API_URL=[***]
      - CROWDSEC_API_KEY=your-secure-api-key
    restart: unless-stopped

volumes:
  caddy_data:
  caddy_config: