如何在 ComfyUI 中安装自定义节点

本部分将指导你如何使用不同的方式来进行 ComfyUI 自定义节点的安装

​

什么是自定义节点？

自定义节点是ComfyUI的扩展插件，能够增加新功能，如高级图像处理、机器学习微调、颜色调整等。这些节点由社区开发，可显著扩展ComfyUI的基础功能。

在安装自定义节点前，你有必要对自定义节点进行审查，由于 ComfyUI 是一个开源项目，也有可能存在恶意利用自定义节点进行攻击的插件

1. 请只安装来自可信作者和社区常用的自定义节点
2. 在安装前了解插件功能，避免安装不明来源的插件以确保系统安全
3. 避免安装冷门插件和来路不明的插件，未经审核的插件可能存在安全风险,进而导致你的电脑被黑客入侵。

​

安装自定义节点

所有的自定义节点安装都需要完成下面的两个步骤：

1. 克隆节点代码到 ComfyUI/custom_nodes 目录
2. 安装对应的 Python 依赖

本文对比三种安装方式。ComfyUI Manager 在大多数当前 ComfyUI 发行版中已内置，可先阅读 ComfyUI Manager 概述 了解功能与启用方式。当节点不在注册表中或需要固定某一版本时，可使用 Git 克隆 或 ZIP 下载。

方法	优点	缺点
ComfyUI Manager (推荐)	1. 自动化安装 2. 依赖处理 3. 图形界面	不在 registry 中注册的节点无法通过 Manager 直接搜索到
Git 克隆	可以安装不在 registry 中注册的节点	1. 需要Git知识 2. 手动处理依赖 3. 存在安装风险
代码仓库 ZIP 下载	1. 无需Git 2. 手动处理一切	1. 需要手动处理依赖 2. 无版本控制 3. 存在安装风险

提示： 在安装自定义节点前，请先查看插件的 README 文件，了解插件的安装方法和使用方法，有些插件有对特定的包和环境有要求，比如对应的模型、依赖的版本、常见问题解决等

​

方法一:ComfyUI Manager（推荐）

使用此方法前，请确认环境中已可用 ComfyUI Manager。若未看到或尚未启用，请先阅读 ComfyUI Manager 概述，并按 安装指南 操作。

ComfyUI Manager 提供了两种 UI 版本来管理自定义节点，请选择与你界面匹配的指南：

新 UI（Desktop 用户默认启用）

新版节点管理界面，Desktop 用户默认启用。

传统 UI

经典的 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便携版

   在 Windows 便携版中， 依赖需要安装到对应的嵌入式 Python 环境中

   python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[节点目录名]\requirements.txt
   

   手动安装

   在你的 ComfyUI 环境中安装依赖

   cd [节点目录名]
   pip install -r requirements.txt
   
5. 重启ComfyUI并刷新浏览器

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

​

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

适用于无法使用 Git 或 Manager 安装的用户

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

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 的模板中浏览加载
• 多语言支持

如果你是自定义节点作者，你可以添加对应的内容来让你的自定义节点使用更加友好