arm32v6/caddy

注意：这是 https://hub.docker.com/_/caddy 的 arm32v6 架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

• 维护者：
  https://github.com/caddyserver/caddy-docker

• 获取帮助：
  Caddy社区论坛

支持的标签及对应的 Dockerfile 链接

（参见FAQ中的“https://github.com/docker-library/faq#whats-the-difference-between-shared-and-simple-tags%E2%80%9D%EF%BC%89

简单标签

• https://github.com/caddyserver/caddy-docker/blob/5572371a83e48fd0368a4917d0fc48e44ef30582/2.10/alpine/Dockerfile

• https://github.com/caddyserver/caddy-docker/blob/5572371a83e48fd0368a4917d0fc48e44ef30582/2.10/builder/Dockerfile

共享标签

• 2.10.2, 2.10, 2, latest:

  • https://github.com/caddyserver/caddy-docker/blob/5572371a83e48fd0368a4917d0fc48e44ef30582/2.10/alpine/Dockerfile

• 2.10.2-builder, 2.10-builder, 2-builder, builder:

  • https://github.com/caddyserver/caddy-docker/blob/5572371a83e48fd0368a4917d0fc48e44ef30582/2.10/builder/Dockerfile

快速参考（续）

• 问题提交地址：
  https://github.com/caddyserver/caddy-docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/caddy/, https://hub.docker.com/r/arm32v6/caddy/, https://hub.docker.com/r/arm32v7/caddy/, https://hub.docker.com/r/arm64v8/caddy/, https://hub.docker.com/r/ppc64le/caddy/, https://hub.docker.com/r/riscv64/caddy/, https://hub.docker.com/r/s390x/caddy/, https://hub.docker.com/r/winamd64/caddy/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/caddy%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/caddy%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fcaddy
  https://github.com/docker-library/official-images/blob/master/library/caddy%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/caddy%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/caddy%EF%BC%88https://github.com/docker-library/docs/commits/master/caddy%EF%BC%89

!https://raw.githubusercontent.com/docker-library/docs/7f3881a28c29ed29bb1a38681b95bd785a8a6da5/caddy/logo.png

什么是Caddy？

Caddy 2 是一款功能强大、企业级的开源Web服务器，用Go语言编写，支持自动HTTPS。

如何使用本镜像

⚠️ 关于持久化数据的注意事项

Caddy需要对两个位置具有写权限：数据目录和配置目录。虽然不必持久化配置目录中的文件（但可能方便），但持久化数据目录非常重要。

文档中说明：

数据目录不得视为缓存。其内容并非临时文件或仅为性能而存在。Caddy将TLS证书、私钥、OCSP staples和其他必要信息存储在数据目录中。未经了解相关影响，不应清除该目录。

本镜像提供两个卷挂载点：/data和/config。

以下示例中，使用命名卷caddy_data挂载到/data，以持久化数据。

注意，命名卷在容器重启和终止后仍会保留，因此升级镜像版本时，可重用相同的数据和配置目录。

基本用法

默认配置文件仅从/usr/share/caddy提供文件，因此若要从当前工作目录提供index.html：

console
$ echo "hello world" > index.html
$ docker run -d -p 80:80 \
    -v $PWD/index.html:/usr/share/caddy/index.html \
    -v caddy_data:/data \
    arm32v6/caddy
...
$ curl http://localhost/
hello world

要覆盖默认https://github.com/caddyserver/dist/blob/master/config/Caddyfile%EF%BC%8C%E5%8F%AF%E5%9C%A8%60$PWD/conf%60%E5%AD%90%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%E5%88%9B%E5%BB%BACaddyfile%EF%BC%8C%E5%B9%B6%E5%B0%86%E8%AF%A5%E6%96%87%E4%BB%B6%E5%A4%B9%E6%8C%82%E8%BD%BD%E5%88%B0%60/etc/caddy%60%EF%BC%9A

console
$ docker run -d -p 80:80 \
    -v $PWD/conf:/etc/caddy \
    -v caddy_data:/data \
    arm32v6/caddy

⚠️ 不要将Caddyfile直接挂载到/etc/caddy/Caddyfile

如果使用vim或其他会更改所编辑文件inode的编辑器，只有重建容器时，更改才会在容器内生效（详见此Medium文章）。使用此类编辑器时，Caddy的优雅重载功能可能无法按预期工作（如https://github.com/caddyserver/caddy/issues/5735#issuecomment-***%E6%89%80%E8%BF%B0%EF%BC%89%E3%80%82

使用Caddy镜像实现自动TLS

默认Caddyfile仅监听80端口，不设置自动TLS。但如果您的站点有域名，且其A/AAAA DNS记录已正确指向该机器的公网IP，可使用以下命令通过HTTPS提供站点服务：

console
$ docker run -d --cap-add=NET_ADMIN -p 80:80 -p 443:443 -p 443:443/udp \
    -v /site:/srv \
    -v caddy_data:/data \
    -v caddy_config:/config \
    arm32v6/caddy caddy file-server --domain example.com

关键在于Caddy需能够监听80和443端口（ACME HTTP挑战均需这两个端口）。

有关自动HTTPS支持的更多信息，请参见Caddy文档！

构建自定义Caddy镜像

大多数部署生产站点的用户不希望依赖挂载文件到容器，而是基于arm32v6/caddy构建自己的镜像：

Dockerfile
# 注意：生产环境切勿使用:latest标签
FROM arm32v6/caddy:<version>

COPY Caddyfile /etc/caddy/Caddyfile
COPY site /srv

添加自定义Caddy模块

Caddy可通过“模块”扩展。详见[***]

可使用:builder镜像快速构建新的Caddy二进制文件：

