Q: 为什么Caddy的http.request.proto占位符返回HTTP/2.0而不是HTTP/2？

该占位符暴露了 Go 的 http.Request.Proto，其格式为 HTTP/ . 。对于 HTTP/2 和 HTTP/3，Go 内部机制及 quic-go 库会生成 'HTTP/2.0' 和 'HTTP/3.0'，以保持与 CGI/FCGI（例如 SERVER_PROTOCOL）的兼容性。作为临时解决方案，可使用 Caddyfile 的 map 指令来重命名这些值：`map {http.request.proto} {proto_name} { HTTP/2.0 HTTP/2 HTTP/3.0 HTTP/3 default {http.request.proto} }`。未来可能会提供专用占位符（例如 http.request.proto.name）以返回符合规范的协议名称。

Question 1

为什么Caddy下载页面安装的是Hetzner DNS模块的版本1而不是版本2？

Accepted Answer

Caddy 下载页面显示的是包维护者通过 pull request 提交的最新版本。在维护者将条目更新指向 v2 之前，用户可以通过以下方式绕过下载页面：使用 xcaddy 构建 `xcaddy build --with github.com/caddy-dns/hetzner/v2`，或使用 `caddy add-package` 命令：`caddy add-package github.com/caddy-dns/hetzner/v2`。这将确保包含 v2 模块。

Question 2

如何将客户端IP传递给on_demand_tls ask端点以进行速率限制和滥用防护？

Accepted Answer

Caddy 原生不传递客户端 IP，但你可以实现一个自定义权限模块。在该模块中，从请求上下文中获取远程 IP（例如参见 automation.go#L325），并将其包含在你向 ask 端点发起的调用中（例如作为查询参数添加）。然后在后端处理速率限制。完整文档：https://caddyserver.com/docs/caddyfile/options#on-demand-tls

Question 3

如何使用Caddy管理自定义DNS区域记录？

Accepted Answer

使用外部插件 caddy-zone-manager (github.com/infogulch/caddy-zone-manager)。该插件允许在 Caddyfile 中定义任意 DNS 记录，并将其同步到支持的 DNS 提供商。使用 xcaddy 构建包含该插件的 Caddy：`xcaddy build --with github.com/infogulch/caddy-zone-manager`。请注意，该插件不包含在官方 Caddy 发行版中，应谨慎使用，尤其是在记录所有权和删除模式方面。该插件支持 log_only、append_set 和 append_set_delete 等模式来控制同步行为。

Question 4

为什么Caddy的http.request.proto占位符返回HTTP/2.0而不是HTTP/2？

Accepted Answer

该占位符暴露了 Go 的 http.Request.Proto，其格式为 HTTP/.。对于 HTTP/2 和 HTTP/3，Go 内部机制及 quic-go 库会生成 'HTTP/2.0' 和 'HTTP/3.0'，以保持与 CGI/FCGI（例如 SERVER_PROTOCOL）的兼容性。作为临时解决方案，可使用 Caddyfile 的 map 指令来重命名这些值：`map {http.request.proto} {proto_name} { HTTP/2.0 HTTP/2 HTTP/3.0 HTTP/3 default {http.request.proto} }`。未来可能会提供专用占位符（例如 http.request.proto.name）以返回符合规范的协议名称。

Question 5

为什么Caddy不缓存通过get_certificate获取的外部管理的证书，我该如何启用缓存？

Accepted Answer

使用 `get_certificate http://...` 时，Caddy 会将证书视为外部管理且不进行缓存，因为缓存和续期逻辑应由证书管理器负责。若需引入缓存功能，请实现一个自定义的 certmagic.Manager 模块。基于现有的 HTTP 管理器（参见 Caddy 仓库中的 modules/caddytls/certmanagers.go）进行实现，并添加缓存层。然后将 Caddy 配置为使用自定义管理器而非默认的 `get` 模块。这样，Caddy 就能缓存并复用证书，而无需在每次请求时从你的端点获取。

caddy

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