プロジェクトへのカスタムドメインの追加

Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…

Orbit プロジェクトの各ドメインにカスタムドメインを追加する

すべての Orbit プロジェクトは無料の kaps.run アドレスで提供され、SSL 証明書を自動的にプロビジョニングして、独自のドメインを追加できます。このガイドでは、ドメインの追加、必要な DNS レコード、検証状態の読み方、プライマリドメインの選択、ドメインが固定されたままの場合の確認事項を説明します。

開始する前に

少なくとも 1 つの正常なデプロイメントがある Orbit プロジェクト、DNS を制御できるドメイン、カスタムドメインを含むプランが必要です。カスタムドメインは Liftoff と Apex に含まれています。無料の Launch プランには含まれていません。Orbit Plan Limits を参照してください。

ステップ 1: Orbit でドメインを追加する

Orbit でプロジェクトを開きます。
Domain タブを開くか、Settings の Custom domains カードから Manage domains をクリックします。
Add a domain で、ホスト名を入力します(例: app.example.com)。
Add をクリックします。

プレーンなホスト名を入力してください。https://、末尾のスラッシュ、またはパスを含めないでください。フォームは「Enter a valid hostname like app.example.com」というメッセージで、ベアホスト名以外のものを拒否します。

Orbit プロジェクトのドメインタブ

プロジェクトに最大 25 個のドメイン を追加できます。追加した最初のドメインが プライマリ ドメインになります。

ドメインが既に別の Orbit プロジェクトにアタッチされている場合、Orbit はそれを拒否します。まず他のプロジェクトから削除してください。

ステップ 2: DNS レコードを追加する

Orbit は DNS setup パネルを表示し、作成する正確なレコード(CNAME)と使用する Name と Value を示します。ターゲットは DNS をホストする人に関わらず同じです。

ドメインが Kapsule DNS を使用している場合

KPanel サイドバーで Domains をクリックします。
ドメインをクリックします。
DNS エディターで、Orbit ドメインタブに表示されている Name と Value を使用して CNAME レコードを追加します。

ドメインが別の DNS プロバイダーを使用している場合

そのプロバイダーにサインインし、同じ CNAME レコードを追加します。インターフェースは異なりますが、レコードタイプ、名前、値は同じです。

Apex ドメイン(サブドメインがない example.com)は、DNS 標準に基づいてプレーン CNAME を取得できません。多くのプロバイダーは CNAME フラッテニングまたは ALIAS または ANAME レコードを提供し、同じことを実現します。それを使用してください。そうでない場合は、www.example.com などのサブドメインで公開し、DNS プロバイダーまたはレジストラーで apex をリダイレクトしてください。

ステップ 3: 検証と SSL を待つ

Orbit は DNS を自動的にチェックし、ドメインタブはどこまで進んだかを報告します。

表示内容	意味
Checking DNS…	チェックが今実行中です
CNAME not detected yet	レコードがまだ伝播していないか、正しくありません
CNAME verified: SSL provisioning…	レコードが解決され、証明書が発行されています
SSL active: CNAME verified	ドメインは稼働中で、HTTPS を介して機能しています

Re-check DNS をクリックして、次の自動チェックを待つのではなく、強制的にチェックを実行します。

DNS の伝播には、古いレコードの TTL に応じて数分から数時間かかります。CNAME が検出されてから 1 分か 2 分以内に証明書が発行され、ドメインがアタッチされたままである限り自動的に更新されます。

レコードを追加する前に、そのホスト名の既存レコードの TTL を下げて、古い TTL が期限切れになるまで待ってください。その後のカットオーバーは数時間ではなく数分で済みます。これは、新しいホスト名を追加するのではなく、稼働中のホスト名を移動する場合に最も重要です。

プライマリドメインの選択

複数のドメインがアタッチされている場合、1 つが Primary とマークされます。検証済みドメインの Set as primary domain をクリックして変更します。プライマリはプロジェクトの正規のアドレスです。他のドメインは引き続き機能します。

ドメインの削除

行の Remove domain をクリックします。

ドメインを削除するとすぐにサービスから外れます。訪問者はそのホスト名でプロジェクトに到達できなくなり、その証明書は保持されなくなります。プロバイダーの DNS レコードは削除されません。不要になったら自分で削除してください。そうしないと、もう応答しないホスト名を指し続けます。

プロジェクトは kaps.run アドレスで引き続き機能します。

SSL は自動かつ無料です

Orbit ドメインの証明書を購入、アップロード、または更新することはありません。CNAME が解決されると、証明書が発行され、自動的に更新されます。管理するものがないため、証明書管理画面はありません。

トラブルシューティング

「CNAME not detected yet」で固定されたままです。

レコードタイプを確認してください。IP アドレスを指す A レコードは検証されません。Orbit が提供した値への CNAME である必要があります。
レコード名を確認してください。多くの DNS エディターはゾーンを自動的に追加するため、app.example.com を入力すると app.example.com.example.com が生成される場合があります。エディターがゾーンをサフィックスとして表示する場合は、app のみを入力してください。
競合するレコードを確認してください。同じ名前の既存の A、AAAA、または CNAME が存在すると、優先されるか、ゾーンが無効になります。削除してください。
実際に権限のあるゾーンを編集したことを確認してください。最近ネームサーバーを移動した場合、古いプロバイダーのコピーを編集している可能性があります。
置き換えたレコードの TTL を待ってください。

検証済みですが、証明書がアクティブになりません。 ドメインの CAA レコードは発行を防ぐことができます。それを削除するか、Kapsule が使用する認証局を許可するエントリを追加してください。確実でない場合は、ドメイン名を含めてサポートに連絡してください。

「This domain is already attached to another project」 その通りです。他の Orbit プロジェクトを見つけて、そこからドメインを削除してください。

「Domain limit reached」 このプロジェクトで 25 個のドメインに達しています。不要なドメインを 1 つ削除してください。

ドメインは解決されていますが、間違ったサイトが表示されます。 CNAME ターゲット文字を文字ごとに確認してください。ドメインを 1 つのプロジェクトにアタッチして、DNS を別のプロジェクトを指すのは簡単です。