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

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

circle-exclamation

デフォルトでは、サイトは [subdomain].gitbook.io ドメインでアクセス可能です。

カスタムドメインを設定することでこれを変更でき、選択したドメインでユーザーがドキュメントにアクセスできるようになります。

1

サブドメインを選択する

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

  • docs.example.com

  • help.example.com

  • developers.example.com

2

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

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

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

3

DNSを設定する

この段階では、次の3つのフィールドが表示されます: Type、Name、Target。

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

DNSプロバイダーで使用するために、 NameTarget フィールドの内容をコピーしてください。各プロバイダーで仕様が異なるため、不明な場合はこのレコードの追加方法を直接確認してください。通常、プロバイダーの一覧からレコードの 入力 種類

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

4

設定を完了する

レコードを追加して反映されたら、いよいよ公開です!GitBook がドメインと追加したレコードを確認し、ドメイン用の SSL 証明書を自動的に設定します。

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

トラブルシューティング

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

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

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

この段階では、ときどきエラーが発生します。通常は、カスタムドメインの CNAME レコードがまだ反映されていない場合です。

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

  1. CNAME レコードが正しく設定されていることを確認してください。 この点については、DNS の設定方法に関するページをご確認ください。 CNAME レコードが正しくない場合、SSL 証明書を設定してカスタムドメインのセットアップを完了することはできません。

  2. 少なくとも 1時間 、CNAME レコードを設定してからカスタムドメイン設定を完了するまでの間隔を空けてください。

  3. CNAME が反映されているか確認してください。たとえば、次のようなサードパーティ製 DNS ルックアップツールを使用できます: WhatsMyDNSarrow-up-right。これにより、サーバーが正しい CNAME レコードとして認識している内容を確認できます。

  4. Cloudflare を使用している場合は、レコードがプロキシされていないことを確認してください ここで説明されているとおりarrow-up-right.

chevron-rightドメインはすでに接続済みエラー: あなたのサブドメインはすでに別のコンテンツ用に設定されています。hashtag

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

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

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

ただし、このエラーの解決策は常に次の2つのいずれかです:

  1. 別のカスタムドメインを選ぶ; または

  2. カスタムドメインが現在接続されているコンテンツから切り離し、その後、新しいコンテンツに再接続する。

最終更新

役に立ちましたか?