nouse/caddy

Custom Caddy

镜像概述和主要用途

Custom Caddy是一个集成了所需插件的自定义Caddy构建版本，通过Github Packages进行分发。该镜像基于Caddy服务器核心，预先集成特定功能插件，提供开箱即用的定制化Web服务解决方案。

核心功能和特性

• 插件定制集成：根据需求预先构建并集成必要的Caddy插件，无需手动编译
• 便捷分发渠道：通过Github Packages提供镜像托管，便于版本管理和获取
• 保留核心能力：继承Caddy服务器原生功能，包括自动HTTPS、反向代理、静态文件服务等

使用场景和适用范围

适用于需要特定Caddy插件来满足业务需求的Web服务场景，例如：

• 需要额外认证机制的Web应用部署
• 集成特定日志分析或监控插件的服务
• 实现自定义URL重写、缓存策略或安全规则的场景

使用方法和配置说明

拉取镜像

从Github Packages拉取自定义Caddy镜像：

bash
docker pull ***-ghcr.xuanyuan.run/[github-username]/custom-caddy:latest

注：需将[github-username]替换为实际的GitHub用户名

基本运行命令

启动容器并映射默认HTTP/HTTPS端口：

bash
docker run -d -p 80:80 -p 443:443 --name custom-caddy ***-ghcr.xuanyuan.run/[github-username]/custom-caddy:latest

自定义配置

通过挂载本地Caddyfile实现配置自定义：

bash
docker run -d \
  -p 80:80 -p 443:443 \
  -v /path/to/local/Caddyfile:/etc/caddy/Caddyfile \
  --name custom-caddy \
  ***-ghcr.xuanyuan.run/[github-username]/custom-caddy:latest

数据持久化

如需持久化证书和配置数据，可挂载数据卷：

bash
docker run -d \
  -p 80:80 -p 443:443 \
  -v /path/to/local/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy-data:/data \
  -v caddy-config:/config \
  --name custom-caddy \
  ***-ghcr.xuanyuan.run/[github-username]/custom-caddy:latest

其中caddy-data和caddy-config为Docker命名卷，用于持久化证书和配置数据