自定义节点

​

关于自定义节点

当你在安装了 ComfyUI 后，你将会发现 ComfyUI 中已经包含了许多节点，这些原生的节点称为 Comfy Core 节点，这些节点都是由 ComfyUI 官方维护的。

此外还有许多来自 ComfyUI 社区的众多作者带来的各种各样的 自定义节点，这些自定义节点为 ComfyUI 带来了诸多的扩展功能，大大扩展了 ComfyUI 的功能和能力边界。

在本指南中，我们将介绍如何自定义节点相关的一些操作，包括安装、更新、禁用、卸载、依赖安装等。

每个人都可以开发自己的自定义的扩展功能到 ComfyUI 中，并分享给其他人使用，你可以在这里找到许多来自社区的自定义节点，如果你想要开发自己的自定义节点请访问下面的部分开始：

​

自定义节点管理

在这个部分我们将讲解：

• 安装自定义节点
• 安装节点依赖
• 自定义节点版本控制
• 卸载自定义节点
• 临时禁用自定义节点
• 处理自定义节点依赖冲突

​

1. 安装自定义节点

目前 ComfyUI 支持通过多种方式安装自定义节点，包括：

• [通过 ComfyUI Manager 安装（推荐）](#通过 ComfyUI Manager 安装)
• 通过 Git 安装
• 手动安装

我们推荐通过 ComfyUI Manager 来安装自定义节点，这是一个在 ComfyUI 自定义节点生态中具有非常重要意义的一个工具，它使得自定义节点管理（如搜索、安装、更新、禁用和卸载）变得简单，你只需要在 ComfyUI Manager 中搜索你想要安装的节点，然后点击安装即可。

但由于目前所有的自定义节点都是存储在 GitHub 上，所以在本篇针对于某些无法正常访问 GitHub 的的地区，我们在本篇撰写了详尽的不同的自定义节点的安装方式。

另外由于我们推荐使用 ComfyUI Manager 进行对应的插件管理，我们推荐使用这一工具来进行插件的管理，你可以在这里找到它的源码。 所以在本篇文档中，我们将会使用安装 ComfyUI Manager 作为自定义节点安装示例，并在本篇的相关介绍部分补充如何使用它来进行节点的管理。

git --version

https://github.com/Comfy-Org/ComfyUI-Manager

cd D:\ComfyUI_windows_portable\ComfyUI\custom_nodes

git clone https://github.com/Comfy-Org/ComfyUI-Manager

​

2. 安装节点依赖

自定义节点都需要进行相关的依赖的安装，比如对于 ComfyUI-Manager 来说，你可以访问requirements.txt 文件来查看对应的依赖包的要求,

在之前的步骤中，我们仅仅是把对应的自定义节点代码克隆到了本地，并没有安装对应的依赖，所以接下来我们需要安装对应的依赖。

在关于依赖关系章节中，我们介绍了 ComfyUI 中依赖关系的相关内容，ComfyUI 是一个基于 Python 的项目，我们构建了一个用于运行 ComfyUI 的独立 Python 运行环境，所有的相关依赖都需要被安装在在这个独立的 Python 运行环境中。

如果你直接在系统级的终端运行 pip install -r requirements.txt，对应的依赖可能会被安装到了系统级的 Python 环境中，会导致对应的自定义节点在 ComfyUI 的环境中依赖还是丢失的，导致对应自定义节点无法正常运行。

所以接下来我们需要使用 ComfyUI 的独立 Python 运行环境来完成对应的依赖安装。

依据不同的 ComfyUI 版本我们将使用不同的方式来进行对应的依赖安装，

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt

pip install -r .\custom_nodes\<对应自定义节点名称>\requirements.txt

​

自定义节点版本控制

自定义节点的版本控制，实际上是基于 Git 的版本控制来进行的，你可以通过 Git 来进行对应的节点版本管理，但实际上在 ComfyUI Manager 中已经很好地集成了这一版本管理功能，非常感谢 @Dr.Lt.Data 为我们带来如此便捷的工具。

在这个部分我们依旧会为你讲解这两种不同插件版本管理的方法，但如果你是使用 zip 压缩包进行手动安装的，那么对应的 git 版本历史信息会丢失，会导致你无法进行对应的版本管理。

cd <你的安装目录>/ComfyUI/custom_nodes/ComfyUI-Manager

git tag

git checkout <tag_name>

git checkout <commit_hash>

​

卸载自定义节点

待更新

​

临时禁用自定义节点

待更新

​

自定义节点依赖冲突

待更新

​

ComfyUI Manager

目前在 Desktop 版本 中已默认包含该工具,而在便携（Portable）版中，你需要参考本文档中安装管理器章节中的说明进行安装。

​

安装管理器

如果您正在运行 ComfyUI 服务器应用程序，则需要安装管理器。如果 ComfyUI 正在运行，请在继续之前将其关闭。

第一步是安装 Git，这是一个用于软件版本控制的命令行应用程序。Git 将从 github.com 下载 ComfyUI 管理器。从 git-scm.com 下载并安装 Git。

安装 Git 后，导航到 ComfyUI 服务器程序目录，进入标记为 custom_nodes 的文件夹。打开命令窗口或终端。确保命令行显示当前目录路径为 custom_nodes。输入以下命令。这将下载管理器。从技术上讲，这被称为 克隆 Git 仓库。

​

检测缺失的节点

在安装管理器后，你可以在管理器中检测到缺失的节点。

​

开发一个自定义节点

如果你具有一定的开发能力，请从下面的文档开始以了解如何开始开发一个自定义节点。