返回变更日志November 6, 2026

Caddy 官方插件:集成模式,内置于 Caddy

RedirHub + Caddy: RedirHub Integration Mode is now an official Caddy plugin

Caddy serves the redirects. RedirHub keeps the rules and the analytics.

当我们推出 集成模式 时,就说过会有更多官方插件陆续上线。第一个已经来了:caddy-redirects 现在是官方 Caddy 插件,已列在 Caddy 自己的下载页面上。

如果你的域名指向你自己的 Caddy 服务器,它们可以继续留在那里。Caddy 会提供你在 RedirHub 中管理的重定向、网站迁移、品牌短链接和二维码,并将每次重定向结果回传,因此分析、过滤器和链接历史的工作方式与通过 DNS 连接的域名完全一致。

你将获得#

  • 几秒内完成变更。 当你编辑链接时,RedirHub 会通知 Caddy,Caddy 会立即获取新规则。无需编辑 Caddyfile,也无需重载。如果通知偶尔丢失,Caddy 仍会每分钟检查一次变更。
  • 404 监控。 Caddy 也会报告你的网站返回的 404,因此在访客发现坏链之前,它们就会出现在分析中。
  • 你的网站仍然拥有控制权。 具体的重定向会优先于你自己的页面。只有当你的网站本身返回 404 时,域名级的兜底规则才会生效,因此它绝不会接管一个正常工作的页面。
  • 重启后即可就绪。 Caddy 会把你规则的最后一份有效副本保存在磁盘上,因此即使规则无法获取,它也能在重启后立即进行重定向。
  • 仅在你需要的地方使用 HTTPS。 使用按需 TLS 时,Caddy 只会为你规则中的主机名获取证书。

开始设置#

  1. 使用该插件获取 Caddy:在 Caddy 的下载页面 选择 github.com/redirhub/caddy-redirects,或者使用 xcaddy build --with github.com/redirhub/caddy-redirects 自行构建。
  2. 在 RedirHub 中,打开集成密钥面板并复制你的工作区规则地址和集成密钥。
  3. 在 Caddyfile 中为你的网站添加一个 redirects 块,并填写你的 rules_url 和 key。一个工作区规则地址可覆盖该服务器运行的所有域名。
  4. 在 RedirHub 中,将域名设置为使用你自己的平台。Caddy 会在你的域名上响应检查路径,RedirHub 会将其显示为已连接。

开源#

该插件基于 Apache-2.0 许可开源,其规则格式也是如此。源代码、完整的 Caddyfile 示例和发行说明都在 GitHub 上;模块参考文档在 Caddy 的文档 中。

Caddy 官方插件:集成模式,内置于 Caddy - 更新日志 - RedirHub