部署失敗：安裝 ComfyUI-Manager

ComfyUI 部署卡在安裝 ComfyUI-Manager 時，優先排查 GitHub clone、代理、SSL、路徑長度和 Git 本身，而不是一上來修 Python 包。

如果啟動器卡在 安裝 ComfyUI-Manager，這通常不是一個隨機的“安裝失敗”。它大多落在幾類重複出現的首次部署問題裡：

GitHub clone 連不到 github.com
系統有代理，但 Git 沒繼承代理配置
SSL 檢查、殺毒軟件或企業網絡攔住了 Git HTTPS
Windows 路徑過長導致 clone 失敗
Git 沒裝好，或者版本太舊

這點很重要，因為它和 Python 缺包不是同一類故障。 ComfyUI-Manager 是通過 Git clone 拉進來的，失敗點發生在“環境進入穩定插件管理狀態之前”。

症狀

首次部署 ComfyUI 環境時，進度卡在「安裝 ComfyUI-Manager」步驟，然後提示部署失敗。

原因

ComfyUI-Manager 是 ComfyUI 的插件管理器（倉庫地址：https://github.com/Comfy-Org/ComfyUI-Manager ）。Wonderful Launcher 在部署時會通過 git clone 將其下載到 custom_nodes/ 目錄。以下情況可能導致克隆失敗：

無法連接 GitHub：國內網絡直連 GitHub 不穩定或被阻斷
代理未傳遞給 Git：系統開了代理（Clash、V2Ray 等），但 Git 沒有配置使用該代理
SSL 證書錯誤：企業網絡、殺毒軟件或防火牆攔截 HTTPS 流量，導致 Git 報 SSL certificate problem
路徑過長：Windows 默認路徑長度上限 260 字符，深層嵌套目錄可能觸發 Filename too long 錯誤
Git 未安裝或版本過舊：系統缺少 Git 或版本低於 2.20

這個故障真正阻斷了什麼

一旦這一步失敗，首次部署可能會停在“環境尚未完全就緒”的階段。很多用戶會把它描述成“ComfyUI 啟動失敗”，但更準確的說法其實是：

部署還沒完成，插件管理器初始化就先失敗了

所以這類問題通常應該先把 Git clone 路徑打通，再重新部署，而不是先去修 Python 包。

嚴重程度

高 — 阻斷首次部署。但 ComfyUI 本身仍可使用，只是缺少插件管理功能。

解決方法

最快的排查順序

如果你想最快分桶，按這個順序查：

先執行 git --version
在目標 custom_nodes 目錄裡手動重試 clone
如果卡住或連不上，先給 Git 配代理
如果報證書錯，先切 schannel
如果報路徑長度，先縮短安裝路徑並啟用長路徑

這個順序通常幾分鐘內就能判斷問題落在哪一類。

方法一：為 Git 配置代理（國內用戶推薦）

如果你使用 Clash、V2Ray 等代理工具，需要讓 Git 也走代理。打開命令提示符或 PowerShell，執行以下命令：

HTTP 代理（Clash 默認端口 7890）：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

SOCKS5 代理（部分工具使用 SOCKS5 端口）：

git config --global http.proxy socks5://127.0.0.1:7891
git config --global https.proxy socks5://127.0.0.1:7891

僅對 GitHub 生效（避免影響其他 Git 倉庫）：

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

方法二：解決 SSL 證書錯誤

如果錯誤信息包含 SSL certificate problem，可能是企業網絡、殺毒軟件或防火牆劫持了 HTTPS 連接。

推薦方案 — 讓 Git 使用 Windows 證書存儲：

git config --global http.sslBackend schannel

這會讓 Git 信任與瀏覽器相同的證書，通常可以解決企業網絡環境下的 SSL 問題。

臨時方案 — 關閉 SSL 驗證（僅在可信網絡中使用）：

git config --global http.sslVerify false

問題解決後務必恢復：

git config --global http.sslVerify true

更新 Git：

舊版 Git 的 CA 證書包可能過期。前往 https://git-scm.com/ 下載最新版本。

方法三：解決路徑過長問題

如果錯誤信息包含 Filename too long，需要啟用 Windows 長路徑支持。

啟用 Git 長路徑：

以管理員身份打開命令提示符，執行：

git config --system core.longpaths true

啟用 Windows 長路徑（可選，需重啟）：

以管理員身份打開 PowerShell，執行：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

修改後需註銷或重啟電腦。

此外，建議將 ComfyUI 安裝到較短的路徑（如 D:\ComfyUI），避免嵌套過深。

方法四：手動安裝 ComfyUI-Manager

如果以上方法均無效，可以跳過自動安裝，手動完成。

在 Wonderful Launcher 中找到你的 ComfyUI 安裝路徑（在環境頁面查看），以下假設為 D:\ComfyUI。
打開命令提示符或 PowerShell，執行：

cd D:\ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git

如果直連失敗，可以在 clone 時指定代理：

git clone -c http.proxy=http://127.0.0.1:7890 https://github.com/Comfy-Org/ComfyUI-Manager.git

驗證安裝是否成功：

dir D:\ComfyUI\custom_nodes\ComfyUI-Manager

應當能看到 __init__.py、js 目錄等文件。如果目錄存在且不為空，說明安裝成功。

在 Wonderful Launcher 中重新啟動 ComfyUI，Manager 會自動加載。

方法五：檢查 Git 是否可用

確認 Git 已安裝且可在命令行中使用：

git --version

如果提示找不到命令，請從 https://git-scm.com/ 下載安裝 Git for Windows。安裝時確保勾選「Add to PATH」選項。

這頁和其他“啟動失敗”文檔是什麼關係

這頁只處理 部署階段安裝 ComfyUI-Manager 的問題。

如果環境其實已經部署完成，只是 ComfyUI 本身後來又起不來了，更應該看：

仍然無法解決？

如果嘗試以上方法後仍然失敗，請通過應用內的「聯繫我們」按鈕聯繫技術支持，並附上以下信息：

完整的錯誤提示截圖
執行 git clone https://github.com/Comfy-Org/ComfyUI-Manager.git 的輸出結果
執行 git config --global --list 的輸出結果

來源參考

先按上面的步驟定位根因。還卡住時，可以下載 Wonderful Launcher 檢查目前機器；啟動器原生修復、任務日誌和執行階段檢查會集中在一起。credits 只用於圖片生成和按量工具。

下載 Wonderful Launcher 查看 credits 方案

這篇文件解決了你的問題嗎？

你的回饋會幫助我們優先補強真實 ComfyUI 排障文件。