サポートSelf-Hosted Edge

セルフホストエッジを設定する:お客様自身のサーバーでHTTPSとリダイレクトを

簡単な答え

セルフホストエッジアドオン付きでProのトライアルを開始するか、Proにアドオンを追加します。ドメインを「自分のサイトの HTTPS」として追加し、その設定画面に表示されるコンテナを各サーバーで実行して、ドメインのAまたはAAAAレコードをそれらのサーバーに向けます。サーバーが応答するとRedirHubが証明書を発行し、以降は更新も行い、サーバーが応答しなくなったときはメールでお知らせします。ドメインに追加したリンクも、お客様のサーバー上でリダイレクトされます。

セルフホストエッジでは、ドメインのHTTPSはお客様自身のサーバー上、アプリケーションの前に置くコンテナで終端されます。RedirHubが各ドメインの証明書を発行・更新し、すべてのサーバーに同期するため、ACMEクライアントや更新ジョブを運用する必要はありません。訪問者はお客様のサーバーに直接届き、RedirHubを経由することはありません。

同じコンテナが、RedirHub自身のネットワークと同じように、ドメインに追加したすべてのリンクを配信します。リダイレクト、短縮リンク、QRコード、カスタムHTMLページ、パスワード付きリンクです。パスのリンクはアプリケーションが応答する前にリダイレクトし、キャッチオールはアプリケーションの404だけを引き受け、訪問と404はAnalyticsに表示されます。HTTPSだけでよければ、リンクを追加しなければすべてのリクエストがアプリケーションに届きます。

始める前に#

  • Dockerが動作し、インターネットから443番ポートで到達できるサーバー。80番ポートは引き続きアプリケーションが使います。
  • サーバーの80番ポートで平文のHTTPに応答するアプリケーション、またはCaddyやnginxなどのプロキシ。別のポートでも、1つ設定するだけで使えます。
  • ワークスペースのマネージャーロール。ワークスペースのサーバートークン入りのコマンドを見られるのはマネージャーだけです。

ステップ1:セルフホストエッジアドオンを入手する#

セルフホストエッジはProのアドオンで、最大100台のサーバーで$100/月です。Enterpriseでは契約で定めます。

  • RedirHubを初めてご利用の場合:セルフホストエッジ付きでProのトライアルを開始してください。14日間無料です。開始にはカードが必要ですが、トライアル終了までは一切請求されません。
  • すでにProのトライアル中の場合:ダッシュボードでプランにアドオンを追加します。トライアルはそのまま続き、アドオンはトライアル終了まで無料で、その後はProと一緒に請求されます。
  • 有料のProをご利用の場合:ダッシュボードでプランに追加します。ワークスペースにまだアドオンがない場合は、「ドメインを追加」と「接続」のダイアログでも価格とあわせて表示されます。

ステップ2:ドメインを追加する#

  1. 「ホスト名」を開き、「ドメインを追加」をクリックします。
  2. ドメインまたはサブドメインを入力します(例:app.example.com)。
  3. 「何に使いますか?」で「自分のサイトの HTTPS」を選び、「追加してサーバーを設定」をクリックします。続いて設定画面が開きます。

すでに追加済みのドメインの場合は、「接続」を開いて「自分のサーバーで」の「自分のサーバーを使う」を選びます。APIまたはMCPサーバーでは、connection_modeをself_hostedにしてドメインを作成します。Terraformプロバイダー(redirhub/redirhub 0.2.0以降)では、redirhub_domainにconnection_modeを設定します。後から変更すると、ドメインを作り直さずにそのまま切り替わります。

hclresource "redirhub_domain" "shop" {
  host            = "shop.example.com"
  connection_mode = "self_hosted"
}

# Waits until your servers answer for it; its certificate follows.
resource "redirhub_domain_verification" "shop" {
  host = redirhub_domain.shop.host
}

ステップ3:各サーバーでコンテナを実行する#

設定画面の「サーバーで行うこと」にはコンテナの動作が一覧され、それに合わせてコマンドが作成されます。ドメインのリンク、アプリケーションの404レポート、80番ポートからHTTPSへの転送、アプリケーションが待ち受けるポートです。サーバートークンが入ったコマンドをコピーし、各サーバーで実行します。

