> 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/docs-site/custom-domain.md).

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

{% hint style="info" %}
この機能は～で利用できます [プレミアムおよびアルティメットのサイトプラン](https://www.gitbook.com/pricing).
{% endhint %}

{% hint style="warning" %}
このページでは、カスタムドメインとサブドメインの設定方法を説明します。カスタムサブディレクトリ（たとえば `example.com/docs`）、については次を参照してください。 [カスタムサブディレクトリの設定](/docs/documentation/ja-gitbook-documentation/docs-site/custom-domain/setting-a-custom-subdirectory.md) ページで設定できます。
{% endhint %}

デフォルトでは、サイトは次のURLでアクセスできます： `[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 証明書を自動的に設定します。

完了すると通知が届き、 **［完了］**&#x3092;クリックできます。必要であればウィンドウを閉じても大丈夫です。こちら側で処理が完了したら通知をお送りします。
{% endstep %}
{% endstepper %}

### トラブルシューティング

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

<details>

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

組織、グループ、またはセクションにカスタムドメインを設定すると、ドキュメントが 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).

</details>

<details>

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

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

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

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

ただし、このエラーの解決方法は、必ず次の2つのうちのいずれかになります。

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

</details>


---

# 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/docs-site/custom-domain.md?ask=<question>&goal=<endgoal>
```

`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.
