> 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/herupu/troubleshooting.md).

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

GitBookアプリでの読み込み、接続、キャッシュの問題を解決する

#### ページまたは連携機能が読み込まれません

GitBook アプリが読み込まれない、特定のページでクラッシュする、「連携を読み込めませんでした」と表示される、または分析ダッシュボードが空のままの場合、よくある原因は、広告ブロッカーやプライバシー拡張機能がアプリの一部をブロックしていることです。

1. 広告ブロッカーまたはプライバシー拡張機能を一時的に無効にして、ページを再読み込みしてください。
2. 完全に無効にしたくない場合は、以下のドメインを [許可されたドメイン](#allowed-domains) として拡張機能の許可リストに追加してください。
3. ページを更新して、正しく読み込まれるか確認してください。

#### 「接続が失われました」

「接続が失われました」とは、GitBook が必要なネットワーク接続を確立できないことを意味します。通常は、コンピューターまたはネットワーク上の何かがそれらをブロックしているためです。一般的な原因には、ブラウザ拡張機能、ファイアウォール、セキュリティソフト、プロキシ、一時的なネットワークの問題などがあります。

次の手順を順番に行ってください:

1. **キャッシュを消去してブラウザを再起動してください。** これで一時的な接続の問題のほとんどは解決します。
2. **Wi‑Fi またはイーサネット接続を再起動する**してから、もう一度お試しください。
3. **別のブラウザまたはデバイスを試してください。** 他の環境では GitBook が動作する場合、問題は元の設定に固有のものです。サポートに連絡する際は、使用していたブラウザを伝えてください。
4. **ブラウザ拡張機能を無効にする** 原因を特定するために 1 つずつ。
5. **ファイアウォールまたはセキュリティソフトを確認する** に対して [許可されたドメイン](#allowed-domains).

また確認してください [GitBookのステータスページ](https://www.gitbookstatus.com/) 現在の障害がないか。

#### ブラウザをハードリフレッシュする

サポートチームから次を求められる場合があります: *ハード* 通常の更新とは異なり、ページがまだ使用しているキャッシュ済みファイルを消去します。

{% tabs %}
{% tab title="Chrome、Firefox、Edge" %}
〜に **Windows**では、CTRL キーを押しながら F5 を押します。 **Mac**では、CMD キーと SHIFT キーを押しながら R を押します。
{% endtab %}

{% tab title="Safari" %}
まずキャッシュを空にします: OPT キーと CMD キーを押しながら E を押します。次に現在のページを更新します: CMD キーを押しながら R を押します。
{% endtab %}
{% endtabs %}

#### 許可されたドメイン

ファイアウォール、プロキシ、またはセキュリティアプリケーションがトラフィックをブロックしている場合は、これらのドメインを許可リストに追加してください。

**必須です。** GitBook はこれらなしでは動作しません:

* `*.gitbook.com` — を含む `app.gitbook.com`, `api.gitbook.com`を読み取り、 `files.gitbook.com`
* `*.gitbook.io`
* `*.googleapis.com` — を含む `firebase.googleapis.com`, `firestore.googleapis.com`を読み取り、 `www.googleapis.com`
* `*.googleusercontent.com`
* `cdn.iframe.ly` — 埋め込みコンテンツに必要

**任意です。** これらは分析とエラー監視に使用されます。これらをブロックしても GitBook の動作には影響しません:

* `segment-cdn.gitbook.com` 、 `segment-api.gitbook.com`
* `clearbit-risk.gitbook.com`
* `*.googletagmanager.com`
* `*.sentry.io`

これらの手順をすべて試しても問題が解決しない場合は、ブラウザ、デバイス、ネットワーク設定の詳細を添えてサポートにご連絡ください。


---

# 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/herupu/troubleshooting.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.
