ComfyUI Manager：ノードをインストールして、修復する erreurs

#ComfyUI Managerの役割

ComfyUIは、基本的には組み込みノードで可能なことしか実行できません。それ以外の高度なControlNet、前処理器、拡大ツール、動画ツール、便利機能用ノードなどは、custom nodesと呼ばれる拡張機能によって提供されます。各custom nodeはPythonコードを含むGitリポジトリで、インストール先のcustom_nodesフォルダーに配置され、起動時に読み込まれます。

Managerがなければ、拡張機能のインストールには、リポジトリを手動でクローンし、適切な環境にPython依存関係をインストールしてから再起動する必要があります。Managerを使えば、これらの手順をインターフェースのウィンドウから実行できます。特に役立つ機能は、最終的には必ず使うことになる三つです。ワークフローに不足しているノードの検出、読み込みを拒否するノードの修復ボタン、そして更新に失敗した場合に元に戻すためのスナップショットです。

Custom Nodes Manager

カタログ：登録された拡張機能の検索、インストール、更新、無効化、アンインストール。

Install Missing Custom Nodes

開いているワークフローを解析し、赤いノードの原因となっている不足した拡張機能を一覧表示します。

Model Manager

既知のモデルを、正しいmodelsサブフォルダーに直接ダウンロードします。

Update All

インストール済みのすべての拡張機能を一度に更新します。便利ですが、動作していたインストール環境を壊すことが最も多いコマンドでもあります。

Snapshot Manager

インストールの状態（ComfyUIのバージョン、拡張機能、Pythonパッケージ）を保存し、後でその状態に戻せるようにします。

#前提条件：custom_nodesフォルダーの場所が分かっていること

Managerは他の拡張機能と同様に、custom_nodesフォルダーに配置されます。その場所はComfyUIのインストール方法によって異なり、「ノードをインストールしたのに表示されない」問題の半数は、拡張機能を誤ったフォルダーに配置したか、依存関係を誤ったPythonにインストールしたことが原因です。

ComfyUI Desktop

ベースフォルダーは、インストール時に選択したフォルダーです（通常はDocuments内のComfyUIフォルダー）。その中にcustom_nodes、models、input、outputがあります。Python環境はアプリケーションによって管理され、隣接する.venvフォルダーにあります。

Windows用のポータブル版

解凍したアーカイブ内：ComfyUI_windows_portable/ComfyUI/custom_nodes。専用のPythonはComfyUI_windows_portable/python_embededであり、依存関係のインストールには必ずこれを使用してください。システムのPythonは絶対に使用しないでください。

手動インストール（git clone）

ComfyUI/custom_nodesと、ComfyUI用に作成した仮想環境。すべてのpipコマンドの前に有効化してください。

いずれの場合も

Gitがインストールされ、アクセス可能になっている必要があります。ManagerはGitを使ってリポジトリをクローンします。Windowsでは、ターミナルでgit --versionを実行して確認してください。

ComfyUIをまだインストールしていない場合は、まずComfyUIのインストールガイドを参照してください。Desktop版、ポータブル版、手動インストールを比較しています。このガイドでは、すでに画像を生成できる環境があることを前提とします。

#バージョンに応じてComfyUI Managerをインストールする

状況は三つあり、第一の状況が2026年では最も一般的です。Manager はすでに存在します。何かをインストールする前に、まずインターフェースの上部バーに Manager ボタンがあるか確認してください。

#ケース1：すでに含まれている（Desktop、comfy-cli）

ComfyUI DesktopアプリにはManagerが組み込まれています。コマンドラインツールのcomfy-cliを使ってインストールした場合も同様で、Managerがデフォルトで追加されます。インターフェース上部にManagerボタンが表示されているなら、何もする必要はありません。次のセクションに進んでください。

#ケース2：新しい ComfyUI、統合済みだが無効化されている Manager

ComfyUIのメインリポジトリには、現在、オプションの依存関係としてManagerが組み込まれています。自動的には有効になりません。ComfyUIのルートにあるmanager_requirements.txtファイルをインストールし、--enable-managerオプションを付けてサーバーを起動する必要があります。最近の手動インストールでは、この方法を優先してください。Managerが使用中のComfyUIに対応したバージョンに従うためです。

cd ComfyUI
pip install -r manager_requirements.txt
python main.py --enable-manager

毎回このオプションを入力し直さなくて済むように、起動スクリプトまたはサービスに追加してください。ポータブル版では、run_nvidia_gpu.batファイル（またはAMD版・Intel版の相当ファイル）のコマンドライン末尾に配置します。

#ケース3：custom_nodes への通常インストール

