部署失败：正在下载资源包

如果启动器卡在正在下载资源包这一步，问题通常不在 ComfyUI 本身。这通常意味着首次运行的部署流程无法从 GitHub 或其他上游服务器完成托管安装包的下载。

最常见的阻碍因素包括：

• GitHub 下载速度不稳定
• 浏览器配置了代理，但启动器的网络路径未经过代理
• 防火墙或学校/企业网络限制
• 磁盘剩余空间不足，无法完成解压

症状

在 ComfyUI 环境首次部署期间，进度卡在"正在下载资源包"步骤，随后报告部署失败。

原因

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

• 网络限制：直连 GitHub 可能速度缓慢、丢包率高，导致大文件下载超时
• 代理配置错误：已安装代理工具（Clash、v2rayN 等），但系统或 Git 的流量未经过代理路由
• 防火墙拦截：企业或学校网络可能屏蔽了 GitHub 域名
• 磁盘空间不足：安装目标驱动器的可用空间不够（至少需要 5 GB）

此失败会阻断什么

如果此步骤失败，托管环境将无法到达稳定的已部署状态。许多用户将其描述为"ComfyUI 启动失败"，但更准确的诊断是：

ComfyUI 尚未完成安装，部署就已失败

因此，先解决下载路径问题通常比修复 Python 包或插件依赖更为有效。

解决方案

最快的排查顺序

如果希望以最短路径定位问题，请按以下顺序排查：

1. 确认代理工具是否真的在运行
2. 确认启动器中的代理设置是否正确
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 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 至少需要 5 GB 的可用磁盘空间。

在 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 时失败，请参考：

• 部署失败：安装 ComfyUI-Manager

如果环境已完成部署，但 ComfyUI 本身无法启动，请参考：

• ComfyUI 启动失败
• 修复 ComfyUI 中的 No module named 错误

仍未解决？

如果以上方法均无效，请通过应用内的联系我们按钮联系支持团队，并提供以下信息：

• 您的网络环境（家庭宽带 / 企业网络 / 学校网络）
• 是否使用代理工具，以及工具的名称和版本
• 部署失败时显示的错误信息截图

参考资料

• Wonderful Launcher GitHub 仓库
• ComfyUI GitHub 仓库
• ComfyUI GitHub 发布页