部署失败：下载资源包

如果启动器卡在 下载资源包，问题通常还不在 ComfyUI 本身，而是在首次部署链路还没把受管安装包完整拉下来。

最常见的阻断是：

• GitHub 下载速度慢或不稳定
• 浏览器走了代理，但 launcher 没走到同一条代理路径
• 公司/学校/防火墙网络限制
• 目标磁盘空间不够，下载或解压中途失败

症状

首次部署 ComfyUI 环境时，进度卡在「下载资源包」步骤，然后提示部署失败。

原因

部署过程需要从 GitHub 下载 ComfyUI 安装包。国内用户访问 GitHub 速度慢或不稳定是最常见的失败原因。具体包括：

• 网络受限：国内直连 GitHub 速度慢、丢包率高，大文件下载容易超时
• 代理未正确配置：已有代理工具（Clash、v2rayN 等）但系统或 Git 未使用该代理
• 防火墙拦截：公司或学校网络封禁了 GitHub 域名
• 磁盘空间不足：安装目录所在磁盘剩余空间不够（至少需要 5GB）

这个故障真正阻断了什么

一旦这一步失败，受管环境其实还没有进入稳定已部署状态。 很多用户会把它统称为“ComfyUI 启动失败”，但更准确的说法其实是：

部署在完整安装完成前就失败了

所以这类问题通常应该先把下载链路打通，而不是先修 Python 包或插件依赖。

解决方法

最快的排查顺序

如果你想最快分桶，按这个顺序查：

1. 先确认代理工具真的在运行
2. 确认 launcher 里的代理配置填对了
3. 在同一台机器上确认 GitHub 本身能正常打开和下载
4. 检查目标磁盘剩余空间
5. 每次只修一个阻塞，再重新部署

这个顺序通常能很快区分出是“网络路径问题”还是“本机资源问题”。

方法一：在 Wonderful Launcher 中配置代理（推荐）

如果你已经在使用代理工具（Clash、v2rayN、Shadowrocket 等），只需要让 Wonderful Launcher 通过代理访问网络。

1. 打开 Wonderful Launcher 的「设置」页面
2. 找到「网络代理」设置
3. 填入你的代理地址，然后重新尝试部署

常见代理工具的本地地址：

方法二：配置系统环境变量（让所有程序走代理）

如果方法一不生效，可以在系统层面设置代理环境变量。

临时设置（仅当前终端会话有效）：

打开 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 替换为你的代理工具实际使用的端口号。

永久设置（写入系统环境变量）：

1. 按 Win + R，输入 sysdm.cpl，回车
2. 切换到「高级」选项卡，点击「环境变量」
3. 在「用户变量」中新建两个变量：
   • 变量名：HTTP_PROXY，变量值：http://127.0.0.1:7890
   • 变量名：HTTPS_PROXY，变量值：http://127.0.0.1:7890
4. 点击确定，重启 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

方法四：确认代理工具正在运行

很多时候问题不在于配置，而是代理工具本身没有开启。请逐项检查：

1. 打开你的代理工具（Clash Verge、v2rayN 等），确认它正在运行
2. 确认「系统代理」或「全局模式」已开启（不是仅规则模式）
3. 在浏览器中访问 https://github.com ，确认可以正常打开
4. 如果浏览器可以访问但部署仍失败，说明代理没有传递给 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-Manager

如果环境其实已经部署完成，只是 ComfyUI 本身后来又起不来了，改看：

• ComfyUI 启动失败？更快定位和恢复的方法
• ComfyUI 提示 No module named：按缺失模块名修复

仍然无法解决？

如果以上方法都尝试过仍然失败，请通过应用内的「联系我们」按钮联系技术支持，并提供以下信息：

• 你的网络环境（家庭宽带 / 公司网络 / 学校网络）
• 是否使用代理工具，工具名称和版本
• 部署失败时的错误提示截图