Dockerfile
FROM arm32v6/caddy:<version>-builder AS builder

RUN xcaddy build \
    --with github.com/caddyserver/nginx-adapter \
    --with github.com/hairyhenderson/caddy-teapot-module@v0.0.3-0

FROM arm32v6/caddy:<version>

COPY --from=builder /usr/bin/caddy /usr/bin/caddy

注意第二个FROM指令——通过将新构建的二进制文件覆盖到常规arm32v6/caddy镜像上，生成更小的镜像。

xcaddy工具用于https://github.com/caddyserver/caddy/blob/4217217badf220d7d2c25f43f955fdc8454f2c64/cmd/caddy/main.go#L15..L25%EF%BC%8C%E5%8C%85%E5%90%AB%E6%8C%87%E5%AE%9A%E6%A8%A1%E5%9D%97%E3%80%82%E5%8F%AF%E4%BB%85%E6%8C%87%E5%AE%9A%E6%A8%A1%E5%9D%97%E5%90%8D%EF%BC%8C%E6%88%96%E6%A8%A1%E5%9D%97%E5%90%8D+%E7%89%88%E6%9C%AC%EF%BC%88%E7%94%A8%60@%60%E5%88%86%E9%9A%94%EF%BC%89%E3%80%82%E4%B9%9F%E5%8F%AF%E6%8C%87%E5%AE%9A%E6%9E%84%E5%BB%BACaddy%E7%9A%84%E7%89%B9%E5%AE%9A%E7%89%88%E6%9C%AC%EF%BC%88%E7%89%88%E6%9C%AC%E6%A0%87%E7%AD%BE%E6%88%96%E6%8F%90%E4%BA%A4%E5%93%88%E5%B8%8C%EF%BC%89%E3%80%82%E6%9B%B4%E5%A4%9Ahttps://github.com/caddyserver/xcaddy#command-usage%E3%80%82

注意，“标准”Caddy模块（https://github.com/caddyserver/caddy/tree/master/modules/standard%EF%BC%89%E5%A7%8B%E7%BB%88%E5%8C%85%E5%90%AB%E5%9C%A8%E5%86%85%E3%80%82

优雅重载

更改配置时，Caddy无需完全重启。Caddy提供caddy reload命令，可零停机重载配置。

在Docker中运行Caddy时，触发配置重载的推荐方式是在运行中的容器内执行caddy reload命令。

首先，确定容器ID或名称，然后将容器ID传递给docker exec。工作目录设为/etc/caddy，以便Caddy无需额外参数即可找到Caddyfile。

console
$ caddy_container_id=$(docker ps | grep caddy | awk '{print $1;}')
$ docker exec -w /etc/caddy $caddy_container_id caddy reload

Linux capabilities

Caddy默认启用HTTP/3支持。为提高此UDP协议的性能，底层quic-go库尝试增加其套接字的缓冲区大小。NET_ADMIN capability允许其覆盖操作系统的低默认限制，无需通过sysctl修改内核参数。

赋予容器此capability是可选的，虽不太可能，但可能存在安全影响。

详见https://github.com/quic-go/quic-go/wiki/UDP-Buffer-Sizes%E3%80%82

Docker Compose示例

如果倾向于使用docker compose运行服务，以下是服务定义示例（保存为compose.yaml）。配置假设您已按上文所述在$PWD/conf中放置了自定义Caddyfile。

yaml
services:
  caddy:
    image: arm32v6/caddy:<version>
    restart: unless-stopped
    cap_add:
      - NET_ADMIN
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - $PWD/conf:/etc/caddy
      - $PWD/site:/srv
      - caddy_data:/data
      - caddy_config:/config

volumes:
  caddy_data:
  caddy_config:

优雅重载可通过docker compose exec -w /etc/caddy caddy caddy reload执行。

镜像变体

arm32v6/caddy镜像有多种版本，各适用于特定场景。

arm32v6/caddy:<version>

这是默认镜像。如不确定需求，通常应使用此版本。设计用于临时容器（挂载源代码并启动容器以运行应用），也可用作构建其他镜像的基础。

arm32v6/caddy:<version>-alpine

此镜像基于流行的Alpine Linux项目，来自https://hub.docker.com/_/alpine%E3%80%82Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常生成更精简的镜像。

当最终镜像大小是首要考虑因素时，此变体很有用。需注意的是，它使用musl libc而非glibc及类似库，因此软件可能因libc需求/假设的深度而遇到问题。详见此Hacker News评论线程，了解可能出现的问题及使用Alpine-based镜像的优缺点。

为最小化镜像大小，Alpine-based镜像通常不包含额外相关工具（如git或bash）。以此镜像为基础，可在自己的Dockerfile中添加所需工具（如不熟悉，参见https://hub.docker.com/_/alpine/%E4%B8%AD%E7%9A%84%E5%AE%89%E8%A3%85%E7%A4%BA%E4%BE%8B%EF%BC%89%E3%80%82

许可证

查看此镜像包含的软件的https://github.com/caddyserver/caddy/blob/master/LICENSE%E3%80%82

与所有Docker镜像一样，这些镜像可能还包含其他软件，可能采用其他许可证（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

可在https://github.com/docker-library/repo-info/tree/master/repos/caddy%E4%B8%AD%E6%89%BE%E5%88%B0%E4%B8%80%E4%BA%9B%E8%83%BD%E5%A4%9F%E8%87%AA%E5%8A%A8%E6%A3%80%E6%B5%8B%E5%88%B0%E7%9A%84%E9%A2%9D%E5%A4%96%E8%AE%B8%E5%8F%AF%E8%AF%81%E4%BF%A1%E6%81%AF%E3%80%82

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。