zxavier/caddy repository overview

⁠caddy2-docker

这是一个 caddy2 docker image，编译加入了如下组件：

• caddy-dns/cloudflare⁠
• caddy-dns/duckdns⁠
• spaaleks/caddy-dns-technitium⁠
• hairyhenderson/caddy-teapot-module⁠
• mholt/caddy-l4⁠
• • ueffel/caddy-brotli⁠ (chrome 已支持 zstd 许久, zstd 在同等压缩率下相比 br 性能更好, 在 2.11 版本中已经去除该组件)
• mastercactapus/caddy2-proxyprotocol⁠
• caddyserver/nginx-adapter⁠ (在 2.4 版本中已经去除该组件)
• greenpau/caddy-security⁠ (由于使用了 authelia⁠ , 故在 2.7.4 版本中已经去除该组件)

⁠已知的问题

• s390x 编译问题已经得到解决，见 feat: add linux/s390x builds⁠ 从 2.4.6 版本开始提供 s390x 的 image。buildx 编译 golang，在 s390x 上存在问题，见：issues/40949⁠。故暂停创建 s390x 的 image。

• 不允许使用 Token，更新 DockerHub 存储库描述。 见：issues/1927⁠,issues/1914⁠,issues/115⁠

• 暂不提供 macOS 与 Windows 版 image

⁠说明

• 建议使用 latest 版本，与 caddy 的 latest 版本相同。

• 同时提供 Docker Hub 与 Github 的 package 地址。Docker Hub:hub.docker.com/r/zxavier/caddy⁠, Github 容器地址：ghcr.io/z-xavier/caddy⁠，两地址版本号相同。

• ⚠️mainline 版本为最新发布版，包括 rc 与 bate 版，故请在低风险环境中使用。

• v2.3.0 版本以及后续版本提示如下：

  1. 设置：net.core.rmem_max。这个值在 linux 上很小，对于高带宽 quic 传输来说需要调整大一些。看这里：quic-go/wiki/UDP-Receive-Buffer-Size⁠。其对应的在 caddy 日志的提示如下：

     failed to sufficiently increase receive buffer size (was: 208 kiB, wanted: 2048 kiB, got: 416 kiB). See https://github.com/lucas-clemente/quic-go/wiki/UDP-Receive-Buffer-Size⁠ for details.

     1. 针对，Linux 调整（Docker的host模式）可参考连接中的内容。并可创建 /etc/sysctl.d/99-buffer-size.conf, 并在其中加入。使得其在重启后也保持生效。

         net.core.rmem_max = 7500000
         net.core.wmem_max = 7500000
     

     Copy
     1. 对于 docker-compose 调整见这里：compose-file-v2/sysctls⁠，需要 V2.1 以上版本的 compose。对于 docker run 调整见这里：docker-run/sysctls⁠。

  2. remote_ip 默认情况下，匹配器不再读取 X-Forwarded-For 标头。这是未记录的行为，并且是不安全的默认值。如果您碰巧依赖于此，请启用 forwarded（在 Caddyfile 中，仅将其 forwarded 作为范围之前的第一个参数）以保持该行为。

⁠鸣谢

• caddy⁠
• xcaddy⁠
• caddy-docker⁠
• caddy-dns/cloudflare⁠
• caddy-dns/duckdns⁠
• spaaleks/caddy-dns-technitium⁠
• hairyhenderson/caddy-teapot-module⁠
• mholt/caddy-l4⁠

⁠License

Apache License 2.0⁠