bashdocker run -d --name redirhub-edge --restart unless-stopped --network host \
  -v redirhub-edge:/data \
  -e REDIRHUB_TOKEN=<your server token> \
  redirhub/edge

コンテナは443番ポートを使い、すべてのリクエストを80番ポートのアプリケーションに渡します。アプリケーションはこれまでどおり配信を続けます。すべてのサーバーで同じトークンで同じコマンドを実行してください。コンテナが起動すると、各サーバーが「あなたのサーバー」に表示されます。イメージを更新するときはボリュームを残してください。サーバーのID、証明書、リンクの最新のコピーが保存されています。

コンテナが -e NAME=value の形式で読み込む設定。必須なのはトークンだけです。
設定デフォルト内容
REDIRHUB_TOKENなし(必須)ワークスペースのサーバートークン。サーバーがワークスペースの証明書とリンクを取得し、各ドメインを証明することだけを許可します。
UPSTREAMhttp://127.0.0.1:80アプリケーションが待ち受ける場所。別のポートのアプリケーションなら:-e UPSTREAM=http://127.0.0.1:8080。
PORT_HTTPS443コンテナがHTTPSに使うポート。443番ポートをこのポートに転送するTCPロードバランサーの背後でのみ変更してください。Let’s Encryptと当社のチェックは443番でドメインにアクセスします。
PORT_HTTPoff平文のHTTP用のポート(例:80)。offなら80番ポートはアプリケーションに残ります。
ALWAYS_HTTPSonPORT_HTTPへの平文HTTPの扱い。onはHTTPSへ転送(301)し、offはHTTPSと同じように配信します(リンク、次にアプリケーション)。
LINKSonoffにするとこれらのサーバーではリンクを配信しません。HTTPSのみで、すべてのリクエストがアプリケーションに届きます。
REPORT_404onoffにすると、これらのサーバーからアプリケーションの404を一切報告しません。
PORT_HEALTHoffロードバランサーのヘルスチェック用ポート。サーバーが証明書を保持すると、GET /readyが200を返します。
PROXY_PROTOCOLoffPROXYプロトコルを送るTCPロードバランサーの背後で使います。そのアドレスまたは範囲(例:10.0.0.0/8)を指定すると、アプリケーションに訪問者のアドレスが届きます。

リクエストがアプリケーションに届く方法を変えるには、独自のファイルを/etc/edge/にマウントします。proxy.confは生成されたプロキシ設定を置き換え、http.d/とserver.d/内のファイルはhttpブロックと各ドメインのサーバーに追加されます(例:複数のアプリサーバーを持つupstreamやHSTSヘッダー)。コンテナは起動前にこれらを確認し、読み込めない行を示します。

ステップ4:DNSをサーバーに向ける#

  • DNSプロバイダーで、ドメインのA(およびAAAA)レコードをサーバーのアドレスに設定します。
  • wwwも同じサーバーに向ければ、証明書はwwwもカバーします。
  • *.example.comのようなワイルドカードでは、設定画面に表示されるCNAMEレコードも追加します。ワイルドカードがお客様のものであることを証明し、証明書を発行できるようにします。ワイルドカードには証明書のみで、リンクは使えません。

その後、当社がサーバーを確認します。HTTPSでの/.well-known/host-verificationへの応答が、ドメインがお客様のものであることの証明になります。この応答はコンテナが自動で行います。当社が証明書を発行してすべてのサーバーに同期し、設定画面にサーバーがその証明書でHTTPSを配信していることが表示されます。更新やリンクの変更は数秒以内に自動で届きます。

サーバー上のリダイレクトと404#

  • パスのリンクはアプリケーションより先にリダイレクトします。ページが存在する場合も同じです。アプリケーションをリリースし直さずにページを停止したり移動したりするには、RedirHubでリンクを追加します。
  • キャッチオールはアプリケーションの404だけを引き受けます。正常に動いているページが置き換わることはなく、アプリケーションにもうないページはキャッチオールの指定先に移動します。
  • アプリケーションの404は報告され、リンクへの訪問とあわせてAnalyticsに表示されます。404レポートは、RedirHubでドメインごとに、またはサーバーでREPORT_404=offを設定してオフにできます。
  • すべての種類のリンクがサーバー上で動作します。コンテナはRedirHubのネットワークと同じリダイレクターを実行するため、カスタムHTMLページ、フレームリダイレクト、パスワード付きリンクはRedirHubのDNS上とまったく同じように動作します。リンクの追加・変更・一時停止は、数秒以内にすべてのサーバーに届きます。

