visualrecord/caddy-docker

Caddy Docker镜像

镜像概述

这是一个基于https://caddyserver.com的Docker镜像，fork自abiosoft/caddy，内置git插件，支持通过构建参数配置自定义插件，同时提供包含PHP-FPM及Composer的PHP变体镜像，可快速部署安全、高效的Web服务。

核心功能

• 内置git插件，支持从Git仓库直接部署网站内容
• 集成Let's Encrypt自动SSL证书生成与续期
• 提供PHP变体镜像，支持PHP应用运行
• 可通过构建参数添加自定义Caddy插件
• 支持证书持久化存储，避免Let's Encrypt rate limit问题

使用场景

• 快速部署静态网站或博客
• 运行PHP-based应用（如WordPress、Laravel）
• 通过Git仓库自动更新网站内容
• 构建支持自定义插件的Caddy服务

配置说明

基本部署

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

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

证书持久化存储

为避免每次容器启动重新生成证书（可能触发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 \
    docker.xuanyuan.run/visualrecord/caddy-docker

或使用CADDYPATH环境变量指定证书位置：

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

PHP变体使用

使用包含PHP-FPM的镜像（如:php标签）：

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

挂载本地PHP源码：

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

注意：PHP变体的Caddyfile需包含on startup php-fpm7指令。

Git源部署

创建Caddyfile指定Git仓库：

sh
printf "0.0.0.0\nroot src\ngit github.com/your/repo" > Caddyfile

运行镜像：

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

自定义插件构建

通过plugins构建参数添加自定义插件：

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

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 \
    visualrecord/caddy-docker