部署失败：安装 ComfyUI-Manager

如果启动器卡在 安装 ComfyUI-Manager，这通常不是一个随机的“安装失败”。 它大多落在几类重复出现的首次部署问题里：

• GitHub clone 连不到 github.com
• 系统有代理，但 Git 没继承代理配置
• SSL 检查、杀毒软件或企业网络拦住了 Git HTTPS
• Windows 路径过长导致 clone 失败
• Git 没装好，或者版本太旧

这点很重要，因为它和 Python 缺包不是同一类故障。 ComfyUI-Manager 是通过 Git clone 拉进来的，失败点发生在“环境进入稳定插件管理状态之前”。

症状

首次部署 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 clone 路径打通，再重新部署，而不是先去修 Python 包。

严重程度

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

解决方法

最快的排查顺序

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

1. 先执行 git --version
2. 在目标 custom_nodes 目录里手动重试 clone
3. 如果卡住或连不上，先给 Git 配代理
4. 如果报证书错，先切 schannel
5. 如果报路径长度，先缩短安装路径并启用长路径

这个顺序通常几分钟内就能判断问题落在哪一类。

方法一：为 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

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

1. 在 Wonderful Launcher 中找到你的 ComfyUI 安装路径（在环境页面查看），以下假设为 D:\ComfyUI。

2. 打开命令提示符或 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

3. 验证安装是否成功：

dir D:\ComfyUI\custom_nodes\ComfyUI-Manager

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

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

方法五：检查 Git 是否可用

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

git --version

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

这页和其他“启动失败”文档是什么关系

这页只处理 部署阶段安装 ComfyUI-Manager 的问题。

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

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

仍然无法解决？

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

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