RedirHubに接続できない場合も、サーバーは手元にある証明書とリンクで配信を続けます。

監視#

当社はサーバー上のすべてのドメインを定期的に確認し、対応が必要なときはワークスペースのオーナーとマネージャーにメールでお知らせします。

  • サーバーが応答しなくなった場合:あるドメインについてどのサーバーも1時間応答しないと、影響を受けるすべてのドメインを記載したメールを1通お送りします。7日間応答がないままならドメインは解放され、もう1通メールが届きます。コンテナを再起動すれば自動的に再接続します。
  • 証明書を更新できない場合:更新は有効期限の数週間前に始まり、自動で再試行されます。証明書の残りが14日になってもLet’s Encryptが443番ポートでコンテナに到達できない場合は、期限切れの日付を記載したメールを1日に最大1通お送りします。

これらはドメインのステータスメールです。「メール設定」でオフにできます。

設定画面に問題が表示された場合#

メッセージ意味対処法
ポート 443 に接続できませんでしたドメインが443番ポートで稼働中のコンテナに届いていません。AまたはAAAAレコードがサーバーを向いているか、コンテナが実行中か(docker ps)、ファイアウォールが443番ポートを許可しているかを確認してください。
ポート 443 は応答しましたが、このワークスペースのトークンではありませんでした443番ポートで別の何かが応答しているか、コンテナが別のトークンで起動されています。別のHTTPSサーバーを停止するか、コンテナの背後の80番ポートに移し、設定画面に表示されたトークンでコンテナを起動してください。
CNAME レコードがまだ見つかりませんワイルドカードのCNAMEレコードがないか、まだ反映されていません。表示されたとおり正確にレコードを追加してください。DNSの変更が反映されるまで数分かかることがあります。
このワークスペースには自前のサーバーが含まれなくなりましたアドオンがプランから削除されました。1週間以内にセルフホストエッジをプランに再度追加してください。それを過ぎるとドメインは解放されます。

トークンを再発行する#

トークンが漏洩した場合は、ドメインの設定画面で「トークンを再発行」をクリックし、すべてのサーバーで新しいトークンを使ってコンテナを再起動します。古いトークンのままのサーバーには、証明書もリンクの変更も届かなくなります。使わなくなったサーバーは「あなたのサーバー」から削除してください。

セルフホストエッジを無料で試す セルフホストエッジ付きでProを開始:14日間無料、最大100台のサーバー、証明書の発行と更新はお任せで、リンクもお客様のサーバーから配信されます。

無料トライアルを開始

よくある質問

いいえ。TLSはお客様のサーバー上のコンテナで終端し、コンテナがリンクに応答して、それ以外のリクエストはすべてアプリケーションに渡します。RedirHubは証明書を発行・更新し、証明書とリンクをすべてのサーバーに同期して、訪問数と404の件数を受け取ります。

はい。80番ポートで平文のHTTPを配信させ、443番ポートはコンテナに任せてください。コンテナがすべてのリクエストを渡します。これらのドメインでは、Caddyやnginx自身の証明書とHTTPからHTTPSへのリダイレクトをオフにしてください。

はい。アドオン付きでトライアルを開始するか、トライアル中に追加した場合は含まれます。トライアル終了までは無料で、その後はProとあわせて$100/月で請求されます。

サーバーは手元にあるものでHTTPSとリンクの配信を続けます。証明書は有効期限のかなり前に更新されるため、短時間の障害で証明書が切れることはありません。

はい。ドメインにリンクを追加しないか、-e LINKS=offでコンテナを起動すれば、すべてのリクエストがアプリケーションに届きます。404レポートは-e REPORT_404=offでオフにできます。

ワークスペースあたり最大100台で、任意のリージョンやクラウドで利用できます。それ以上必要な場合は、Enterpriseについてご相談ください。価格は契約で定めます。