跳转到主要内容

​
什么是自定义节点？

自定义节点是ComfyUI的扩展插件，能够增加新功能，如高级图像处理、机器学习微调、颜色调整等。这些节点由社区开发，可显著扩展ComfyUI的基础功能。
在安装自定义节点前，你有必要对自定义节点进行审查，由于 ComfyUI 是一个开源项目，也有可能存在恶意利用自定义节点进行攻击的插件
  1. 请只安装来自可信作者和社区常用的自定义节点
  2. 在安装前了解插件功能，避免安装不明来源的插件以确保系统安全
  3. 避免安装冷门插件和来路不明的插件，未经审核的插件可能存在安全风险,进而导致你的电脑被黑客入侵。

​
安装自定义节点

所有的自定义节点安装都需要完成下面的两个步骤：
  1. 克隆节点代码到 ComfyUI/custom_nodes 目录
  2. 安装对应的 Python 依赖
在本文中我们将介绍三种安装方法，下面是对应的优缺点对比，由于目前 ComfyUI Manager 还未正式加入到核心依赖中，但在未来 ComfyUI Manager 将会成为核心依赖的一部分，但本部分的指南仍旧提供了其它安装插件的指南,以便满足你的需求。
方法优点缺点
ComfyUI Manager (推荐)1. 自动化安装
2. 依赖处理
3. 图形界面		不在 registry 中注册的节点无法通过 Manager 直接搜索到
Git 克隆可以安装不在 registry 中注册的节点1. 需要Git知识
2. 手动处理依赖
3. 存在安装风险
代码仓库 ZIP 下载1. 无需Git
2. 手动处理一切		1. 需要手动处理依赖
2. 无版本控制
3. 存在安装风险
提示： 在安装自定义节点前，请先查看插件的 README 文件，了解插件的安装方法和使用方法，有些插件有对特定的包和环境有要求，比如对应的模型、依赖的版本、常见问题解决等

​
方法一:ComfyUI Manager（推荐）

使用管理器安装节点

查看如何使用管理器进行节点安装

​
方法二:使用 Git 进行安装手动安装

适用于 Manager 中找不到的新节点或需要特定版本时， 需要你的系统中已经安装好了 Git
1

获取仓库URL

在GitHub页面点击”Code”按钮复制HTTPS链接
2

进入custom_nodes目录

cd /path/to/ComfyUI/custom_nodes
3

克隆仓库

git clone [仓库URL]
4

安装依赖

安装依赖需要安装到对应的 ComfyUI 环境中，请注意不要混淆到你的系统环境， 否则可能会导致你的系统环境污染
在 Windows 便携版中， 依赖需要安装到对应的嵌入式 Python 环境中
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[节点目录名]\requirements.txt
5

重启ComfyUI并刷新浏览器

重启ComfyUI并刷新浏览器， 检查对应的插件是否安装成功, 在启动日志界面是否出现import failed的错误提示

​
方法三:ZIP下载安装（不推荐）

适用于无法使用 Git 或 Manager 安装的用户
我们不是非常推荐使用这种方式来进行安装，因为这种安装方式会丢失 Git 版本控制能力，导致你无法进行后续的版本管理
1

在GitHub页面点击 `Code` → `Download ZIP`

在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 的模板中浏览加载
  • 多语言支持
如果你是自定义节点作者，你可以添加对应的内容来让你的自定义节点使用更加友好