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

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

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

{% hint style="warning" %}
このページでは、カスタムドメインとサブドメインの設定方法を説明します。カスタムサブディレクトリ（例： `example.com/docs`）を設定する場合は、 [カスタムサブディレクトリの設定](https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/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つのフィールドがあるウィンドウが表示されます。 **種類、名前、ターゲット。**

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

DNSプロバイダーで使うため、 **名前** と **ターゲット** の各フィールドの内容をコピーします。プロバイダーによって手順は異なるため、レコードの追加方法がわからない場合は、プロバイダーに直接確認してください。レコードの **種類** は、プロバイダーの一覧から選択できます。

レコードを追加した後、変更が反映されるまでに時間がかかる場合があります。次の手順に進む前に、 **少なくとも1時間待つ** ことをおすすめします。準備ができたら、 **\[次へ]** をクリックします。
{% endstep %}

{% step %}

#### 設定を完了する

レコードを追加して伝播したら、公開の準備は完了です！GitBook がドメインと追加したレコードを確認し、ドメインの SSL 証明書を自動で設定します。

完了すると通知が届き、 **\[完了]**&#x3092;クリックできます。必要に応じてウィンドウを閉じることもできます。こちらでの処理が完了したら通知をお送りします。
{% endstep %}
{% endstepper %}

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

サイトのカスタムドメインを変更するには、サイトのサイドバーで **\[設定]** を開き、 **\[ドメインとURL]**&#x3092;クリックします。現在のドメインを削除して新しいドメインを追加するか、既存の設定を編集できます。

ドメインプロバイダーのDNS設定を更新して新しいGitBook設定を指すようにしてください。手順は初回設定と同じで、GitBookが提供する値を指すCNAMEレコードを使用します。

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

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

<details>

<summary>カスタムサブドメインが機能しません。</summary>

カスタムドメインの問題は通常DNSに関連しています。DNS設定を確認してください：

1. GitBookから指定された値を参照する **CNAMEレコード** （Aレコードではありません）を作成したことを確認してください。
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値を添えてサポートにお問い合わせください。

</details>

<details>

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

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

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

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

1. CNAME レコードが正しく設定されていることを確認してください。\
   DNS の設定に関するページを参照して、設定にお役立てください。\
   CNAME レコードが正しくない場合、SSL 証明書を設定してカスタムドメインのセットアップを完了することはできません。
2. 少なくとも ***1時間*** は、CNAMEレコードの設定後、カスタムドメインの設定を完了するまで待ってください。
3. CNAMEが伝播しているか確認してください。WhatsMyDNSなどのサードパーティ製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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/custom-domain.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