これはManagerのリポジトリで現在も文書化されている従来の方法であり、manager_requirements.txtファイルを持たないComfyUIでは唯一可能な方法です。リポジトリをcustom_nodesにcloneし、その後ComfyUIを完全に再起動します。

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
# puis arrêter ComfyUI (Ctrl+C) et le relancer
cd ..
python main.py

cd ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
cd ..\..
.\python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
# puis relancer run_nvidia_gpu.bat

再起動したら、ターミナルを確認してください。ComfyUI-Managerとそのバージョン番号が記載された行があれば、読み込みが完了したことを確認できます。代わりに名前の横にIMPORT FAILEDと表示される場合、依存関係が正しいPythonにインストールされていません。ComfyUIの環境でpipコマンドを再実行してください。

#Managerでカスタムノードを追加する

1. 01
   カタログを開く

   上部バーのManagerをクリックし、続いてCustom Nodes Managerをクリックします。初回起動時には、参照されている拡張機能の一覧がダウンロードされるため、数秒かかることがあります。
2. 02
   拡張機能を検索する

   検索欄に名前またはキーワードを入力します。列には、作成者、説明、GitHubのスター数、バージョンによっては最終更新日が表示されます。作成者が推奨されたリポジトリと本当に一致していることを確認してください。似た名前はよくあります。
3. 03
   インストール

   Installをクリックします。Managerはリポジトリをcustom_nodesにクローンし、requirements.txtに記載された依存関係をインストールします。操作中はターミナルにログが流れます。拡張機能がComfy Registryに存在する場合、Managerは通常、最新のGitリビジョンではなく、公開済みの番号付きバージョンを提示します。より安定した公開済みバージョンを選んでください。
4. 04
   再起動

   再起動を促すバナーが表示されます。承認してください。ComfyUIが再起動し、すべての拡張機能を再読み込みして、ブラウザーが再接続します。インターフェースが自動的に戻らない場合は、ページを更新してください。
5. 05
   確認する

   キャンバスをダブルクリックし、拡張機能のノード名を入力します。一覧に表示されれば完了です。表示されない場合は、インストール済みなのに存在しないノードのセクションを読んでください。

スクリプトやインターフェースを使わないインストールでは、comfy-cliが同じ用途をコマンドラインで提供します。comfy node installに続けて拡張機能名を指定すると、アクティブなComfyUIインストールにインストールされます。Managerとcomfy-cliは同じcustom_nodesフォルダーを読み取るため、両方を併用できます。

#不足しているノード：ワークフローを開くとノードが赤く表示される

これはManagerの主要な使用例です。オンラインで見つけたワークフローや画像から抽出したワークフローを読み込むと、ComfyUIは欠落しているノード種別の一覧と、キャンバス上の赤いブロックを表示します。そのワークフローは、まだインストールしていない拡張機能を使用しています。

1. 01
   不足しているタイプの一覧を読む

   警告ウィンドウには、ノードの内部名が表示されます。名前を控えておいてください。自動検出に失敗した場合に、拡張機能を見つけるのに役立ちます。
2. 02
   Install Missing Custom Nodesを実行する

   Managerメニューのこのボタンは、欠落しているノードと既知の拡張機能データベースを照合し、それらを提供する拡張機能を表示します。チェックを入れてインストールしてください。
3. 03
   ワークフローを再起動して再読み込みする

   再起動後、ワークフローファイルを開き直します（または画像をもう一度ドラッグします）。赤いノードは通常の色に戻っているはずです。
4. 04
   残ったファイルを手動で処理する

   ノードが欠落したままの場合、検出でその拡張機能を見つけられていません。参照登録されていない、名前が変更された、または作成者がノード名を変更した可能性があります。リポジトリやワークフローの出所であるフォーラムからノードの内部名を探し、カタログでその名前を使って拡張機能をインストールしてください。

よくある落とし穴は二つあります。一つ目は、直接ダウンロードリンク以外ではどこにも見つからない拡張機能を要求するワークフローです。これは、後述する悪意のあるノードのパターンなので、警戒して扱ってください。二つ目は、実際にはComfyUI自体に属する不足ノードで、使用しているバージョンが古すぎるケースです。この場合の解決策はComfyUIを更新することであり、何かをインストールすることではありません。

#ノードはインストール済みだが表示されない：IMPORT FAILED、無効化、間違ったフォルダー

Managerではインストール済みと表示されるのに、インターフェースにノードが存在しない場合があります。診断はComfyUI起動時のターミナルで行います。各拡張機能が読み込み時間とともに一覧表示され、失敗したものにはIMPORT FAILEDと、それに続くPythonのトレースが付けられます。このトレースだけが役立つ情報なので、助けを求める前にコピーしてください。

ModuleNotFoundErrorによるIMPORT FAILED

