> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 一般的な ComfyUI-Manager の問題を解決します

## 一般的な問題

### カスタム git 実行ファイルパス

`git.exe` がシステムデフォルト以外の特定の場所にインストールされている場合：

1. ComfyUI-Manager をインストールし、ComfyUI を 1 回実行します
2. `<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini` を開きます
3. `git_exe =` にファイル名を含むフルパスを指定します

```ini theme={null}
git_exe = C:\Program Files\Git\bin\git.exe
```

### ComfyUI-Manager の更新に失敗する

ComfyUI-Manager 自体の更新に失敗する場合は、ComfyUI-Manager ディレクトリに移動して以下を実行してください：

```bash theme={null}
git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull
```

### Windows: Overlapped Object エラー

ComfyUI Manager 読み込み時に `Overlapped Object has pending operation at deallocation on ComfyUI Manager load` が発生した場合：

`config.ini` を編集して以下を追加してください：

```ini theme={null}
windows_selector_event_loop_policy = True
```

### SSL 証明書検証に失敗しました

`SSL: CERTIFICATE_VERIFY_FAILED` エラーが発生した場合：

`config.ini` を編集して以下を追加してください：

```ini theme={null}
bypass_ssl = True
```

## インストール問題

### インストールパスが正しくありません

ComfyUI-Manager ファイルは `ComfyUI/custom_nodes/comfyui-manager` に配置する必要があります。

**避けるべき一般的な間違い：**

| 問題             | 詳細                                                              |
| -------------- | --------------------------------------------------------------- |
| ファイルの場所が間違っている | `__init__.py` などの Manager ファイルが `custom_nodes` ディレクトリに直接配置されている |
| 二重にネストされたフォルダ  | `custom_nodes/ComfyUI-Manager/ComfyUI-Manager` としてインストールされている   |
| フォルダ名が間違っている   | `custom_nodes/ComfyUI-Manager-main` としてインストールされている              |
| 圧縮形式           | 適切に解凍せずに圧縮ファイルからインストールしている                                      |

<Warning>
  正しくインストールされていない場合、ComfyUI-Manager は動作しているように見えますが、更新として認識されず、重複インストールの原因となる可能性があります。それを削除し、`git clone` を使用して正しく再インストールしてください。
</Warning>

## ネットワーク問題

### GitHub へのアクセス問題

GitHub へのアクセスが制限されている場合は、`GITHUB_ENDPOINT` 環境変数を設定してください：

```bash theme={null}
GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com
```

### Hugging Face へのアクセス問題

Hugging Face へのアクセスが制限されている場合は、`HF_ENDPOINT` 環境変数を設定してください：

```bash theme={null}
HF_ENDPOINT=https://some-hf-mirror.com
```

## スキャナーのトラブルシューティング

`scan.sh` スクリプトを実行する際：

* `custom-node-list.json` にリストされたカスタムノードを `~/.tmp/default` へプルまたはクローンすることで、`extension-node-map.json` を更新します
* GitHub API を使用して `github-stats.json` を更新します

| オプション                | 説明                               |
| -------------------- | -------------------------------- |
| `--skip-update`      | extension-node-map.json の更新をスキップ |
| `--skip-stat-update` | github-stats.json の更新をスキップ       |
| `--skip-all`         | 両方の更新ステップをスキップ                   |

<Tip>
  GitHub API のレート制限を回避するには、トークンを設定してください：`export GITHUB_TOKEN=your_token_here`
</Tip>

`~/.tmp/default` 以外の異なるパスを指定したい場合は、`scan.sh` ではなく `python scanner.py [path]` を直接実行してください。

## セキュリティポリシー

git URL 経由でカスタムノードをインストールする際、または nightly バージョンを使用する際に `This action is not allowed with this security level configuration` エラーが発生した場合は、`config.ini` ファイルでセキュリティレベルを調整する必要があります。

`config.ini` ファイルの場所は次の通りです：

* **ComfyUI v0.3.76+**：`<USER_DIRECTORY>/__manager/config.ini`
* **旧バージョン**：`<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini`

`<USER_DIRECTORY>` のデフォルトは `ComfyUI/user` です。詳細は [設定](/manager/configuration) をご覧ください。

`config.ini` でセキュリティレベルを設定します：

```ini theme={null}
security_level = normal
```

| レベル       | 説明                                                                |
| --------- | ----------------------------------------------------------------- |
| `strong`  | 高リスクおよび中リスクの機能を許可しません                                             |
| `normal`  | 高リスクの機能を許可しません。中リスクの機能は利用可能です                                     |
| `normal-` | `--listen` が指定され、かつ `127.` で始まらない場合、高リスクの機能を許可しません。中リスクの機能は利用可能です |
| `weak`    | すべての機能を利用可能です                                                     |

### 機能のリスクレベル

| リスクレベル | 機能                                                                    |
| ------ | --------------------------------------------------------------------- |
| **高**  | git url 経由でのインストール、pip install、デフォルトチャンネルにないカスタムノードのインストール、カスタムノードの修正 |
| **中**  | アンインストール/更新、デフォルトチャンネルのカスタムノードのインストール、スナップショットの復元/削除、再起動              |
| **低**  | ComfyUI の更新                                                           |

<Tip>
  git URL 経由または nightly バージョンでカスタムノードをインストールするには、`config.ini` で `security_level = weak` を設定してください。
</Tip>

## サポートを受ける

それでも問題が解決しない場合は：

1. [ComfyUI-Manager GitHub issues](https://github.com/ltdrdata/ComfyUI-Manager/issues) で類似の問題を確認してください
2. エラーの詳細については起動ログメッセージを確認してください
3. コミュニティサポートについては [ComfyUI Discord](https://discord.com/invite/comfyorg) に参加してください