部署失败：安装 ComfyUI-Manager

如何修复在 ComfyUI-Manager 安装步骤发生的部署失败，尤其是在 Windows 网络环境下，GitHub 克隆、代理、SSL 或路径问题阻塞首次安装时。

30 秒分诊决策

如果在安装 ComfyUI-Manager 阶段部署失败，通常是由于 Git 连接 GitHub 网络失败 导致的。

检查本地代理：如果开启了全局代理，需要在终端配置 Git 代理，或尝试更换为加速网络节点。
检查 Git 安装：打开命令行输入 git --version 确认 Git 是否已正确安装。

如果您的启动器卡在 安装 ComfyUI-Manager 这一步，这通常不是随机的通用安装失败，而是几类可重现的首次部署问题之一：

GitHub 克隆无法访问 github.com
Git 可用，但代理设置未被传递
SSL 检查或杀毒软件破坏了 Git HTTPS
Windows 路径长度限制阻止了克隆
Git 未安装或版本过旧

理解这一点很重要，因为修复方式与 Python 包修复不同。ComfyUI-Manager 是在托管环境进入稳定的插件管理状态之前，通过 Git 克隆下来的。

症状

在 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 克隆路径的问题，再重试部署，而不是立即修复 Python 包。

严重程度

高 -- 阻塞首次部署。ComfyUI 本身仍可运行，但不具备插件管理功能。

解决方案

最快排查顺序

如果您希望走最短路径，请按以下顺序检查失败原因：

运行 git --version
在目标 custom_nodes 文件夹中手动重试克隆
如果挂起或无法连接，为 Git 配置代理
如果出现证书错误，将 Git 切换为 schannel
如果出现路径长度错误，缩短安装路径并启用长路径支持

该顺序通常能在几分钟内告诉您故障属于哪一类。

方案 1：为 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 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

方案 2：修复 SSL 证书错误

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

推荐方案 -- 使用 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/ 下载最新版本。

方案 3：修复路径过长错误

如果错误信息中包含 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），以避免目录嵌套过深。

方案 4：手动安装 ComfyUI-Manager

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

在 Wonderful Launcher 的环境页面中找到您的 ComfyUI 安装路径。以下示例假设路径为 D:\ComfyUI。
打开命令提示符或 PowerShell 并运行：

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

如果直接连接失败，可在命令中内联指定代理：

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 将自动加载。

方案 5：验证 Git 是否可用

确认 Git 已安装并可从命令行访问：

git --version

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

本页与其他启动错误的关系

本页针对的是启动器尝试克隆 ComfyUI-Manager 的 部署步骤。

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

仍未解决？

如果尝试上述所有方法后问题仍然存在，请通过应用内的"联系我们"按钮联系支持团队，并提供以下信息：

错误信息的完整截图
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git 的输出
git config --global --list 的输出

参考资料

先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。

下载 Wonderful Launcher 查看 credits 方案

这篇文件解決了你的問题嗎？

你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。