集成模式：无需更改 DNS 即可使用 RedirHub

集成模式将域名连接到 RedirHub，而无需更改其 DNS 或添加任何 DNS 记录。您的站点会保留自己的 DNS、托管和 HTTPS 证书。您自己的平台会从 RedirHub 下载该域名的规则，提供您在控制面板中管理的重定向、短链接和二维码链接，并回传每一次访问，因此该域名会像 DNS 连接的域名一样出现在同一控制面板和分析中。

它适用于无法将 DNS 指向 RedirHub 的情况：DNS 由 IT 或客户管理，域名已经在运行一个现有网站，或者您希望在自己的主域名上把短链接和重定向与自己的页面并列使用。

工作原理#

1. 规则文件。 RedirHub 会为以这种方式连接的每个域名发布一个纯文本规则文件。您的平台大约每分钟下载一次（Caddy 也可以在一两秒内通过推送获取），因此控制面板中的更改无需重新部署即可生效。
2. 检查路径。 您的平台会在该域名上响应 /_redirhub/check。第一次正确响应即可证明该域名属于您并完成连接；RedirHub 会持续调用它，以查看您的平台是否在运行最新规则。
3. 重定向。 精确规则会在您网站自身路由之前进行重定向。兜底规则只会响应您网站返回 404 的 URL，因此正常可用的页面不会被接管。
4. 报告。 每次重定向都会在后台上报，不会延迟访客。对于平台支持的情况，您网站返回的 404 也会一并上报，因此迁移后失效链接也会显示出来。

如果 RedirHub 无法访问，您的平台会保留上一次下载的规则并继续重定向。集成采用失败开放：错误不会破坏页面。

支持的平台#

• Cloudflare Workers：位于源站前面的 Worker。开源：redirhub/cloudflare-redirects。
• Next.js（在 Vercel 上或通过 next start 自托管）：运行在你的代理或中间件中。开源：redirhub/nextjs-redirects。
• Caddy：适用于你自己的服务器的 Caddy 模块，为规则中的主机名提供按需 HTTPS。开源：redirhub/caddy-redirects。

规则文件格式是开放的，因此任何人都可以为其他平台编写客户端：redirhub/integration-spec。

进行设置#

1. 在仪表板中，在 Hostnames 下添加域名，并选择通过你自己的平台连接。无需 DNS 记录。
2. 选择你的平台。仪表板会显示规则地址和你工作区的集成密钥，并提供一个已填写好这两项的提示。
3. 将提示粘贴到你的 AI 编码代理（Claude、Cursor、ChatGPT 等）中，或者手动按照平台的 README 操作。请保密集成密钥：它应放在环境变量或密钥中，绝不能出现在公开代码里。
4. 部署。只要检查路径有响应，域名就会切换为已连接。

DNS 连接还是集成模式？#

当域名只用于重定向时使用 DNS 连接（例如备用域名、迁移后保留的旧域名）：由 RedirHub 的边缘网络提供服务并为你处理 HTTPS。若域名已经在运行你想保留的网站，或你无法更改其 DNS，则使用集成模式。

集成模式不做什么#

• HTTPS 证书保留在您的平台上；RedirHub 不会为该域名签发证书。
• 每个域名最多可包含 50,000 条重定向规则。不支持通配符域名。
• 自定义 HTML、框架重定向、密码保护以及已暂停或已过期的链接都不会生效。包含多个目标的链接将使用其主要目标。

Core、Pro 和 Enterprise 套餐都包含集成模式。通过这种方式提供的重定向会计入套餐的每月访问量，与通过 RedirHub 边缘提供的重定向相同。