什么是自定义节点?
自定义节点是ComfyUI的扩展插件,能够增加新功能,如高级图像处理、机器学习微调、颜色调整等。这些节点由社区开发,可显著扩展ComfyUI的基础功能。在安装自定义节点前,你有必要对自定义节点进行审查,由于 ComfyUI 是一个开源项目,也有可能存在恶意利用自定义节点进行攻击的插件
- 请只安装来自可信作者和社区常用的自定义节点
- 在安装前了解插件功能,避免安装不明来源的插件以确保系统安全
- 避免安装冷门插件和来路不明的插件,未经审核的插件可能存在安全风险,进而导致你的电脑被黑客入侵。
安装自定义节点
所有的自定义节点安装都需要完成下面的两个步骤:- 克隆节点代码到
ComfyUI/custom_nodes
目录 - 安装对应的 Python 依赖
方法 | 优点 | 缺点 |
---|---|---|
ComfyUI Manager (推荐) | 1. 自动化安装 2. 依赖处理 3. 图形界面 | 不在 registry 中注册的节点无法通过 Manager 直接搜索到 |
Git 克隆 | 可以安装不在 registry 中注册的节点 | 1. 需要Git知识 2. 手动处理依赖 3. 存在安装风险 |
代码仓库 ZIP 下载 | 1. 无需Git 2. 手动处理一切 | 1. 需要手动处理依赖 2. 无版本控制 3. 存在安装风险 |
方法一:ComfyUI Manager(推荐)
1
点击ComfyUI界面的 `Manager` 按钮

2
选择 `Install Custom Nodes`

3
查看自定义节点列表
使用 ComfyUI Manager 安装自定义节点时,在列表中的自定义节点并不代表其是安全的,请在安装前了解其功能和作用,确保只安装可信插件和热门作者的自定义节点,否则将会给你的设备带来潜在风险


- 如果有标记
⚠️
的节点,代表其可能与其它一些插件存在依赖冲突 - 作者名称标注为
✅
的节点,代表对应作者在 Github 的活跃度 - 对于插件可能存在的风险行为,会在列表中使用红色字段提醒,请在确保插件安全后再进行安装
4
点击对应节点的 `Install` 按钮

Install
按钮
nightly
版本: 直接从 Github 下载最新源码,但在security_level
为normal
时,会提示当前的安全等级设置不允许下载该插件latest
或带数字的稳定版本(推荐): 从 https://registry.comfy.org/ 下载经过审查的代码,不会触发安全检查
nightly
版本通常是最新的版本,但因为它直接从 github 下载没有经过审查的版本,存在一定的代码风险,如果你一定需要安装nightly
版本,请将 Manager 的 security_level
设置为 weak
对应配置文件路径为 ComfyUI/user/default/ComfyUI-Manager/config.ini
,但请注意这并不是我们推荐的配置,请只临时使用这个配置5
等待依赖安装完成后重启ComfyUI
点击安装后 Manager 会自动完成依赖的安装,并会在安装完成后提示你重启 ComfyUI



6
检查插件是否安装成功
重启后在 ComfyUI Manager 中检查对应的插件是否安装成功, 是否出现
import failed
的错误提示
方法二:使用 Git 进行安装手动安装
适用于Manager中找不到的新节点或需要特定版本时, 需要你的系统中已经安装好了 Git1
获取仓库URL
在GitHub页面点击”Code”按钮复制HTTPS链接
2
进入custom_nodes目录
3
克隆仓库
4
安装依赖
安装依赖需要安装到对应的 ComfyUI 环境中,请注意不要混淆到你的系统环境, 否则可能会导致你的系统环境污染
在 Windows 便携版中, 依赖需要安装到对应的嵌入式 Python 环境中
5
重启ComfyUI并刷新浏览器
重启ComfyUI并刷新浏览器, 检查对应的插件是否安装成功, 在启动日志界面是否出现
import failed
的错误提示方法三:ZIP下载安装
适用于无法使用 Git 或 Manager 安装的用户我们不是非常推荐使用这种方式来进行安装,因为这种安装方式会丢失
1
在GitHub页面点击 `Code` → `Download ZIP`
在GitHub页面点击 
Code
→ Download ZIP

2
解压ZIP文件
解压ZIP文件
3
将解压后的文件夹复制到 `ComfyUI/custom_nodes/` 目录
将解压后的文件夹复制到
ComfyUI/custom_nodes/
目录4
手动安装依赖项(同Git方法的第4步)
重启ComfyUI并刷新浏览器
5
检查插件是否安装成功
重启后在 ComfyUI Manager 中检查对应的插件是否安装成功, 是否出现
import failed
的错误提示自定义节点资源
目前在 ComfyUI 中除了基础的节点扩展功能扩展之外,自定义节点还包括包括以下的扩展资源- 节点文档: 这个功能支持所有的自定义节点和基础节点,你可以通过这个功能来查看节点文档,了解节点的作用和使用方法,你可以通过像作者PR来贡献对应的节点文档
- 自定义节点工作流模板: 自定义节点的工作流模板,节点作者提供的示例工作流,可在 ComfyUI 的模板中浏览加载
- 多语言支持