排查集成模式：等待、同步已停止和未触发的重定向

当通过你自己的平台（集成模式）连接的域名无法连接、停止同步或重定向未触发时，请使用此页面。请先在 Hostnames 中打开该域名：其状态和上次检查结果会告诉你从哪里开始。

状态：等待中#

等待中表示 RedirHub 还没有从你域名上的检查路径收到正确的响应。请在浏览器中打开 https://your-domain/_redirhub/check。它应返回一行简短的纯文本，以 token= 开头。

• 404 或你自己的页面： 集成尚未在该主机名上运行。请检查它是否已部署，是否运行在这个准确的主机名上（www 和根域名是分开的），以及你的路由是否允许 /_redirhub/check 通过。
• Next.js： 中间件或代理匹配器必须包含 /_redirhub/check。
• Cloudflare Workers： Worker 路由必须覆盖该主机名，例如 shop.example.com/*。
• 不同的 token： 该集成使用的是另一个域名或工作区的规则地址。请从仪表板重新复制规则地址。
• 什么都没有（超时、错误页）： 该集成还没有下载它的第一个规则文件。在获得规则文件之前，它不会响应检查路径。请在其设置中检查规则地址。

状态：同步已停止#

同步已停止表示你的平台会响应检查路径，但不再运行最新规则：其规则比 RedirHub 发布的更新版本更旧。发生这种情况时，RedirHub 也会给你发送电子邮件。

• 检查集成是否仍能访问规则地址（防火墙、变更的环境变量或已过期的部署通常是原因）。
• 更改设置后重新部署或重启集成。

如果某个域名 7 天内一直不同步，RedirHub 会停用它。修复集成后，域名会在下一次检查时重新连接。

重定向没有生效#

• 等待一分钟。 集成大约每分钟下载一次新规则（Caddy 可在几秒内更新）。
• 在无痕窗口中或使用 curl -I 进行测试。 浏览器会记住 301 重定向，因此你自己的浏览器可能仍显示旧结果。
• 你的网站优先响应。 通配规则只会响应你的网站返回 404 的 URL。若页面存在，则以你的网站为准。请改为对该路径使用精确规则。
• Next.js：先在你的代理中调用 redirects，再处理 rewrites 和语言区域设置。跳过所有带点路径的 matcher 也会跳过诸如 /old.html 之类的规则。next.config 中的重定向会在代理之前运行，并可能覆盖你的规则。Next.js 不会提供通配规则，因为代理无法看到你网站的最终状态。
• 不适用于集成模式： 自定义 HTML、框架重定向、密码保护、已暂停或已过期的链接以及通配域名。包含多个目标的链接会使用其主目标。

访问或 404 不会显示在分析中#

• 报告会使用您工作区的集成密钥发送。请检查该密钥是否已在集成中设置（作为密钥或环境变量），并且它是当前使用的密钥。
• 只有在该域名已开启 404 报告（默认开启）且平台支持该功能时，才会发送 404 报告。
• 报告会在后台以小批量发送，因此在检查前请等待一两分钟。

还卡住吗？#

请将域名、您的平台以及 https://your-domain/_redirhub/check 的返回结果发送给我们。我们会从我们的这边检查集成。