安装与更新

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

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

什么是自定义节点?

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

安装自定义节点

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

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

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

方法 优点 缺点
ComfyUI Manager (推荐) 1. 自动化安装
  1. 依赖处理
  2. 图形界面 | 不在 registry 中注册的节点无法通过 Manager 直接搜索到 |

| Git 克隆 | 可以安装不在 registry 中注册的节点 | 1. 需要Git知识

  1. 手动处理依赖
  2. 存在安装风险 |

| 代码仓库 ZIP 下载 | 1. 无需Git

  1. 手动处理一切 | 1. 需要手动处理依赖
  2. 无版本控制
  3. 存在安装风险 |

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

方法一:ComfyUI Manager(推荐)

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

新 UI(Desktop 用户默认启用)

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

传统 UI

经典的 Manager 界面,用于自定义节点的安装管理。

方法二:使用 Git 手动安装

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

获取仓库URL

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

进入custom_nodes目录

bash
cd /path/to/ComfyUI/custom_nodes

克隆仓库

bash
git clone [仓库URL]

安装依赖

安装依赖需要安装到对应的 ComfyUI 环境中,请注意不要混淆到你的系统环境, 否则可能会导致你的系统环境污染

Windows便携版

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

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

手动安装

在你的 ComfyUI 环境中安装依赖

bash
cd [节点目录名]
pip install -r requirements.txt

重启ComfyUI并刷新浏览器

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

方法三:ZIP下载安装(不推荐)

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

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

在GitHub页面点击 CodeDownload ZIP 在GitHub页面点击 <code>Code</code> → <code>Download ZIP</code>

解压ZIP文件

解压ZIP文件

将解压后的文件夹复制到 `ComfyUI/custom_nodes/` 目录

将解压后的文件夹复制到 ComfyUI/custom_nodes/ 目录

手动安装依赖项(同Git方法的第4步)

重启ComfyUI并刷新浏览器

检查插件是否安装成功

重启后在 ComfyUI Manager 中检查对应的插件是否安装成功, 是否出现import failed的错误提示

自定义节点资源

目前在 ComfyUI 中除了基础的节点扩展功能扩展之外,自定义节点还包括包括以下的扩展资源

  • 节点文档: 这个功能支持所有的自定义节点和基础节点,你可以通过这个功能来查看节点文档,了解节点的作用和使用方法,你可以通过像作者PR来贡献对应的节点文档
  • 自定义节点工作流模板: 自定义节点的工作流模板,节点作者提供的示例工作流,可在 ComfyUI 的模板中浏览加载
  • 多语言支持

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

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本,并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明,不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0来源和修改说明