Python依存関係が不足しています。Custom Nodes ManagerでImport Failedを選択し、Try fixをクリックしてください。Managerが拡張機能の依存関係を再インストールします。失敗した場合は、ComfyUIのPython（ポータブル版ではpython_embeded）を使って、拡張機能のrequirements.txtを手動でインストールしてください。

バージョンエラーによるIMPORT FAILED

この拡張機能は、別の拡張機能またはComfyUIと互換性のないパッケージ（多くの場合torch、numpy、transformers）のバージョンを要求しています。リポジトリのissueを読む、使用頻度の低い拡張機能を無効にする、修正を待つなど、判断が必要です。torchのバージョンを無理に固定しないでください。ComfyUIが壊れてしまいます。

拡張機能が無効です

Managerは、フォルダー名に.disabledという接尾辞を追加して拡張機能を無効化します。ComfyUIはその拡張機能を完全に無視するようになります。再有効化するには、カタログでDisabledを検索するか、接尾辞を手動で削除してください。

誤ったフォルダー

2つのインストール環境（Desktop版とポータブル版、または2つのclone）があり、拡張機能がもう一方のcustom_nodesに入っています。読み込まれているフォルダーの正確なパスは、起動時にターミナルの最初の数行に表示されます。

空または不完全なリポジトリ

中断されたクローン処理では、コードのないフォルダーが残ります。拡張機能のフォルダーを削除して、再インストールしてください。

ComfyUI自体が起動しなくなった場合や、インストール後にインターフェースが不安定になった場合、公式のトラブルシューティングドキュメントでは、二分探索によって原因を切り分けることを推奨しています。まず、拡張機能を一切使わずにComfyUIを起動し、問題が本当にカスタムノードに起因することを確認してください。

python main.py --disable-all-custom-nodes

この方法ですべて動作する場合は、custom_nodesフォルダーの半分を別のフォルダーに移動して再起動し、残りの半分についても同じ操作を繰り返し、問題の拡張機能を特定します。拡張機能が十個なら、再起動は四回で十分です。その後、Managerからアンインストールし、ターミナルのトレースを添えてリポジトリで問題を報告してください。

#レジストリのエラー：ノード一覧が読み込まれない

Managerはカタログをローカルに保存していません。起動時に、Managerのリポジトリから拡張機能の一覧をダウンロードし、公開済みの拡張機能については、作者がバージョン番号付きのリリースを公開するComfy Org公式リポジトリであるComfy Registryに問い合わせます。この取得に失敗すると、カタログが空のままになったり、ノードのインストールが終わらなくなったり、一覧の読み込みに失敗したことを示すメッセージが表示されたりします。

サーバーからネットワークにアクセスできない

Managerはブラウザーからではなく、ComfyUIを実行しているマシンからダウンロードします。リモートサーバーやコンテナでは、その環境からインターネットに接続できること（プロキシ、ファイアウォール、DNS）を確認してください。そのマシンからgithub.comへcurlテストを実行すれば、原因を切り分けられます。

データベースモード

ManagerウィンドウのDBセレクターで、リモートチャンネルからリストのローカルコピーに切り替えられます。ローカルモードでは、GitHubにアクセスできない場合でも、すでに認識されている拡張機能を使って作業を続けられます。そこから追加された拡張機能は表示されません。

Canal

Managerでは、default、recent、legacy、devなど、複数のリストチャンネルを利用できます。拡張機能が表示されない場合は、さらに調べる前にdefaultチャンネルへ戻してください。他のチャンネルは、古い拡張機能や実験的な拡張機能向けです。

GitHub APIの制限

多数のリクエストを受けると、GitHubは匿名の呼び出しを一時的に拒否することがあります。何度も繰り返し実行するより、数分待ってください。

セキュリティレベルにより操作が拒否されました

Managerから現在のセキュリティレベルでは操作が許可されていないと表示された場合、ネットワークエラーではありません。次のセクションを読んでください。

最後の手段として現在も有効なのが、custom_nodesにgit cloneで手動インストールし、requirements.txtを適用して再起動する方法です。その後、Managerは拡張機能をインストール済みとして認識し、更新できるようになります。

#有効化する前に危険な拡張機能を見分ける

カスタムノードは、ComfyUIの起動時にサーバーを起動したユーザーの権限で実行されるPythonコードです。ファイル、ブラウザーのセッションCookie、ウォレットを読み取ったり、インターネットにアクセスしたりできます。これは理論上の話ではありません。2026年1月、ComfyUIの公式リポジトリは、Comfy Registry上で「Upscaler_4K」という名前で公開された一連のノードについて文書化しました。これらはブラウザー、暗号通貨ウォレット、Discordトークンを標的とする情報窃取マルウェアをインストールしていました。2026年4月には、Censysが、認証なしでコードを実行するカスタムノードを悪用し、インターネットに公開されたComfyUIインスタンスを狙ったキャンペーンについて報告しました。

