ComfyUI最实用的功能之一就是Custom Nodes Manager，也就是节点管理器。很多人装好ComfyUI第一件事就是打开Manager狂装各种节点包，结果发现点下Install按钮之后，界面显示Installing就再也不动了，等十分钟刷新一看，节点压根没装上。这种问题十有八九出在网络层面，具体说就是ComfyUI Manager底层调用了git clone命令去GitHub拉取仓库，而这个请求在国内网络环境下经常超时。这篇文章就把排查思路和几种解决方案完整梳理一遍。
先确认卡住的位置：看日志而不是瞎猜
遇到安装卡住，第一步永远是打开ComfyUI的启动控制台看输出。Manager安装节点时会实时打印命令执行过程，如果你看到类似### ComfyUI-Manager: EXECV: git clone https://github.com/xxx/xxx这样的输出之后长时间没有任何新内容，基本可以断定是git clone阶段网络不通。如果报错信息是Failed to clone或者Killed，则说明clone进程被强制中断，同样是网络问题居多。
还有一种情况是Manager启动时本身就连不上GitHub，导致节点列表一直显示Fetching，或者Install按钮点了没反应。这属于同一类问题：ComfyUI Manager默认的channel地址和数据库文件都托管在GitHub上，网络不通时整个Manager的功能都会受影响。所以核心思路就一个，让git能够顺利访问GitHub仓库，要么走代理，要么走镜像加速。
方案一：给Git全局配置镜像加速地址
最省事的做法是修改git的全局配置，把GitHub的请求通过加速前缀转发。常用的加速站点有好几个，这里以gh-proxy为例说明。打开命令行，执行下面的命令：
git config --global url."https://gh-proxy.com/https://github.com/".insteadOf "https://github.com/" git config --global url."https://gh-proxy.com/git://github.com/".insteadOf "https://github.com"
执行之后，所有对github.com的clone请求都会自动替换成走加速站点的地址，ComfyUI Manager调用git时也会生效。配置完成后可以手动测试一下：
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
如果几秒内开始输出对象计数，说明加速生效了。需要注意的是，加速站点属于公益服务，偶尔不稳定，如果某个站点失效，可以更换其他镜像前缀再试。另外这个配置是全局的，如果以后不想走加速，用git config --global --unset命令把对应的insteadOf配置删掉即可。
方案二：手动clone到custom_nodes目录
如果不想改全局git配置，也可以绕开Manager，自己把仓库拉下来。ComfyUI的第三方节点全部存放在安装目录下的custom_nodes文件夹里，只要仓库被正确clone进去，重启ComfyUI后Manager同样能识别到。操作步骤如下：
cd ComfyUI/custom_nodes git clone https://gh-proxy.com/https://github.com/ltdrdata/ComfyUI-Manager.git
clone完成后进入节点目录安装Python依赖。Windows下一般是运行python_embeded\python.exe -m pip install -r requirements.txt，如果是便携版，注意路径要对应到内置的Python环境；Linux或者用conda管理环境的话，先激活对应环境再执行pip install -r requirements.txt。装完依赖重启ComfyUI，节点就能正常加载了。
这个方法的好处是可控性强，每一步的输出都能看到，依赖装失败也能立刻发现原因。缺点是少了Manager的一键体验，适合愿意手动折腾、或者需要精确控制安装过程的用户。有些节点仓库带了install.py脚本做额外初始化，手动安装时记得检查一下仓库里有没有这个脚本，有的话手动执行一次。
方案三：解决Manager本身的channel和数据库更新失败
除了装节点，Manager界面顶部的Fetch按钮和数据库更新也依赖GitHub。如果点Fetch一直转圈，或者控制台报Failed to fetch /channel/default，可以打开Manager的设置界面，把Channel切换成镜像地址，比如常用的国内镜像channel。设置路径是Manager菜单里的Manager Settings，找到Channel选项修改。Database同样支持自定义，两个都改完之后重新点Fetch，节点列表基本就能刷出来了。
另外一个容易被忽略的细节是安全模式。ComfyUI启动时如果检测到部分节点加载失败，会进入safe mode，此时Manager界面上方会显示红色提示。安全模式下节点不会被加载，很多人误以为是安装失败又反复重装。遇到这种情况，先在控制台确认是哪个节点import报错，通常是依赖缺失，进入对应目录装好requirements再重启即可退出安全模式。
兜底方案：离线拷贝与常见坑位总结
如果网络环境实在没法走通，还有最后一种办法：在一台能访问GitHub的机器上把需要的节点仓库全部clone下来，打成一个压缩包拷贝到目标机器解压到custom_nodes目录。注意解压时要保留完整的.git目录和依赖清单文件，这样后续还能用git pull更新。
最后把几个高频坑位简单汇总一下。第一，git没有加入系统环境变量，Manager找不到git命令，控制台会报'git' is not recognized，装一下git并勾选加入PATH就行。第二，代理软件开着但git没走代理，可以用git config --global http.proxy指向本地代理端口解决。第三，clone成功了但节点不显示，多半是requirements没装或者版本冲突，看一下控制台的import错误信息就能定位。把这几个点排查清楚，ComfyUI Manager的节点安装基本就不会再卡住了。
ComfyUI ManagerGit clone超时镜像源配置修改时间：2026-09-03 11:37:33