カスタムドメインを設定する

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

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

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

カスタムドメインを設定することでこれをカスタマイズでき、閲覧者は任意のドメインでドキュメントにアクセスできるようになります。

1

サブドメインを選択する

サブドメインを選ぶ際は、 www を使うことも、カスタムのものを使うこともできます。よく使われるサブドメインには次のようなものがあります。

• docs.example.com
• help.example.com
• developers.example.com

2

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

カスタムドメインを設定したいサイトに移動し、 設定、 次に カスタムドメインを設定します。

ここでは、最初の手順で選択したカスタムドメインを入力できるウィンドウが表示されます。入力して、 ［次へ］

3

DNSを設定する

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

これらは、DNSプロバイダーでカスタムドメインを設定する際に使用する詳細情報です。これは GitBookの外で 、つまりドメインに使用しているプロバイダー側で行います。

次の内容をコピーしてください： 名前 、 ターゲット フィールドをDNSプロバイダーで使用してください。プロバイダーによって仕様が異なるため、迷った場合は、このレコードを追加する方法を直接確認してください。 種類 レコードの種類

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

4

設定を完了する

レコードを追加して反映されたら、公開する準備は完了です！GitBookがドメインと追加したレコードを検証し、ドメイン用のSSL証明書を自動で設定します。

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

カスタムドメインを変更または更新する

サイトのカスタムドメインを変更するには、そのサイトの 設定、 全般 をサイトのサイドバーで開き、】【t_577c0d39】. Here you can enable the Assistant and customize its instructions, welcome message, and suggested questions. ドメインとURLを開きます。現在のドメインを削除して新しいものを追加することも、既存の設定を編集することもできます。

新しいGitBookの設定を指すように、ドメインプロバイダーのDNS設定も更新することを忘れないでください。手順は初期設定と同じで、GitBookが提供する値を指すCNAMEレコードを使用します。

トラブルシューティング

カスタムドメインの設定では、時折問題が発生することがあります。以下では、この過程でよく発生する問題を挙げ、それぞれの詳細な解決策を示します。

カスタムサブドメインが動作しません。

カスタムドメインの問題は、通常DNSに関連しています。DNS設定を確認してください：

1. 作成したものが CNAMEレコード （Aレコードではありません）が、GitBookが提供した値を指していることを確認してください。
2. サブドメイン形式（docs.yoursite.com または www.yoursite.com).
3. Cloudflareを使用している場合は、プロキシ（オレンジ色の雲）を無効にしてください。レコードは「DNS only」に設定する必要があります。

よくあるDNSの問題：

• 競合するレコード — 同じサブドメインに対する既存のA、AAAA、その他のレコードを削除してください。
• TTLの遅延 — DNSの変更が世界中に反映されるまで、最大48時間かかることがあります。
• CAAレコード — CAAレコードがある場合は、 0 issue "pki.goog" を追加して、GitBookのSSL証明書を許可してください。

設定をテストするには、次のようなDNS検索ツールを使用してください： WhatsMyDNS CNAMEレコードが正しいGitBookのアドレスを指していることを確認します。48時間後も問題が続く場合は、ドメイン名とGitBookが提供したCNAME値を添えてサポートに連絡してください。

SSLエラー：SSL証明書のプロビジョニング中にエラーが発生しました。

組織、グループ、またはセクションにカスタムドメインが設定されると、ドキュメントがHTTPS経由で安全に読み込まれるように、こちら側でSSL証明書を設定します。 これはカスタムドメインを設定すると自動的に行われるため、SSL証明書を購入したり設定したりする必要はありません。

この段階では、特にカスタムドメインのCNAMEレコードがまだ反映されていない場合に、エラーが発生することがあります。

このような場合は、次のことをおすすめします：

1. CNAMEレコードが正しく設定されていることを確認してください。 この作業については、DNSの設定に関するページをご確認ください。 CNAMEレコードが正しくない場合、SSL証明書を設定してカスタムドメインのセットアップを完了することはできません。
2. 少なくとも 1時間 CNAMEレコードの設定からカスタムドメインの設定完了まで、時間を空けてください。
3. CNAMEが反映されているか確認してください。次のようなサードパーティのDNS検索ツールを試すことができます： WhatsMyDNSを使うと、サーバー側が正しいと判断しているCNAMEレコードを確認できます。
4. Cloudflareを使用している場合は、レコードがプロキシされていないことを確認してください （詳しくはここで説明しています）.

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

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

この場合、エラーメッセージ内のリンクをクリックすると、カスタムドメインがすでに接続されているコンテンツを確認できます。これにより、次に何をすべきか判断しやすくなるかもしれません。

そのコンテンツにアクセス権がない可能性もあります。その場合はサポートチームに連絡してください。次の手順を案内してもらえます。

ただし、このエラーの解決策は常に次の2つのどちらかです：

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