jtyr/caddy

docker-caddy

镜像概述

这是一个用于创建极简HTTP服务器容器的Docker镜像，基于Go语言编写的https://github.com/mholt/caddy服务器。该容器使用静态编译的Caddy二进制文件，仅包含必要文件，因此容器体积非常小：

$ docker images
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
jtyr/caddy             latest              ae6b0f668182        5 seconds ago       11.3MB

核心功能

1. 支持HTTP/2协议
2. 自动HTTPS（集成Let's Encrypt证书）
3. 可通过构建参数添加额外插件
4. 容器体积极小，资源占用低

使用场景

• 快速搭建轻量级web服务
• 需要自动HTTPS的个人或小型站点
• 开发环境中的临时web服务部署

配置说明

构建镜像

bash
$ docker build -t jtyr/caddy .

构建带额外插件的镜像（例如docker和tls.dns.exoscale）

bash
$ docker build -t jtyr/caddy --build-arg plugins='github.com/lucaslorentz/caddy-docker-proxy/plugin github.com/caddyserver/dnsproviders/exoscale' .

从Docker Hub拉取镜像

bash
$ docker pull docker.xuanyuan.run/jtyr/caddy

运行容器

bash
$ docker run -p 2015:2015 jtyr/caddy

访问测试：

bash
$ curl http://localhost:2015

修改端口映射

bash
$ docker run -d -p 8080:2015 jtyr/caddy
$ curl http://localhost:8080

挂载自定义内容目录

内容默认从/data目录提供，可挂载本地目录替换：

bash
$ docker run -d -p 2015:2015 -v /path/to/your/web/content:/data jtyr/caddy

共享证书目录

.caddy目录包含HTTPS证书等文件，可挂载共享：

bash
$ docker run -d -p 2015:2015 -v /your/caddy/content:/data -v /your/caddy/.caddy:/.caddy jtyr/caddy

自定义配置文件

映射本地Caddyfile替换默认配置：

bash
$ docker run -d -p 2015:2015 -v /your/caddy/Caddyfile:/Caddyfile jtyr/caddy

添加额外参数（例如使用Let's Encrypt测试环境）

bash
$ docker run -d -p 2015:2015 -v /your/caddy/Caddyfile:/Caddyfile jtyr/caddy -ca https://acme-staging.api.letsencrypt.org/directory

启用自动HTTPS（映射80和443端口）

bash
$ docker run -d -p 80:80 -p 443:443 -v /your/caddy/Caddyfile:/Caddyfile -v /your/caddy/.caddy:/.caddy jtyr/caddy

许可证

MIT

作者

Jiri Tyr