winamd64/caddy

注意：这是 https://hub.docker.com/_/caddy 的 windows-amd64 架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“除 amd64 外的架构？”https://github.com/docker-library/official-images#architectures-other-than-amd64 和官方镜像FAQ中的“镜像源在Git中更改后怎么办？”https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

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

-** 获取帮助 **：
Caddy 社区论坛

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

（参见 FAQ 中的“‘Shared’和‘Simple’标签有什么区别？”https://github.com/docker-library/faq#whats-the-difference-between-shared-and-simple-tags%E3%80%82%EF%BC%89

Simple Tags

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

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

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

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

共享标签

• 2.10.2, 2.10, 2, latest:

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

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

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

• 2.10.2-windowsservercore, 2.10-windowsservercore, 2-windowsservercore, windowsservercore:

  • https://github.com/caddyserver/caddy-docker/blob/5572371a83e48fd0368a4917d0fc48e44ef30582/2.10/windows/ltsc2022/Dockerfile
  • https://github.com/caddyserver/caddy-docker/blob/5572371a83e48fd0368a4917d0fc48e44ef30582/2.10/windows/ltsc2025/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)

!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 \
    winamd64/caddy
...
$ curl http://localhost/
hello world

若要覆盖默认 https://github.com/caddyserver/dist/blob/master/config/Caddyfile%EF%BC%8C%E5%8F%AF%E5%9C%A8 $PWD/conf 子目录中创建 Caddyfile，并将该目录挂载到 /etc/caddy：

console
$ docker run -d -p 80:80 \
    -v $PWD/conf:/etc/caddy \
    -v caddy_data:/data \
    winamd64/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 \
    winamd64/caddy caddy file-server --domain example.com

关键在于 Caddy 需监听 80 和 443 端口（ACME HTTP 挑战必需）。

详见 Caddy 文档 了解自动 HTTPS 支持。

构建自定义 Caddy 镜像

多数生产环境用户不会依赖容器内文件挂载，而是基于 winamd64/caddy 构建自定义镜像：

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

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

添加自定义 Caddy 模块

Caddy 可通过“模块”扩展功能（详见 扩展 Caddy）。可用模块列表见 Caddy 下载页。

可使用 :builder 镜像快速构建包含自定义模块的 Caddy 二进制文件：

Dockerfile
FROM winamd64/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 winamd64/caddy:<version>

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

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

xcaddy 工具用于 https://github.com/caddyserver/caddy/blob/4217217badf220d7d2c25f43f955fdc8454f2c64/cmd/caddy/main.go#L15..L25%EF%BC%8C%E6%94%AF%E6%8C%81%E6%8C%87%E5%AE%9A%E6%A8%A1%E5%9D%97%E5%90%8D%E6%88%96%E5%B8%A6%E7%89%88%E6%9C%AC%E7%9A%84%E6%A8%A1%E5%9D%97%EF%BC%88%E7%94%A8 @ 分隔），也可指定 Caddy 版本（标签或提交哈希）。详见 https://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 reload 命令实现零停机配置重载。

Docker 环境中，推荐通过在运行中的容器内执行 caddy reload 触发重载：

首先获取容器 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 库会尝试增大 socket 缓冲区大小。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: winamd64/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 执行。

镜像变体

winamd64/caddy 镜像提供多种变体，适用于不同场景：

winamd64/caddy:<version>

默认镜像。若不确定需求，建议使用此变体。既可作为临时容器（挂载源码启动），也可作为基础镜像构建其他镜像。

winamd64/caddy:<version>-windowsservercore

基于 https://hub.docker.com/r/microsoft/windows-servercore%E3%80%82%E4%BB%85%E5%9C%A8%E6%94%AF%E6%8C%81%E8%AF%A5%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E7%9A%84%E7%8E%AF%E5%A2%83%E4%B8%AD%E5%8F%AF%E7%94%A8%EF%BC%8C%E5%A6%82 Windows 10 专业版/企业版（周年更新）或 Windows Server 2016。

Windows