silicer/caddy

Caddy 镜像（xcaddy构建版）

镜像概述

本镜像为使用官方xcaddy工具构建的Caddy Release版本镜像，基于Caddy官方源码编译，集成replace-response插件，除插件集成外，其余功能与官方Caddy镜像完全一致，可直接参考官方镜像的使用方式。

核心功能与特性

• 官方兼容基础：使用xcaddy（Caddy官方构建工具）构建，确保与官方Caddy版本同步，基础功能与官方镜像无差异
• 插件集成：内置https://github.com/caddyserver/replace-response%E6%8F%92%E4%BB%B6%EF%BC%8C%E6%94%AF%E6%8C%81%E5%AF%B9HTTP%E5%93%8D%E5%BA%94%E5%86%85%E5%AE%B9%E8%BF%9B%E8%A1%8C%E6%9B%BF%E6%8D%A2%E5%A4%84%E7%90%86
• 稳定版本：基于Caddy Release版本构建，保证生产环境使用的稳定性和可靠性

适用场景

• 需要Caddy基础功能（如Web服务、反向代理、HTTPS自动配置等）的场景
• 需对HTTP响应内容进行修改的场景（如替换响应中的特定字符串、调整响应头信息等）
• 要求与官方Caddy镜像配置方式兼容的使用场景

使用方法

基本使用

本镜像的使用方法与https://hub.docker.com/_/caddy%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87Caddyfile%E3%80%81%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E3%80%81API%E7%AD%89%E6%96%B9%E5%BC%8F%E9%85%8D%E7%BD%AE%E3%80%82

快速启动示例

使用自定义Caddyfile启动：

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

docker-compose示例

yaml
version: '3.8'
services:
  caddy:
    image: your-image-name
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    restart: unless-stopped

volumes:
  caddy_data:
  caddy_config:

插件使用

replace-response插件的具体使用方式请参考其官方文档，在Caddyfile中通过插件提供的指令配置响应替换规则，示例：

caddyfile
example.com {
  reverse_proxy backend:8080
  replace-response {
    # 替换响应中的"old-text"为"new-text"
    string "old-text" "new-text"
  }
}

配置说明

所有配置方式与官方Caddy镜像一致，支持以下标准配置途径：

• Caddyfile：通过-v挂载自定义Caddyfile到/etc/caddy/Caddyfile
• 环境变量：支持官方定义的所有环境变量（如CADDY_HTTP_PORT等）
• API配置：通过Caddy Admin API动态配置（默认监听在localhost:2019）

详细配置文档请参考Caddy官方文档。

版本信息

• 基础版本：Caddy Release版本（与官方同步）
• 集成插件：replace-response（最新稳定版）
• 构建工具：官方xcaddy