統合モード: DNSを変更せずにRedirHubを使う

統合モードは、ドメインの DNS を変更したり DNS レコードを追加したりすることなく、RedirHub にドメインを接続します。サイトは DNS、ホスティング、HTTPS 証明書をそのまま維持します。あなたのプラットフォームは RedirHub からドメインのルールをダウンロードし、ダッシュボードで管理しているリダイレクト、短縮リンク、QR コードリンクを配信し、すべての訪問を返送するため、ドメインは DNS 接続済みドメインと同じダッシュボードと分析に表示されます。

これは、DNS を RedirHub に向けることができない場合のために作られています。DNS が IT 部門やクライアント側にある場合、ドメインですでに公開中のウェブサイトが動いている場合、あるいは自分のページの隣で主ドメイン上に短縮リンクやリダイレクトを置きたい場合です。

仕組み#

1. ルールファイル。 RedirHub は、この方法で接続された各ドメインに対してプレーンテキストのルールファイルを公開します。あなたのプラットフォームはそれを約 1 分に 1 回ダウンロードします（Caddy なら 1〜2 秒以内にプッシュで受け取ることもできます）。そのため、ダッシュボードでの変更は再デプロイなしで本番に反映されます。
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：ルール内のホスト名に対してオンデマンド HTTPS を備えた、あなたのサーバー向けの Caddy モジュールです。オープンソース: redirhub/caddy-redirects。

ルールファイル形式は公開されているため、誰でも別のプラットフォーム向けのクライアントを作成できます: redirhub/integration-spec。

セットアップする#

1. ダッシュボードで、Hostnames の下にドメインを追加し、自分のプラットフォーム経由で接続を選択します。DNSレコードは不要です。
2. プラットフォームを選択します。ダッシュボードには ルールのアドレス とワークスペースの 統合キー が表示され、両方が入力済みのプロンプトも表示されます。
3. そのプロンプトを AI コーディングエージェント（Claude、Cursor、ChatGPT など）に貼り付けるか、プラットフォームの README に従って手動で設定してください。統合キーは秘密にしてください。環境変数またはシークレットに入れ、公開コードには絶対に含めないでください。
4. デプロイします。チェックパスに応答が返るとすぐに、ドメインは Connected に切り替わります。

DNS接続ですか、それとも統合モードですか？#

ドメインがリダイレクトだけを行う場合（予備ドメイン、移転後の古いドメイン）は DNS 接続を使用します。RedirHub のエッジがそれを配信し、HTTPS も処理します。ドメインで既存のウェブサイトをそのまま維持したい場合、または DNS を変更できない場合は統合モードを使用します。

インテグレーションモードでできないこと#

• HTTPS証明書はお使いのプラットフォーム側に残り、RedirHubはそのドメインの証明書を発行しません。
• 各ドメインには最大50,000件のリダイレクトルールを保持できます。ワイルドカードドメインはサポートされていません。
• カスタムHTML、フレームリダイレクト、パスワード保護、停止中または期限切れのリンクは適用されません。複数の宛先を持つリンクは、その主な宛先を使用します。

インテグレーションモードはCore、Pro、Enterpriseに含まれます。この方法で提供されるリダイレクトは、RedirHubのエッジで提供されるリダイレクトと同様に、プランの月間訪問数にカウントされます。