部署失败：安装 ComfyUI-Manager | Wonderful Launcher

症状

首次部署 ComfyUI 环境时，进度卡在「安装 ComfyUI-Manager」步骤，然后提示部署失败。

原因

ComfyUI-Manager 是 ComfyUI 的插件管理器（仓库地址：https://github.com/Comfy-Org/ComfyUI-Manager ）。Wonderful Launcher 在部署时会通过 git clone 将其下载到 custom_nodes/ 目录。以下情况可能导致克隆失败：

无法连接 GitHub：国内网络直连 GitHub 不稳定或被阻断
代理未传递给 Git：系统开了代理（Clash、V2Ray 等），但 Git 没有配置使用该代理
SSL 证书错误：企业网络、杀毒软件或防火墙拦截 HTTPS 流量，导致 Git 报 SSL certificate problem
路径过长：Windows 默认路径长度上限 260 字符，深层嵌套目录可能触发 Filename too long 错误
Git 未安装或版本过旧：系统缺少 Git 或版本低于 2.20

严重程度

高 — 阻断首次部署。但 ComfyUI 本身仍可使用，只是缺少插件管理功能。

解决方法

方法一：为 Git 配置代理（国内用户推荐）

如果你使用 Clash、V2Ray 等代理工具，需要让 Git 也走代理。打开命令提示符或 PowerShell，执行以下命令：

HTTP 代理（Clash 默认端口 7890）：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

SOCKS5 代理（部分工具使用 SOCKS5 端口）：

git config --global http.proxy socks5://127.0.0.1:7891
git config --global https.proxy socks5://127.0.0.1:7891

仅对 GitHub 生效（避免影响其他 Git 仓库）：

git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890

配置完成后，在 Wonderful Launcher 中重新尝试部署。

取消代理配置：

git config --global --unset http.proxy
git config --global --unset https.proxy

方法二：解决 SSL 证书错误

如果错误信息包含 SSL certificate problem，可能是企业网络、杀毒软件或防火墙劫持了 HTTPS 连接。

推荐方案 — 让 Git 使用 Windows 证书存储：

git config --global http.sslBackend schannel

这会让 Git 信任与浏览器相同的证书，通常可以解决企业网络环境下的 SSL 问题。

临时方案 — 关闭 SSL 验证（仅在可信网络中使用）：

git config --global http.sslVerify false

问题解决后务必恢复：

git config --global http.sslVerify true

更新 Git：

旧版 Git 的 CA 证书包可能过期。前往 https://git-scm.com/ 下载最新版本。

方法三：解决路径过长问题

如果错误信息包含 Filename too long，需要启用 Windows 长路径支持。

启用 Git 长路径：

以管理员身份打开命令提示符，执行：

git config --system core.longpaths true

启用 Windows 长路径（可选，需重启）：

以管理员身份打开 PowerShell，执行：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

修改后需注销或重启电脑。

此外，建议将 ComfyUI 安装到较短的路径（如 D:\ComfyUI），避免嵌套过深。

方法四：手动安装 ComfyUI-Manager

如果以上方法均无效，可以跳过自动安装，手动完成。

在 Wonderful Launcher 中找到你的 ComfyUI 安装路径（在环境页面查看），以下假设为 D:\ComfyUI。
打开命令提示符或 PowerShell，执行：

cd D:\ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git

如果直连失败，可以在 clone 时指定代理：

git clone -c http.proxy=http://127.0.0.1:7890 https://github.com/Comfy-Org/ComfyUI-Manager.git

验证安装是否成功：

dir D:\ComfyUI\custom_nodes\ComfyUI-Manager

应当能看到 __init__.py、js 目录等文件。如果目录存在且不为空，说明安装成功。

在 Wonderful Launcher 中重新启动 ComfyUI，Manager 会自动加载。

方法五：检查 Git 是否可用

确认 Git 已安装且可在命令行中使用：

git --version

如果提示找不到命令，请从 https://git-scm.com/ 下载安装 Git for Windows。安装时确保勾选「Add to PATH」选项。

仍然无法解决？

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

完整的错误提示截图
执行 git clone https://github.com/Comfy-Org/ComfyUI-Manager.git 的输出结果
执行 git config --global --list 的输出结果

症状