> ## 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 の設定を構成します

## 設定パス

V3.38 以降、Manager はセキュリティ強化のため保護されたシステムパスを使用します。

| ComfyUI バージョン                 | Manager パス                                  |
| ----------------------------- | ------------------------------------------- |
| v0.3.76+ (System User API 付き) | `<USER_DIRECTORY>/__manager/`               |
| 旧バージョン                        | `<USER_DIRECTORY>/default/ComfyUI-Manager/` |

<Note>
  オプションなしで実行した場合、`<USER_DIRECTORY>` パスはデフォルトで `ComfyUI/user` になります。`--user-directory <USER_DIRECTORY>` を使用して設定できます。
</Note>

### 設定ファイル

| ファイル                 | 説明                  |
| -------------------- | ------------------- |
| `config.ini`         | 基本設定                |
| `channels.list`      | 設定可能なチャンネルリスト       |
| `pip_overrides.json` | カスタム pip パッケージマッピング |
| `pip_blacklist.list` | インストールを防止するパッケージ    |
| `pip_auto_fix.list`  | 自動的に復元するパッケージ       |
| `snapshots/`         | 保存されたスナップショットファイル   |
| `startup-scripts/`   | 起動スクリプトファイル         |
| `components/`        | コンポーネントファイル         |

## Config.ini オプション

設定を適用するには `config.ini` ファイルを変更します。パスは起動ログメッセージに表示されます。

```ini theme={null}
[default]
git_exe = <git 実行ファイルへのパス>
use_uv = <True/False - pip の代わりに uv を使用>
default_cache_as_channel_url = <True/False - 起動時に channel_url として指定された DB を取得>
bypass_ssl = <True/False - エラーが発生した場合に SSL を無効化>
file_logging = <True/False - ログファイルを作成>
windows_selector_event_loop_policy = <True/False - Windows 上のイベントループエラーを修正>
model_download_by_agent = <True/False - モデルダウンロードにエージェントを使用>
downgrade_blacklist = <ダウングレードを防止するパッケージのコンマ区切りリスト>
security_level = <strong|normal|normal-|weak>
always_lazy_install = <True/False - 再起動時に依存関係のインストールを実行>
network_mode = <public|private|offline>
```

### ネットワークモード

| モード       | 説明                                                                  |
| --------- | ------------------------------------------------------------------- |
| `public`  | 標準的な公共ネットワーク環境                                                      |
| `private` | `channel_url` を経由して設定されたプライベートノード DB を持つ閉じたネットワーク（利用可能な場合はキャッシュを使用） |
| `offline` | 外部接続なし（利用可能な場合はキャッシュを使用）                                            |

### セキュリティレベル

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

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

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

## 環境変数

| 変数                | 説明                            |
| ----------------- | ----------------------------- |
| `COMFYUI_PATH`    | ComfyUI のインストールパス             |
| `GITHUB_ENDPOINT` | GitHub アクセスのためのリバースプロキシ       |
| `HF_ENDPOINT`     | Hugging Face アクセスのためのリバースプロキシ |

### 例

プロキシ経由で GitHub リクエストをリダイレクト：

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

Hugging Face エンドポイントの変更：

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

## 高度な設定

### 特定パッケージのダウングレード防止

`config.ini` の `downgrade_blacklist` セクションにパッケージ名をコンマ区切りでリストします：

```ini theme={null}
downgrade_blacklist = diffusers, kornia
```

### カスタム pip マッピング

`pip_overrides.json` ファイルを作成し、特定の pip パッケージのインストールをユーザー定義のインストールに変更します。形式については `pip_overrides.json.template` を参照してください。

### 特定 pip パッケージのインストール防止

`pip_blacklist.list` ファイルにパッケージ名を 1 行ずつリストします。

### pip インストールの自動復元

`pip_auto_fix.list` に pip 仕様の要件をリストします（`requirements.txt` に類似）。ComfyUI 起動時、またはカスタムノードインストール中にバージョンが不一致になった場合、指定されたバージョンを自動的に復元します。`--index-url` を使用できます。

### aria2 をダウンローダーとして使用

ダウンロードを高速化するために、ComfyUI-Manager が aria2 を使用するように設定できます。[aria2 設定ガイド](https://github.com/ltdrdata/ComfyUI-Manager/blob/main/docs/en/use_aria2.md) を参照してください。

## extra\_model\_paths.yaml 設定

以下の設定は `is_default` としてマークされたセクションに基づいて適用されます：

* `custom_nodes`: カスタムノードをインストールするパス
* `download_model_base`: モデルをダウンロードするパス

## CLI ツール

ComfyUI-Manager は `cm-cli` を提供します。これは、ComfyUI を実行せずに Manager 機能を使用できるコマンドラインツールです。これは、カスタムノードのインストールの自動化や、ヘッドレス環境でのインストールの管理に役立ちます。

詳細な cm-cli ドキュメントについては、[公式 cm-cli ガイド](https://github.com/ltdrdata/ComfyUI-Manager/blob/main/docs/en/cm-cli.md) を参照してください。

より包括的な CLI 体験については、[comfy-cli](/comfy-cli/getting-started) の使用を検討してください。