> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gong-kai/custom-domain.md).
# カスタムドメインを設定
{% hint style="warning" %}
このページでは、カスタムドメインとサブドメインの設定方法を説明します。カスタムサブディレクトリ（たとえば `example.com/docs`）を設定したい場合は、以下を参照してください。 [カスタムサブディレクトリの設定](/docs/documentation/ja-gitbook-documentation/gong-kai/custom-domain/setting-a-custom-subdirectory.md) ページ。
{% endhint %}
デフォルトでは、サイトは次の `[subdomain].gitbook.io` ドメインでアクセスできます。
カスタムドメインを設定することで、これを変更できます。つまり、ユーザーは指定したドメインでドキュメントにアクセスできます。
{% stepper %}
{% step %}
#### サブドメインを選択
サブドメインを選ぶ際は、 `www` を使うか、任意のカスタム名を使うかを選べます。よく使われるサブドメインには次のようなものがあります：
* `docs.example.com`
* `help.example.com`
* `developers.example.com`
{% endstep %}
{% step %}
#### カスタムドメインの設定を開始
カスタムドメインを設定したいサイトに移動し、 **「設定」を** クリックして、次に **「カスタムドメインを設定」を選択します。**
ここで、最初のステップで選んだカスタムドメインを入力するウィンドウが表示されます。入力して、 **「次へ」をクリックします。**
{% endstep %}
{% step %}
#### DNS を設定
この段階では、3つの項目があるウィンドウが表示されます： **Type、Name、Target。**
これらの情報を使って、DNS プロバイダーでカスタムドメインを設定します。これは *外部の* GitBook ではなく、ドメインで使用しているプロバイダー側で行います。
次の内容を **Name** 、 **Target** DNS プロバイダーで使用するためにコピーしてください。プロバイダーごとに異なるため、迷った場合は、このレコードの追加方法を直接確認してください。 **種類** レコードの種類を
レコードを追加した後、変更が反映されるまで少し時間がかかることがあります。 **少なくとも1時間待つ** ことをおすすめします。次のステップに進む前に、 **「次へ」** をクリックしてください。
{% endstep %}
{% step %}
#### 設定を完了
レコードを追加して反映されたら、公開の準備は完了です。GitBook がドメインと追加したレコードを確認し、ドメインの SSL 証明書を自動的に設定します。
完了すると通知が届くので、 **「完了」**をクリックできます。必要であればウィンドウを閉じても大丈夫です。こちらで処理が完了したら通知をお送りします。
{% endstep %}
{% endstepper %}
### カスタムドメインの変更・更新
サイトのカスタムドメインを変更するには、サイトの **設定**の下の **一般** をサイトのサイドバーで開き、 **ドメインと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](https://www.whatsmydns.net/#CNAME) を使うと、CNAME レコードが正しい GitBook のアドレスを指しているか確認できます。48 時間たっても問題が解決しない場合は、ドメイン名と GitBook が提供した CNAME の値を添えてサポートに連絡してください。
SSL エラー：SSL 証明書のプロビジョニング中にエラーが発生しました。
組織、グループ、またはセクションにカスタムドメインを設定すると、ドキュメントが HTTPS で安全に読み込まれるよう、こちら側で SSL 証明書を設定します。\
\
これはカスタムドメインを設定すると自動的に行われるため、SSL 証明書を購入したり設定したりする必要はありません。
この段階でエラーが発生することがあります。通常は、カスタムドメインの CNAME レコードがまだ反映されていない場合です。
このような場合は、以下をおすすめします：
1. CNAME レコードが正しく設定されていることを確認してください。\
DNS の設定に関するページを参照してください。\
CNAME レコードが正しくないと、SSL 証明書を設定してカスタムドメインのセットアップを完了することができません。
2. 少なくとも ***1時間*** CNAME レコードを設定してからカスタムドメイン設定を完了するまでの間に。
3. CNAME が反映されているか確認してください。次のようなサードパーティの DNS 参照ツールを試すことができます： [WhatsMyDNS](https://www.whatsmydns.net/)を使うと、サーバーが正しいと認識している CNAME レコードを確認できます。
4. Cloudflare を使用している場合は、レコードがプロキシされていないことを確認してください [。詳しくはここで説明しています](https://developers.cloudflare.com/fundamentals/setup/manage-domains/pause-cloudflare/#disable-proxy-on-dns-records).
ドメインはすでに接続されていますエラー：このサブドメインはすでに別のコンテンツに設定されています。
サイトに割り当てるカスタムドメインは一意である必要があります。同じカスタムドメインを複数の場所で使用しようとするとエラーになります。
このような場合は、エラーメッセージ内のリンクをクリックして、カスタムドメインがすでに接続されているコンテンツを確認できます。次に何をすべきか判断する助けになるかもしれません。
そのコンテンツにアクセス権がない可能性もあります。その場合はサポートチームに連絡してください。次の対応を案内してもらえます。
ただし、このエラーの解決策は必ず次の2つのどちらかです：
1. 別のカスタムドメインを選ぶ；または
2. すでに接続されているコンテンツからカスタムドメインを切断し、その後新しいコンテンツに再接続します。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gong-kai/custom-domain.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.