Managerには安全策が組み込まれており、そのレベルはconfig.iniファイルのsecurity_levelキーで設定します。Managerのリポジトリでは、strong、normal（デフォルト値）、normal-、weakの4つの値が説明されています。デフォルトレベルでは、任意のGit URLからのインストールや、要求に応じたpipパッケージのインストールなど、特にリスクの高い操作がブロックされます。また、ComfyUIを非ローカルアドレスに対する--listen付きで起動すると、制限はさらに厳しくなります。weakレベルではすべての防壁が解除されます。ネットワーク上で待ち受けていないマシンで、特定の操作を行う間だけ有効にし、その後はnormalに戻してください。レベルごとに許可される操作の正確な一覧はManagerのREADMEに記載されており、不明点がある場合はそれが基準となります。

リンクではなくカタログを使う

カタログとRegistryの拡張機能は少なくとも識別されており、報告があった場合は削除できます。直接ダウンロードリンクや履歴のないリポジトリは、その対象ではありません。

作者、履歴、スターを確認する

先週作成され、コミットが二つしかなく、issueもなく、既知の拡張機能を模倣した名前のリポジトリは、罠のノードの典型的な特徴です。スターだけでは何も証明できませんが、実際に使われている拡張機能にはスターがあり、未解決のissueもあります。

うたい文句には注意する

奇跡の拡大ツール、「制限解除済み」の商用モデル、ほかでは見つからない一つの拡張機能だけを要求するワークフロー：デフォルトでは拒否してください。

requirements.txtを読む

不明な拡張機能をインストールする前に、そのリポジトリを開いて依存関係の一覧を確認してください。画像処理とは無関係なパッケージ（ブラウザーへのアクセス、低レベルネットワーク、特殊なアーカイブ圧縮など）は警戒すべき兆候です。

保護なしでComfyUIを決して公開しない

--listenを指定しない場合、ComfyUIは127.0.0.1でのみ待ち受けます。ネットワーク上に公開する必要がある場合は、パスワード付きのリバースプロキシまたはVPNを前段に配置し、security_levelはnormalに維持してください。

#すべてを壊さずに更新する

更新は、インストールに次いで障害の二番目に多い原因です。ComfyUIは急速に進化していますが、拡張機能の対応は遅れがちで、Update Allはすべてを一度に適用します。半日を失わないための習慣は三つあります。

1. 01
   先にスナップショットを取得する

   Snapshot Manager、続いてSave snapshotを選択します。ManagerはComfyUIのリビジョン、各拡張機能のリビジョン、Pythonパッケージの一覧をsnapshotsフォルダーに保存します。更新によってワークフローが壊れた場合は、再起動後にRestoreを実行すると、すべてをこの状態に戻せます。
2. 02
   拡張機能を一つずつ更新する

   カタログでUpdateを選択し、まず必要な拡張機能を更新します。対象のワークフローをテストしてください。単純な構成ではUpdate Allも便利ですが、スナップショットを取った後に実行してください。
3. 03
   ComfyUIを個別に更新する

   Update ComfyUIボタンはコアを更新します。拡張機能が要求した場合に実行し、習慣的には行わないでください。コアを更新するたびに、保守されていない拡張機能が壊れる可能性があります。ComfyUIのREADMEでも、最新のコミットによって多くの拡張機能が壊れる可能性があると注意されています。

ComfyUI Desktopでは、コアはアプリケーションによって更新され、安定版に追従します。Managerは拡張機能にのみ使用します。最新のコミットに追従するポータブル版と手動インストールでは、スナップショットだけが頼みの綱です。動作するワークフローは、より新しいバージョンよりも価値があります。

#さらに詳しく

Managerは拡張機能の問題を解決しますが、グラフの理解に代わるものではありません。以下のガイドでは、ComfyUIのインストールからcustom nodesが必要な用途まで、残りの流れを扱います。

• ComfyUI：ローカルでのインストールと使い始め方
• ControlNet：画像を構成する、カスタムノードの典型的な用途
• ローカルで画像を生成する：ツールの概要
• Fooocus：ノードも拡張機能も使わない代替手段

このガイドで参照した公式情報源：ComfyUIドキュメントのManagerのページおよびcustom nodesのインストールページ、custom nodesのトラブルシューティングページ、そしてセキュリティレベルについて説明したComfyUI-ManagerリポジトリのREADMEです。記載しているメニュー名は、これらのページで説明されているManagerのインターフェースに対応していますが、バージョンによって異なる場合があります。

• ComfyUIドキュメント：Managerのインターフェース
• ComfyUIドキュメント：カスタムノードをインストールする
• ComfyUIドキュメント：custom nodesのトラブルシューティング
• ComfyUI-Managerリポジトリ（README、セキュリティレベル）