カスタムドメインの設定

ドキュメントサイトにカスタムドメインを設定する

この機能は次のプランで利用可能です： プレミアムおよびアルティメットのサイトプラン.

このページではカスタムドメインとサブドメインの設定方法を説明します。カスタムサブディレクトリ（例： example.com/docs）を設定したい場合は、 カスタムサブディレクトリの設定 ページを参照してください。

デフォルトでは、あなたのサイトには次の [サブドメイン].gitbook.io ドメインでアクセスできます。

カスタムドメインを設定することでこれを変更でき、利用者は選択したドメインでドキュメントにアクセスできます。

1

サブドメインを選ぶ

サブドメインを選ぶ際は、 www またはカスタムのものを使用できます。よく使われるサブドメインの例：

• docs.example.com

• help.example.com

• developers.example.com

2

カスタムドメイン設定の開始

カスタムドメインを設定したいサイトに移動します。をクリックしてください 設定、 次に選択します カスタムドメインを設定。

ここで、最初のステップで選んだカスタムドメインを入力できるウィンドウが表示されます。入力してから 次へ

3

DNSの設定

この段階では、3つのフィールドがあるウィンドウが表示されます： タイプ、名前、ターゲット。

これらが、ドメインのDNSプロバイダでカスタムドメインを設定する際に使用する詳細です。これは GitBookの 外部で、あなたがドメインに使用しているプロバイダで行います。

以下の内容をコピーしてください： 名前 および ターゲット フィールドをDNSプロバイダで使用します。各プロバイダは異なるため、疑問がある場合は直接プロバイダにどのようにレコードを追加するかを確認してください。プロバイダのリストからレコードの を入力してから タイプを選択できるはずです。

レコードを追加した後、変更が反映されるまで時間がかかる場合があります。私たちは 少なくとも1時間待つこと を次のステップに進む前に推奨します。準備ができたら 次へ をクリックしてください。

4

設定を完了する

レコードを追加し反映された後は公開の準備が整います！GitBookはドメインと追加したレコードを検証し、ドメイン用のSSL証明書を自動的に設定します。

完了すると通知が届き、をクリックできます 完了。必要であればウィンドウを閉じることもできます。処理が完了したらこちらから通知をお送りします。

トラブルシューティング

カスタムドメインの設定は時折問題が発生することがあります。以下では、このプロセスでよくある問題とそれぞれの解決策を説明します。

SSLエラー：SSL証明書の発行中にエラーが発生しました。

組織、コレクション、またはスペースにカスタムドメインが設定されると、ドキュメントがHTTPSで安全に読み込まれるように当社側でSSL証明書を設定します。 これはカスタムドメインを設定した際に自動的に行われます — SSL証明書を購入したり設定したりする必要はありません。

この段階でエラーが発生することがあり、通常はカスタムドメインのCNAMEレコードがまだ伝播していない場合に起こります。

このような場合、次のことを推奨します：

1. CNAMEレコードが正しく設定されているか確認してください。 DNS設定に関する当社のページを確認して支援を得てください。 CNAMEレコードが誤っている場合、SSL証明書を設定できず、カスタムドメインの設定を完了できません。

2. 少なくとも 1時間 CNAMEレコードの設定とカスタムドメイン設定の完了の間は時間を空けてください。

3. CNAMEが伝播しているか確認してください。サードパーティのDNSチェックツール（例えば WhatsMyDNS）を使用して、サーバーが正しいと判断しているCNAMEレコードを確認できます。

4. Cloudflareを使用している場合は、そのレコードがプロキシ化されていないことを確認してください （ここで説明されています）.

ドメインは既に接続済みエラー：あなたのサブドメインは既に別のコンテンツに設定されています。

サイトに割り当てられたカスタムドメインは一意である必要があります。同じカスタムドメインを複数の場所で使用しようとするとエラーになります。

このエラーが発生した場合、エラーメッセージ内のリンクをクリックして、そのカスタムドメインが既に接続されているコンテンツを確認できます。これにより今後の対応を決める手助けになる場合があります。

そのコンテンツにアクセス権がない場合もあります — その場合はサポートチームに連絡すれば次の手順を支援してくれます。

このエラーの解決策は常に次のいずれかになります：

1. 別のカスタムドメインを選択する；または

2. カスタムドメインを既に接続されているコンテンツから切断し、そして新しいコンテンツに再接続する。