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

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

circle-exclamation

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

カスタムドメインを設定することでこれを変更でき、つまり、閲覧者は選択したドメインであなたのドキュメントにアクセスできるようになります。

1

サブドメインを選択する

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

  • docs.example.com

  • help.example.com

  • developers.example.com

2

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

カスタムドメインを設定したいサイトに移動します。 Settings, をクリックし、次に Set up a custom domain.

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

3

DNS を設定する

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

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

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

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

4

設定を完了する

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

完了すると、通知を受け取り、 Finishをクリックできます。必要であればウィンドウを閉じることもでき、その場合は、こちら側でプロセスが完了した時点で通知をお送りします。

トラブルシューティング

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

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. カスタムドメインが現在接続されているコンテンツから切断し、その後、新しいコンテンツに再接続する。

最終更新

役に立ちましたか?