yangliu/caddy

yangliu/caddy镜像描述

镜像概述

本Docker镜像是基于官方Caddy仓库构建的Web服务器镜像，额外集成了git、cors、realip、expires、cache和cloudflare等实用插件，支持多种Web服务场景的快速部署，适用于静态网站、PHP应用、自动SSL证书配置等需求。

核心功能

• Git插件：直接从Git仓库拉取站点内容并自动更新
• CORS插件：处理跨域资源共享请求，支持前端应用与后端服务的跨域通信
• RealIP插件：获取客户端真实IP地址，适用于反向代理场景
• Expires插件：设置静态资源缓存过期时间，提升网站加载速度
• Cache插件：缓存动态内容，减少服务器响应时间
• Cloudflare插件：支持Cloudflare DNS验证，快速获取Let's Encrypt SSL证书

使用场景

1. 快速搭建静态网站或个人博客
2. 部署PHP应用（需使用php变体镜像）
3. 自动获取并续期Let's Encrypt SSL证书，实现HTTPS访问
4. 从Git仓库自动部署站点内容，简化持续集成流程
5. 配置跨域资源共享，支持前后端分离项目

配置说明

基础运行

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

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

保存Let's Encrypt证书

为避免重复生成证书触发Let's Encrypt rate limit，需挂载证书目录：

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

或通过环境变量指定证书路径：

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

PHP应用部署

使用php变体镜像（如:php标签）部署PHP项目：

sh
docker run -d -v /path/to/php/src:/srv -p 2015:2015 yangliu/caddy:php

注意：需在Caddyfile中添加on startup php-fpm7以启动PHP-FPM服务。

从Git仓库部署站点

创建Caddyfile配置Git仓库：

0.0.0.0
root src
git github.com/yourusername/your-repo

运行镜像：

sh
docker run -d -v $(pwd)/Caddyfile:/etc/Caddyfile -p 2015:2015 yangliu/caddy

Let's Encrypt自动SSL配置

在Caddyfile中指定域名和***：

yourdomain.com
tls your@email.com

运行镜像（需开放80/443端口）：

sh
docker run -d \
    -v $(pwd)/Caddyfile:/etc/Caddyfile \
    -p 80:80 -p 443:443 \
    yangliu/caddy

自定义插件构建

如需添加自定义插件，可通过plugins构建参数构建镜像：

sh
docker build --build-arg \
    plugins=git,linode \
    github.com/abiosoft/caddy-docker.git