riscv64/caddy

注意：这是https://hub.docker.com/_/caddy的`riscv64`架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。

快速参考

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

• 获取帮助：
  Caddy社区论坛

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

（参见FAQ中的https://github.com/docker-library/faq#whats-the-difference-between-shared-and-simple-tags）

Simple Tags

• https://github.com/caddyserver/caddy-docker/blob/fba2853501d36e8a72f946ac8cb7ff64d07e48f2/2.11/alpine/Dockerfile

• https://github.com/caddyserver/caddy-docker/blob/fba2853501d36e8a72f946ac8cb7ff64d07e48f2/2.11/builder/Dockerfile

Shared Tags

• 2.11.4, 2.11, 2, latest：

  • https://github.com/caddyserver/caddy-docker/blob/fba2853501d36e8a72f946ac8cb7ff64d07e48f2/2.11/alpine/Dockerfile

• 2.11.4-builder, 2.11-builder, 2-builder, builder：

  • https://github.com/caddyserver/caddy-docker/blob/fba2853501d36e8a72f946ac8cb7ff64d07e48f2/2.11/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（https://github.com/docker-library/repo-info/commits/master/repos/caddy）
  （镜像元数据、传输大小等）

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

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/caddy（https://github.com/docker-library/docs/commits/master/caddy）

什么是Caddy？

https://caddyserver.com/是一款功能强大、企业级的开源Web服务器，用Go语言编写，支持自动HTTPS。

如何使用本镜像

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

Caddy需要对两个位置具有写权限：https://caddyserver.com/docs/conventions#data-directory和https://caddyserver.com/docs/conventions#configuration-directory。虽然不必持久化配置目录中存储的文件，但这样做可能会很方便。然而，持久化数据目录非常重要。

根据文档：

数据目录不得被视为缓存。其内容不是临时的，也不仅仅是为了性能。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 \
    riscv64/caddy
...
$ curl http://localhost/
hello world

要覆盖默认的https://github.com/caddyserver/dist/blob/master/config/Caddyfile，可以在`$PWD/conf`子文件夹中创建一个`Caddyfile`，并将此文件夹挂载到`/etc/caddy`：

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

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

如果使用vim或其他会更改已编辑文件inode的编辑器，只有在重新创建容器时，更改才会在容器内生效，这在这篇Medium文章中有详细解释。使用此类编辑器时，Caddy的优雅重载功能可能无法按预期工作，如https://github.com/caddyserver/caddy/issues/5735#issuecomment-***中所述。

使用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 \
    riscv64/caddy caddy file-server --domain example.com

关键在于Caddy能够监听80和443端口，这两个端口都是ACME HTTP挑战所必需的。

有关自动HTTPS支持的更多信息，请参见https://caddyserver.com/docs/automatic-https！

构建您自己的基于Caddy的镜像

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

Dockerfile
# 注意：在生产站点中切勿使用:latest标签
FROM docker.xuanyuan.run/riscv64/caddy:<version>

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

添加自定义Caddy模块

Caddy可通过"模块"进行扩展。有关完整详情，请参见https://caddyserver.com/docs/extending-caddy。您可以在https://caddyserver.com/download上找到可用模块列表。

您可以使用:builder镜像作为构建新Caddy二进制文件的快捷方式：

Dockerfile
FROM docker.xuanyuan.run/riscv64/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 docker.xuanyuan.run/riscv64/caddy:<version>

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

请注意第二个FROM指令——通过简单地将新构建的二进制文件覆盖到常规riscv64/caddy镜像上，生成的镜像要小得多。

https://caddyserver.com/docs/build#xcaddy工具用于https://github.com/caddyserver/caddy/blob/4217217badf220d7d2c25f43f955fdc8454f2c64/cmd/caddy/main.go#L15..L25，包含提供的模块。您可以只指定模块名称，或带版本的名称（用`@`分隔）。您还可以指定要构建的Caddy的特定版本（可以是版本标签或提交哈希）。有关https://github.com/caddyserver/xcaddy#command-usage的更多信息。

请注意，"标准"Caddy模块（https://github.com/caddyserver/caddy/tree/master/modules/standard）始终包含在内。

优雅重载

更改配置时，Caddy不需要完全重启。Caddy附带https://caddyserver.com/docs/command-line#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权限

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

为容器提供此权限是可选的，虽然不太可能，但可能会有https://unix.stackexchange.com/a/508816。

有关更多详情，请参见https://github.com/quic-go/quic-go/wiki/UDP-Buffer-Sizes。

Docker Compose示例

如果您更喜欢使用docker compose运行您的堆栈，以下是一个示例服务定义，位于名为compose.yaml的文件中。该配置假设您按照上文所述将自定义Caddyfile放入$PWD/conf。

yaml
services:
  caddy:
    image: docker.xuanyuan.run/riscv64/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进行优雅重载。

镜像变体

riscv64/caddy镜像有多种版本，每种版本都针对特定用例设计。

riscv64/caddy:<version>

这是默认镜像。如果您不确定自己的需求，可能需要使用此版本。它既可以用作临时容器（挂载源代码并启动容器以启动应用），也可以用作构建其他镜像的基础。

riscv64/caddy:<version>-alpine

此镜像基于流行的https://alpinelinux.org，可在https://hub.docker.com/_/alpine中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是您的主要关注点时，此变体非常有用。需要注意的主要问题是它使用https://musl.libc.org而不是https://www.etalabs.net/compare_libcs.html，因此软件通常会根据其libc要求/假设的深度而遇到问题。有关可能出现的问题以及使用基于Alpine的镜像的一些优缺点比较，请参见此Hacker News评论线程。

为了最小化镜像大小，在基于Alpine的镜像中通常不包含其他相关工具（如git或bash）。使用此镜像作为基础，在您自己的Dockerfile中添加所需的内容（如果不熟悉如何安装软件包，请参见https://hub.docker.com/_/alpine/中的示例）。

许可证

查看此镜像中包含的软件的https://github.com/caddyserver/caddy/blob/master/LICENSE。

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

一些能够自动检测到的其他许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/caddy中。

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