展開失敗:ComfyUI-Manager のインストール
ComfyUI-Manager のインストール段階での展開失敗エラーの解決。Git クローン、プロキシ設定、SSL 認証、ファイルパス長の対策。
30秒分診判定
ComfyUI-Manager のインストール段階で展開が失敗する場合、主な原因は Git による GitHub への接続エラー です。
- プロキシの確認:グローバルプロキシを使用している場合は、コマンドライン(Git)の通信もプロキシ経由に設定する必要があります。
- Git の確認:端末で
git --versionを実行し、Git が正しくインストールされているか確認してください。
ランチャーが 「ComfyUI-Manager をインストール中」 のステップで停止する場合、これは Python パッケージの問題ではなく、初回セットアップ時にプラグインマネージャー(ComfyUI-Manager)のクローンプロセスが失敗しています。
主な原因は以下の通りです:
- GitHub (github.com)へのアクセス失敗
- システムプロキシが Git に反映されていない
- SSL 認証エラー、またはセキュリティソフトによる Git HTTPS の通信切断
- Windows の最大パス長制限(260文字)によるクローン失敗
- システムに Git がインストールされていない
解決手順
解決策 1:Git にプロキシを設定する
プロキシツールを使用している場合は、Git に対しても同じプロキシポートを指定する必要があります。コマンドプロンプトまたは PowerShell を開いて実行します。
HTTP プロキシの設定:
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890GitHub への通信のみプロキシを適用する(推奨):
git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890設定完了後、Wonderful Launcher で展開を再試行します。
プロキシ設定の解除:
git config --global --unset http.proxy
git config --global --unset https.proxy解決策 2:SSL 認証エラーの解消
ログに SSL certificate problem というエラーが出ている場合、セキュリティソフトやネットワークの監視ツールが HTTPS 通信を干渉しています。
Windows の証明書ストアを使用する設定:
git config --global http.sslBackend schannelこれにより、Git はブラウザと同じ証明書ストアを信頼するようになり、SSL エラーを回避できます。
解決策 3:ファイルパスの長さ制限(260文字)の解決
エラーに Filename too long が含まれる場合、Windows の最大パス制限を解除する必要があります。
Git の最大パス制限を解除:
管理者権限でコマンドプロンプトを開き、実行します:
git config --system core.longpaths trueまた、ComfyUI のインストールフォルダをなるべく浅いパス(例:D:\ComfyUI)に配置することを推奨します。
解決策 4:ComfyUI-Manager の手動インストール
自動インストールが失敗し続ける場合は、手動でクローンを行うことも可能です。
- コマンドプロンプトを開き、インストール先の
custom_nodesディレクトリへ移動します(例:D:\ComfyUIにインストールした場合)。
cd D:\ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git- ファイルが正常にダウンロードされたか確認します:
dir D:\ComfyUI\custom_nodes\ComfyUI-Manager__init__.py 等のファイルが存在すればクローンは成功しています。ランチャーで ComfyUI を起動してください。
関連ガイド
実際の ComfyUI 環境で起きている問題なら、まず無料で Wonderful Launcher を使って確認してください。ランチャー内の修復フロー、タスクログ、実行環境チェックを一か所で確認できます。クレジットは画像生成と従量ツール用です。
Wonderful Launcher をダウンロードクレジットプランを見るDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.