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

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

このページでは、カスタムドメインとサブドメインの設定方法を説明します。カスタムサブディレクトリ（たとえば 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証明書を自動的に設定します。

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

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

サイトの 設定 サイトのサイドバーで開き、クリックします ドメインと URL。現在のドメインを削除して新しいものを追加するか、既存の設定を編集できます。

ドメインプロバイダーのDNS設定を更新して新しいGitBook設定を指すようにしてください。手順は初回設定と同じで、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が反映されているか確認してください。 WhatsMyDNSのようなサードパーティのDNSルックアップツールを使って、サーバーが正しいと認識しているCNAMEレコードを確認できます。
4. Cloudflareを使用している場合は、レコードがプロキシされていないことを確認してください こちらで説明しているとおりに.

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

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

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

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

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

1. 別のカスタムドメインを選択する；または
2. カスタムドメインをすでに接続されているコンテンツから切り離し、その後、新しいコンテンツに再接続する。