返回变更日志November 6, 2026
Caddy 官方插件:集成模式,内置于 Caddy

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 只会为你规则中的主机名获取证书。
开始设置#
- 使用该插件获取 Caddy:在 Caddy 的下载页面 选择 github.com/redirhub/caddy-redirects,或者使用
xcaddy build --with github.com/redirhub/caddy-redirects自行构建。 - 在 RedirHub 中,打开集成密钥面板并复制你的工作区规则地址和集成密钥。
- 在 Caddyfile 中为你的网站添加一个
redirects块,并填写你的rules_url和key。一个工作区规则地址可覆盖该服务器运行的所有域名。 - 在 RedirHub 中,将域名设置为使用你自己的平台。Caddy 会在你的域名上响应检查路径,RedirHub 会将其显示为已连接。
开源#
该插件基于 Apache-2.0 许可开源,其规则格式也是如此。源代码、完整的 Caddyfile 示例和发行说明都在 GitHub 上;模块参考文档在 Caddy 的文档 中。
