> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/troubleshooting.md).

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

一般的なトラブルシューティングとログの確認

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-0b909c4d4c413aa983c5f55b10a8a4a1952b0f9b%2FKeeper%20-%20SMK%20Troubleshooting%20(1).jpg?alt=media" alt=""><figcaption></figcaption></figure>

動作がおかしい場合は、まずデプロイメントに備わっているヘルスチェックを実行します。

```bash
./smk status
./smk doctor
```

`status` は、何が稼働しているかを表示します。`doctor` は、証明書の名前、DNS、ライセンス、そしてPAMルーティング層が有効な場合はKRouterへの接続とKRelayのDNSレコードなど、デプロイメントの各要素が互いに整合しているかを確認します。ステータスが正常でも、デプロイメントが動作しているとは限りません。`doctor` は、一見問題なさそうでも別の箇所で障害につながるケースを検出します。たとえば、証明書の名前の不一致では、ボルトは動作していても、すべてのPAM接続が何の通知もなく失敗します。`doctor` はKRelayのTURNポートをテストしないため、PAMセッションの接続は実際のPAM接続で確認してください。

### よくある症状 <a href="#common-symptoms" id="common-symptoms"></a>

| 症状                     | 対処                                                                               |
| ---------------------- | -------------------------------------------------------------------------------- |
| ライセンスが拒否される            | 発行されたライセンスが、このデプロイメントの検証用の鍵と有効期間に一致しているか確認します。鍵の改変や検証の回避は行わないでください。              |
| アドレス、ポート、インスタンスの競合     | 選択した名前、ルート、バインドアドレスを確認します。他のインストールのリソースは削除しないでください。                              |
| 起動またはアカウントのセットアップに失敗する | エラーを保存し、`./smk status` と `./smk doctor` の結果を確認します。再試行する前に、ホストの容量と選択したサービスを確認します。 |
| デバイス承認のメールが届かない        | SMTPの接続、送信者の権限、配信状況を確認します。デモ環境では、外部のメールボックスではなく、ローカルのメールキャッチャーを確認します。            |
| ブラウザに証明書の警告が表示される      | 正確なホスト名、証明書チェーン、有効期限に加え、ブラウザの信頼ストアに適切な認証局が登録されているかを確認します。警告を無視して先に進まないでください。     |

### ログの確認 <a href="#checking-the-logs" id="checking-the-logs"></a>

上記のヘルスチェックで原因が分からない場合は、コンテナのログを確認します。セルフマネージド型Keeperは、Dockerコンテナ群として動作します。ログの確認ではデプロイメントは変更されないため、標準のDocker Composeコマンドを安全に実行できます。展開したバンドル内の `install/` ディレクトリで、以下を実行します。

```bash
cd install
docker compose logs <service>
docker compose logs -f <service>
```

これらのコマンドは、デフォルトのインスタンスが対象です。名前を付けたインスタンスや、すべてのサービスを確認するには、展開したバンドルのディレクトリで `./smk status` を実行します。

### Keeperサポートへの問い合わせ <a href="#contacting-keeper-support" id="contacting-keeper-support"></a>

サポートケースを開く前に、機密情報を除去したサポート用アーカイブを作成し、ケースに添付します。

```bash
./smk support collect --output <path>
```

インストールしたバンドルで使用できるコマンドの一覧 (バックアップ、リストア、アップグレードの各ウィザードを含む) は、`./smk help` で確認できます。


---

# 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://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/troubleshooting.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.
