高频错误
部署失败:下载资源包
首次部署 ComfyUI 时下载资源包失败的排查与解决方法
症状
首次部署 ComfyUI 环境时,进度卡在「下载资源包」步骤,然后提示部署失败。
原因
部署过程需要从 GitHub 下载 ComfyUI 安装包。国内用户访问 GitHub 速度慢或不稳定是最常见的失败原因。具体包括:
- 网络受限:国内直连 GitHub 速度慢、丢包率高,大文件下载容易超时
- 代理未正确配置:已有代理工具(Clash、v2rayN 等)但系统或 Git 未使用该代理
- 防火墙拦截:公司或学校网络封禁了 GitHub 域名
- 磁盘空间不足:安装目录所在磁盘剩余空间不够(至少需要 5GB)
解决方法
方法一:在 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 的连接质量存在波动,偶尔超时并不异常。关闭部署对话框后重新点击部署即可重试。建议在网络状况较好的时段(如非高峰时段)重试。
仍然无法解决?
如果以上方法都尝试过仍然失败,请通过应用内的「联系我们」按钮联系技术支持,并提供以下信息:
- 你的网络环境(家庭宽带 / 公司网络 / 学校网络)
- 是否使用代理工具,工具名称和版本
- 部署失败时的错误提示截图
Wonderful Launcher 文档