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

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

​

什么是自定义节点？

自定义节点是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（推荐）

1. 点击ComfyUI界面的 `Manager` 按钮

   
2. 选择 `Install Custom Nodes`

   
3. 查看自定义节点列表

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

   

   1. 如果有标记⚠️的节点，代表其可能与其它一些插件存在依赖冲突
   2. 作者名称标注为✅的节点，代表对应作者在 Github 的活跃度
   3. 对于插件可能存在的风险行为，会在列表中使用红色字段提醒，请在确保插件安全后再进行安装
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中找不到的新节点或需要特定版本时， 需要你的系统中已经安装好了 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 安装的用户

我们不是非常推荐使用这种方式来进行安装，因为这种安装方式会丢失

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的错误提示