統合モードのトラブルシューティング: Waiting、同期停止、そして発火しないリダイレクト

このページは、ご自身のプラットフォーム経由で接続したドメイン（統合モード）が接続できない、同期が止まった、またはリダイレクトが発火しない場合に使用します。まず Hostnames でそのドメインを開いてください。ステータスと直近のチェック結果が、どこから始めるべきかを示します。

ステータス: 保留中#

保留中とは、RedirHub がまだあなたのドメインのチェックパスから正しい応答を受け取っていないことを意味します。ブラウザで https://your-domain/_redirhub/check を開いてください。token= で始まる短いプレーンテキストの行が返るはずです。

• 404 または自分のページ: そのホスト名ではまだ統合が実行されていません。デプロイされていること、このホスト名で正確に動作していること（www とルートドメインは別扱いです）、そしてルートが /_redirhub/check を通していることを確認してください。
• Next.js: ミドルウェアまたはプロキシの matcher に /_redirhub/check を含める必要があります。
• Cloudflare Workers: Worker ルートがホスト名をカバーしている必要があります。たとえば shop.example.com/* です。
• 別のトークン: 統合が別のドメインまたはワークスペースの rules アドレスを使用しています。ダッシュボードから rules アドレスをもう一度コピーしてください。
• 何も起こらない場合（タイムアウト、エラーページ）: 統合はまだ最初の rules ファイルをダウンロードしていません。1つ取得するまでは、チェックパスに応答しません。設定で rules アドレスを確認してください。

ステータス: 同期停止#

同期停止とは、あなたのプラットフォームはチェックパスに応答しているものの、最新のルールを実行していないことを意味します。つまり、そのルールは RedirHub が公開したものより古くなっています。この場合、RedirHub からメールも送信されます。

• 統合がまだルールのアドレスに到達できることを確認してください（通常の原因は、ファイアウォール、変更された環境変数、または期限切れのデプロイです）。
• 設定を変更した後、統合を再デプロイするか再起動してください。

ドメインが7日間同期されない場合、RedirHub はそれを無効化します。統合を修正すると、次回の確認時にドメインが再接続されます。

リダイレクトが発火しない#

• 1分ほど待ってください。 統合は約1分ごとに新しいルールをダウンロードします（Caddy は数秒以内に更新できます）。
• プライベートウィンドウまたは curl -I でテストしてください。 ブラウザは301リダイレクトを記憶するため、あなたのブラウザでは古い結果が表示されることがあります。
• サイトの応答が優先されます。 キャッチオールルールは、サイトが404を返すURLにのみ応答します。ページが存在する場合は、サイトが優先されます。その代わりに、そのパス用の正確なルールを使用してください。
• Next.js: リダイレクトは、リライトやロケール処理の前に、プロキシ内で最初に呼び出してください。ドットを含むすべてのパスを除外するマッチャーは、/old.html のようなルールも除外してしまいます。next.config のリダイレクトはプロキシより前に実行され、あなたのルールを上書きする可能性があります。Next.js はキャッチオールルールを提供しません。プロキシはサイトの最終ステータスを見ないためです。
• 統合モードでは適用されません: カスタムHTML、フレームリダイレクト、パスワード保護、一時停止中または期限切れのリンク、およびワイルドカードドメイン。複数の宛先を持つリンクでは、メインの宛先が使用されます。

訪問数や404は分析に表示されません#

• レポートは、ワークスペースの統合キーで送信されます。キーが統合に設定されていること（シークレットまたは環境変数として）、そしてそれが現在のキーであることを確認してください。
• 404レポートは、そのドメインで404レポートが有効になっている場合（デフォルトでは有効です）にのみ送信され、プラットフォームがそれをサポートしている必要があります。
• レポートはバックグラウンドで少量ずつ送信されるため、確認する前に1〜2分お待ちください。

まだ解決しませんか？#

ドメイン、お使いのプラットフォーム、そしてhttps://your-domain/_redirhub/checkの返り値をお知らせください。こちらで統合を確認します。