siwecos/caddy

siwecos/caddy镜像说明

!MicroBadger Size !Docker Pulls

镜像概述

本镜像为Caddy的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 \
    siwecos/caddy

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

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

快速启动

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

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

许可证

基于https://github.com/mholt/caddy%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%81%B5%E5%BE%AAApache 2.0许可协议，不包含官方二进制分发版的EULA条款。

致谢

感谢@abiosoft提供的https://github.com/abiosoft/caddy-docker%E4%BB%93%E5%BA%93%EF%BC%8C%E4%BB%A5%E5%8F%8A@mholt%E5%92%8CCaddy%E7%A4%BE%E5%8C%BA%E7%9A%84%E8%B4%A1%E7%8C%AE%E3%80%82