siwecos/caddy

siwecos/caddy镜像说明

镜像概述

本镜像为https://caddyserver.com的Docker镜像，针对SIWECOS项目优化，集成cors、ipfilter、realip、expires和cache插件，支持Let's Encrypt自动SSL证书，遵循Apache 2.0许可协议。

核心功能

1. 提供Caddy web服务器基础服务
2. 支持跨域资源共享（cors）、IP过滤（ipfilter）、真实IP获取（realip）、缓存过期控制（expires）、内容缓存（cache）
3. 自动生成/续期Let's Encrypt SSL证书
4. 可通过环境变量配置证书存储路径及ACME协议同意状态

使用场景

• SIWECOS项目内的web服务部署
• 需要跨域、IP过滤或缓存优化的web应用场景
• 快速搭建HTTPS支持的静态/动态web服务

配置说明

容器内关键路径

• Caddy配置文件：/etc/Caddyfile
• 网站根目录：/srv

Let's Encrypt SSL配置

1. 在Caddyfile中指定域名和***（避免运行时交互）：

   mydomain.com
   tls user@host.com
   

2. 设置环境变量自动同意协议：ACME_AGREE=true

证书持久化

避免重复生成触发Let's Encrypt速率限制，挂载证书目录：

sh
docker run -d \
    -v $(pwd)/Caddyfile:/etc/Caddyfile \
    -v $HOME/.caddy:/root/.caddy \
    -p 80:80 -p 443:443 \
    docker.xuanyuan.run/siwecos/caddy

或通过CADDYPATH自定义证书路径：

sh
docker run -d \
    -e "CADDYPATH=/etc/caddycerts" \
    -v $HOME/.caddy:/etc/caddycerts \
    -p 80:80 -p 443:443 \
    docker.xuanyuan.run/siwecos/caddy

快速启动

sh
docker run -d -p 2015:2015 docker.xuanyuan.run/siwecos/caddy

访问http://127.0.0.1:2015查看默认页面。

许可证

基于https://github.com/mholt/caddy构建，遵循Apache 2.0许可协议，不包含官方二进制分发版的EULA条款。

致谢

感谢@abiosoft提供的https://github.com/abiosoft/caddy-docker仓库，以及@mholt和Caddy社区的贡献。