部署失敗：下載資源包
首次部署 ComfyUI 時如果卡在下載資源包，優先排查 GitHub 下載鏈路、代理路徑、防火牆和磁盤空間，而不是先修 Python 包。
如果啟動器卡在 下載資源包，問題通常還不在 ComfyUI 本身，而是在首次部署鏈路還沒把受管安裝包完整拉下來。
最常見的阻斷是：
- GitHub 下載速度慢或不穩定
- 瀏覽器走了代理，但 launcher 沒走到同一條代理路徑
- 公司/學校/防火牆網絡限制
- 目標磁盤空間不夠，下載或解壓中途失敗
症狀
首次部署 ComfyUI 環境時，進度卡在「下載資源包」步驟，然後提示部署失敗。
原因
部署過程需要從 GitHub 下載 ComfyUI 安裝包。國內用戶訪問 GitHub 速度慢或不穩定是最常見的失敗原因。具體包括：
- 網絡受限：國內直連 GitHub 速度慢、丟包率高，大文件下載容易超時
- 代理未正確配置：已有代理工具（Clash、v2rayN 等）但系統或 Git 未使用該代理
- 防火牆攔截：公司或學校網絡封禁了 GitHub 域名
- 磁盤空間不足：安裝目錄所在磁盤剩餘空間不夠（至少需要 5GB）
這個故障真正阻斷了什麼
一旦這一步失敗，受管環境其實還沒有進入穩定已部署狀態。 很多用戶會把它統稱為“ComfyUI 啟動失敗”，但更準確的說法其實是：
部署在完整安裝完成前就失敗了
所以這類問題通常應該先把下載鏈路打通，而不是先修 Python 包或插件依賴。
解決方法
最快的排查順序
如果你想最快分桶，按這個順序查：
- 先確認代理工具真的在運行
- 確認 launcher 裡的代理配置填對了
- 在同一臺機器上確認 GitHub 本身能正常打開和下載
- 檢查目標磁盤剩餘空間
- 每次只修一個阻塞，再重新部署
這個順序通常能很快區分出是“網絡路徑問題”還是“本機資源問題”。
方法一：在 Wonderful Launcher 中配置代理（推薦）
如果你已經在使用代理工具（Clash、v2rayN、Shadowrocket 等），只需要讓 Wonderful Launcher 通過代理訪問網絡。
- 打開 Wonderful Launcher 的「設置」頁面
- 找到「網絡代理」設置
- 填入你的代理地址，然後重新嘗試部署
常見代理工具的本地地址：
| 代理工具 | HTTP 代理地址 | SOCKS5 代理地址 |
|---|---|---|
| Clash / Clash Verge | http://127.0.0.1:7890 | socks5://127.0.0.1:7891 |
| v2rayN | http://127.0.0.1:10809 | socks5://127.0.0.1:10808 |
| Shadowsocks | http://127.0.0.1:1080 | socks5://127.0.0.1:1080 |
注意：以上端口號為各工具的默認值，請打開你的代理工具確認實際端口。
方法二：配置系統環境變量（讓所有程序走代理）
如果方法一不生效，可以在系統層面設置代理環境變量。
臨時設置（僅當前終端會話有效）：
打開 PowerShell，執行：
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"或在 CMD 中執行：
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890請將 7890 替換為你的代理工具實際使用的端口號。
永久設置（寫入系統環境變量）：
- 按
Win + R，輸入sysdm.cpl，回車 - 切換到「高級」選項卡，點擊「環境變量」
- 在「用戶變量」中新建兩個變量：
- 變量名：
HTTP_PROXY，變量值：http://127.0.0.1:7890 - 變量名：
HTTPS_PROXY，變量值：http://127.0.0.1:7890
- 變量名：
- 點擊確定，重啟 Wonderful Launcher 後重試部署
方法三：配置 Git 代理
部署過程會調用 Git 從 GitHub 克隆倉庫。如果 Git 沒有走代理，即使瀏覽器能訪問 GitHub，部署仍然會失敗。
設置 Git 全局代理：
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890僅對 GitHub 設置代理（推薦，不影響其他 Git 倉庫）：
git config --global http.https://github.com.proxy http://127.0.0.1:7890使用 SOCKS5 代理：
git config --global http.https://github.com.proxy socks5://127.0.0.1:7891驗證配置是否生效：
git config --global --get http.proxy清除代理設置（如果需要恢復）：
git config --global --unset http.proxy
git config --global --unset https.proxy方法四：確認代理工具正在運行
很多時候問題不在於配置，而是代理工具本身沒有開啟。請逐項檢查：
- 打開你的代理工具（Clash Verge、v2rayN 等），確認它正在運行
- 確認「系統代理」或「全局模式」已開啟（不是僅規則模式）
- 在瀏覽器中訪問 https://github.com ，確認可以正常打開
- 如果瀏覽器可以訪問但部署仍失敗，說明代理沒有傳遞給 Git，請參考方法二或方法三
方法五：檢查磁盤空間
部署 ComfyUI 需要至少 5GB 磁盤空間。
在 PowerShell 中檢查磁盤剩餘空間：
Get-PSDrive -PSProvider FileSystem | Select-Object Name, @{N='Free(GB)';E={[math]::Round($_.Free/1GB,2)}}, @{N='Used(GB)';E={[math]::Round($_.Used/1GB,2)}}在 CMD 中檢查：
wmic logicaldisk get name,freespace,size如果空間不足，清理磁盤或在 Wonderful Launcher 設置中更換安裝目錄到空間充足的磁盤。
方法六：重試部署
GitHub 的連接質量存在波動，偶爾超時並不異常。關閉部署對話框後重新點擊部署即可重試。建議在網絡狀況較好的時段（如非高峰時段）重試。
這頁和其他“啟動失敗”文檔是什麼關係
這頁只處理 首次部署裡的資源包下載步驟。
如果資源包已經下完，但後面卡在 ComfyUI-Manager clone，改看：
如果環境其實已經部署完成，只是 ComfyUI 本身後來又起不來了，改看：
仍然無法解決？
如果以上方法都嘗試過仍然失敗，請通過應用內的「聯繫我們」按鈕聯繫技術支持，並提供以下信息：
- 你的網絡環境（家庭寬帶 / 公司網絡 / 學校網絡）
- 是否使用代理工具，工具名稱和版本
- 部署失敗時的錯誤提示截圖
來源參考
先按上面的步驟定位根因。還卡住時，可以下載 Wonderful Launcher 檢查目前機器；啟動器原生修復、任務日誌和執行階段檢查會集中在一起。credits 只用於圖片生成和按量工具。
下載 Wonderful Launcher查看 credits 方案這篇文件解決了你的問題嗎？
你的回饋會幫助我們優先補強真實 ComfyUI 排障文件。