ComfyUI 怎么安装第三方节点
工作流里缺节点,图就跑不起来。讲清节点该放进哪个目录、用 Manager 怎么装、依赖冲突怎么绕,以及装完怎么确认节点真的加载了。
拿到别人的工作流,一点运行就提示缺少节点,或者装完节点界面里还是找不到。ComfyUI 本体只负责加载 custom_nodes 目录下的代码,不自带应用商店,装节点这件事有一半坑在目录和依赖上。这篇讲清楚两条安装路径和怎么收尾。
入口在哪
所有自定义节点都住在 ComfyUI 根目录下的 custom_nodes 文件夹里,这是唯一的入口。往里放代码就是安装,删掉文件夹就是卸载,没有单独的安装器。
第一条路是手动放:把节点仓库下载下来,解压到 custom_nodes 下面。第二条路是先装 ComfyUI Manager 这个节点,装好之后界面里会多出管理入口,能搜索安装、能一键补装缺失节点、也能按仓库地址安装。Manager 本身也是普通自定义节点,所以第一次还是得手动放一次,之后才省事。界面上的按钮名称不同版本略有差别,以自己看到的为准。
具体步骤
- 先确认目录层级。节点代码要直接落在 custom_nodes 下,路径里只多一层文件夹名,不要再套一层同名目录,套了会加载不到。
- 装 Manager:在 custom_nodes 目录里用 git 把它的仓库拉下来,或者下载压缩包解压进去,然后完整重启 ComfyUI 进程。
- 打开 Manager,用关键词搜节点名,核对作者再点安装。装完必须重启,刷新网页不算,Python 模块不会重新加载。
- 带依赖的节点会在安装时跑 pip。装完回到控制台,从头翻一遍有没有红色报错。
- 手动装的,把仓库放进 custom_nodes,进入该目录执行 pip 安装 requirements 里列出的依赖,再重启。
- 加载别人的工作流提示缺节点,用 Manager 的补装缺失节点功能一次补齐,然后重启再打开工作流。
几个坑
- 不重启。网页刷新只是重新连后端,新装的代码根本没被读到,这是最常见的「装了没用」。
- 依赖冲突。不同节点可能要求同一个库的不同版本,装多了容易把主环境弄坏。建议一开始就用独立的 Python 环境,坏了直接重建,别在主环境里硬修。
- 目录名不干净。压缩包解压出来常带后缀,目录名和节点名对不上时偶有加载失败,改成简短干净的名字更稳。
- 网络拉不动。git 拉取超时就换镜像或者手动下压缩包,别对着同一个地址反复重试。
- 旧进程没退。后台还留着一份在跑,新进程起不来,浏览器连的还是旧的,看着像没生效。
- 别在天天要用的环境里随手升级节点。升级前把 custom_nodes 和工作流文件各备份一份,出问题能退回去。
怎么验证
三个信号都正常,才算真的装好:启动日志里没有加载失败和导入错误;重启后在节点面板里按名字能搜到它;用它自带的示例工作流能跑出结果。
再补一步:把当前工作流保存成文件,重新拖回界面,如果不再提示缺节点,说明节点和参数都被正确识别。这一步能挡掉「装上了但版本不匹配」的情况。
常见问题
装完在节点栏里找不到
先看目录层级对不对,再看启动日志里有没有这个节点加载失败的记录。有的节点藏在特定分类下面,把菜单展开找一遍。也可能是没重启或者浏览器用了旧界面,强制刷新一次再看。
安装时报依赖错误
多数是版本或者网络问题。看报错里的包名和版本号,单独装那个包再重试。用独立环境的话,直接重建环境比在坏掉的依赖里一个个修快得多。
更新后原工作流打不开
新版本可能改了参数名或者删了节点。先退回旧版本节点和旧工作流,确认能跑,再逐个升级。工作流存的是纯文本,出问题时还能看出是哪个节点对不上。
一句话总结:节点放进 custom_nodes,用 Manager 装、装完必重启,用独立 Python 环境和备份挡住依赖冲突,出问题先看启动日志。