部署失败：下载资源包

症状

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

原因

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

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

---

解决方法

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

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

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

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

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

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

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 的连接质量存在波动，偶尔超时并不异常。关闭部署对话框后重新点击部署即可重试。建议在网络状况较好的时段（如非高峰时段）重试。

---

仍然无法解决？

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

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