moccu/caddy

Caddy Docker镜像

这是一个定制构建的https://github.com/mholt/caddy Docker镜像。

核心功能

• 从源码构建Caddy
• 支持DigitalOcean DNS提供商
• 禁用遥测功能
• 容器以非特权用户运行（使用https://github.com/ncopa/su-exec%EF%BC%89

使用场景

以内置用户运行

镜像内置非特权用户caddy（UID 99 / GID 99），若容器以caddy命令启动则默认使用该用户。其他命令默认以容器用户（通常为root，除非用--user指定）运行。

bash
$ docker run moccu/caddy:latest caddy

以主机用户运行

若需将证书挂载到容器中，推荐通过设置$CADDYUID和$CADDYGID，以主机用户的UID和GID启动Caddy。

bash
$ id caddy
uid=123(caddy) gid=123(caddy) groups=123(caddy)

$ ls -ln /path/to/certificates
-rw------- 1 123 123 2818 Jan 01 2018 00:00 certificate.pem

$ docker run \
    -e CADDYUID=123 \
    -e CADDYGID=123 \
    -v /path/to/certificates:/certificates:ro \
    moccu/caddy:latest \
    caddy

以root用户运行

虽然不推荐，但可通过将$CADDYUID和$CADDYGID设为0以root用户运行Caddy。

bash
$ docker run -e CADDYUID=0 -e CADDYGID=0 moccu/caddy:latest caddy

配置选项

$CADDYPATH

Caddy用于存储资产的文件夹，默认值为/etc/caddy。

注意：Caddy会将Let's Encrypt证书存储在子文件夹acme中。

$CADDYPATH_SETOWNER

若容器以root启动且该值设为yes，则将$CADDYPATH的所有者改为$CADDYUID和$CADDYGID，默认值为yes。

$CADDYUID

Caddy在容器中运行时使用的UID，默认值为99。

$CADDYGID

Caddy在容器中运行时使用的GID，默认值为99。

配置说明

要配置Caddy，需根据文档创建配置文件，挂载到容器并启动caddy时指定-conf参数。

bash
docker run \
    -v /path/to/Caddyfile:/etc/caddy/Caddyfile:ro \
    moccu/caddy:latest \
    caddy -conf /etc/caddy/Caddyfile

替代方案

你可以查看Abiola Ibrahim的Docker镜像：https://hub.docker.com/r/abiosoft/caddy/