設定パス
V3.38 以降、Manager はセキュリティ強化のため保護されたシステムパスを使用します。
| ComfyUI バージョン | Manager パス |
|---|
| v0.3.76+ (System User API 付き) | <USER_DIRECTORY>/__manager/ |
| 旧バージョン | <USER_DIRECTORY>/default/ComfyUI-Manager/ |
オプションなしで実行した場合、<USER_DIRECTORY> パスはデフォルトで ComfyUI/user になります。--user-directory <USER_DIRECTORY> を使用して設定できます。
設定ファイル
| ファイル | 説明 |
|---|
config.ini | 基本設定 |
channels.list | 設定可能なチャンネルリスト |
pip_overrides.json | カスタム pip パッケージマッピング |
pip_blacklist.list | インストールを防止するパッケージ |
pip_auto_fix.list | 自動的に復元するパッケージ |
snapshots/ | 保存されたスナップショットファイル |
startup-scripts/ | 起動スクリプトファイル |
components/ | コンポーネントファイル |
Config.ini オプション
設定を適用するには config.ini ファイルを変更します。パスは起動ログメッセージに表示されます。
[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_ENDPOINT=https://mirror.ghproxy.com/https://github.com
HF_ENDPOINT=https://some-hf-mirror.com
高度な設定
特定パッケージのダウングレード防止
config.ini の downgrade_blacklist セクションにパッケージ名をコンマ区切りでリストします：
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 設定ガイド を参照してください。
以下の設定は is_default としてマークされたセクションに基づいて適用されます：
custom_nodes: カスタムノードをインストールするパスdownload_model_base: モデルをダウンロードするパス
CLI ツール
ComfyUI-Manager は cm-cli を提供します。これは、ComfyUI を実行せずに Manager 機能を使用できるコマンドラインツールです。これは、カスタムノードのインストールの自動化や、ヘッドレス環境でのインストールの管理に役立ちます。
詳細な cm-cli ドキュメントについては、公式 cm-cli ガイド を参照してください。
より包括的な CLI 体験については、comfy-cli の使用を検討してください。
