silicer/caddy Docker 镜像 - 轩辕镜像

Caddy 镜像（xcaddy构建版）

镜像概述

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

核心功能与特性

• 官方兼容基础：使用xcaddy（Caddy官方构建工具）构建，确保与官方Caddy版本同步，基础功能与官方镜像无差异
• 插件集成：内置caddyserver/replace-response插件，支持对HTTP响应内容进行替换处理
• 稳定版本：基于Caddy Release版本构建，保证生产环境使用的稳定性和可靠性

适用场景

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

使用方法

基本使用

本镜像的使用方法与官方Caddy镜像完全一致，支持通过Caddyfile、环境变量、API等方式配置。

快速启动示例

使用自定义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