直接回答
Pro のトライアルを Self-Hosted TLS アドオン付きで開始するか、Pro に追加してください。次に、ドメインを「Only HTTPS, on my own servers」として追加し、各サーバー上でセットアップからコンテナを実行し、ドメインの A または AAAA レコードをそれらに向けます。RedirHub は、サーバーがそのドメインへの応答を返し次第証明書を発行し、その後は継続的に更新します。
Self-Hosted TLS を使用すると、あなたのドメインの HTTPS は、アプリケーションの前面に配置されたコンテナ内で、自分のサーバー上で終端されます。RedirHub は各ドメインの証明書を発行し、更新して各サーバーに同期するため、ACME クライアントや更新ジョブを実行する必要はありません。訪問者のリクエストはそのままあなたのサーバーに送られ、RedirHub を経由しません。
このモードのドメインは HTTPS のみです。RedirHub はその上でリダイレクトや短縮リンクを提供しません。
始める前に#
- Docker を備えたサーバーで、ポート 443 でインターネットから到達可能であること。ポート 80 はアプリケーション側で使用します。
- サーバーのポート 80 で通常の HTTP に応答する、あなたのアプリケーション、または Caddy や nginx のようなプロキシ。別のポートでも、1 つの設定で動作します。
- ワークスペース内のマネージャー権限: ワークスペーストークン付きのコマンドを見られるのはマネージャーだけです。
ステップ 1: Self-Hosted TLS アドオンを入手する#
Self-Hosted TLS は Pro のアドオンで、100 サーバーまで月額 $100 です。Enterprise では、契約で定められます。
- RedirHubを初めてご利用の方へ: Self-Hosted TLSでProトライアルを始めましょう。14日間無料です。開始にはカードが必要ですが、トライアル終了前に請求されることはありません。
- すでにProトライアル中の方へ: ダッシュボードでプランにアドオンを追加してください。トライアルはそのまま継続され、アドオンは終了時まで無料で、その後はProとあわせて請求されます。
- 有料のProをご利用中の方へ: ダッシュボードでプランに追加してください。ワークスペースにまだ含まれていない場合は、Add domainとConnectのダイアログでも価格付きで案内されます。
ステップ2: ドメインを追加する#
- Hostnamesに移動し、Add domainをクリックします。
- ドメインまたはサブドメインを入力します。例: app.example.com。
- 「What will you use it for?」の下で「Only HTTPS, on my own servers」を選び、「Add and set up servers」をクリックします。次にセットアップが開きます。
すでに追加済みのドメインの場合は、Connectを開き、他の接続方法の下にある「Use my own servers」を選択します。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: 各サーバーでコンテナを実行する#
セットアップでは、あなたのワークスペーストークンが入力された状態のコマンドが表示されています。これをコピーして、各サーバーで実行してください:
bashdocker run -d --name redirhub-edge --restart unless-stopped --network host \
-v redirhub-edge:/data \
-e REDIRHUB_TOKEN=<your workspace token> \
redirhub/edgeコンテナはポート443を受け取り、すべてのリクエストをポート80で動作しているあなたのアプリに渡します。アプリはこれまでどおり提供され続けます。同じトークンを使って同じコマンドを各サーバーで実行してください。各コンテナが起動すると、それぞれが「Your servers」に表示されます。イメージを更新するときはボリュームを保持してください。そこにはサーバーの識別情報と証明書が保存されています。
| Setting | Default | その動作 |
|---|---|---|
| REDIRHUB_TOKEN | なし(必須) | あなたのワークスペーストークンです。サーバーはこれを使って、ワークスペースの証明書のみを取得し、その他のことは行わず、あなたの各ドメインを証明します。 |
| UPSTREAM | http://127.0.0.1:80 | アプリが待ち受けている場所です。別のポートで動作するアプリの場合は、-e UPSTREAM=http://127.0.0.1:8080 を追加してください。 |
| HTTPS_PORT | 443 | コンテナが HTTPS に使用するポートです。443 をこのポートへそのまま通すロードバランサーの背後でのみ変更してください。Let’s Encrypt と当社のチェックは 443 であなたのドメインに到達します。 |
| HTTP_PORT | off | 通常の HTTP 用のポートです。オフにすると、ポート 80 はあなたのアプリに残ります。 |
| HTTP_MODE | redirect | HTTP_PORT の通常の HTTP の扱いです。redirect は HTTPS にリダイレクトし、proxy はそれをあなたのアプリに渡します。 |
ステップ 4: DNS をサーバーに向ける#
- DNS プロバイダーで、ドメインの A(および AAAA)レコードをサーバーのアドレスに設定してください。
- www も同じサーバーに向けてください。そうすれば、その証明書にも www が含まれます。
- *.example.com のようなワイルドカードの場合は、セットアップで表示される CNAME レコードも追加してください。これによりワイルドカードがあなたのものであることを証明し、証明書を発行できます。
その後、当社がサーバーを確認します。HTTPS 上の /.well-known/host-verification での最初の応答が、ドメインがあなたのものであることを証明します。コンテナがそれに自動で応答します。証明書を発行して各サーバーに同期し、セットアップではその証明書でサーバーが HTTPS を提供していることが表示されます。更新も自動で届きます。
セットアップに問題が表示される場合#
| Message | 意味 | Fix |
|---|---|---|
| ポート443に接続できませんでした | そのドメインは、ポート443で実行中のコンテナに到達していません。 | AレコードまたはAAAAレコードがサーバーを指していること、コンテナが実行中であること、そしてファイアウォールがポート443を許可していることを確認してください。 |
| ポート443は応答しましたが、このワークスペースのトークンではありませんでした | ポート443では別の何かが応答しているか、コンテナが別のトークンで起動されています。 | 別のHTTPSサーバーを停止するか、コンテナの背後でポート80に移動し、セットアップに表示されるトークンでコンテナを起動してください。 |
| まだCNAMEレコードが見つかりません | ワイルドカードのCNAMEレコードが存在しないか、まだ伝播していません。 | レコードを表示どおりに正確に追加してください。DNSの変更が反映されるまで数分かかる場合があります。 |
| このワークスペースにはもう独自のサーバーは含まれていません | アドオンはプランから削除されました。 | 1週間以内にSelf-Hosted TLSをプランに再度追加してください。それ以降はドメインが解放されます。 |
トークンを置き換える#
トークンが漏えいした場合は、ドメインの設定で「トークンを置き換える」をクリックし、その後すべてのサーバーで新しいトークンを使ってコンテナーを再起動してください。古いトークンを保持しているサーバーは証明書の受信を停止します。もう使用しないサーバーは「あなたのサーバー」から削除してください。
Self-Hosted TLSを無料で試す Self-Hosted TLS付きのProを開始しましょう。14日間無料、最大100台のサーバーまで、証明書の発行と更新を自動で行います。
無料トライアルを開始よくある質問
いいえ。TLS はあなたのサーバー上のコンテナで終端され、そこから各リクエストがアプリケーションへ渡されます。RedirHub は証明書の発行と更新のみを行い、すべてのサーバーを同期状態に保ちます。
はい。ポート 80 では通常の HTTP を提供させ、ポート 443 はコンテナに任せて、そこに各リクエストを渡します。これらのドメインでは、独自の証明書と HTTP から HTTPS へのリダイレクトを無効にしてください。
はい。トライアル開始時に追加するか、トライアル中に追加してください。トライアル終了までは無料で、その後は Pro として月額 $100 で請求されます。
あなたのサーバーは、すでに持っている証明書で HTTPS を引き続き提供します。証明書は有効期限よりかなり前に更新されるため、短時間の障害で失効することはありません。
ワークスペースごとに最大 100 台のサーバーを、任意のリージョンまたはクラウドで運用できます。それ以上必要な場合は Enterprise についてご相談ください。価格は契約により決定されます。
