主题
插件管理
ComfyUI 插件是一类为工作流增加新节点和功能的扩展,许多第三方工作流会依赖指定插件提供的节点来完成处理。插件管理把插件的查找和维护集中在同一页面,用于补齐工作流依赖、更新现有功能或调整使用的版本。

查找插件
在搜索框中输入插件名称或功能关键词。工作流报错中出现了插件名称时,可以直接复制名称搜索。
状态筛选用于缩小插件范围:
- 全部状态:显示完整的插件列表。
- 已安装:查看当前已经安装的插件。
- 未安装:查找可以添加的新插件。
- 有更新:集中查看可以更新的插件。
- 已禁用:查找暂时停用的插件。
排序方式决定结果的排列顺序:
- 按热度:优先显示使用人数较多的插件。
- 最近更新:优先显示近期更新的插件。
- 按名称:按照插件名称排列,适合配合准确名称查找。
刚完成安装或更新后,点击 刷新更新列表。
安装插件
- 搜索插件名称,阅读简介,确认它就是工作流需要的插件。
- 点击 安装,使用列表中提供的最新版本。
- 工作流明确要求某个版本时,点击 版本,再选择对应版本。
- 查看页面顶部的进度,等待安装完成。
- 看到 待生效 后,点击 立即重启。
- 等待 ComfyUI 回到 空闲中,再重新打开工作流。
工作流中原来缺少的节点应该会正常显示。想确认插件是否顺利加载,也可以到运行概览查看最新日志。
首次部署时选择的插件会显示在 已安装 中,具体选择见确认自定义节点。
管理已安装插件
- 更新:插件显示新版本时,点击后安装列表中的新版本。
- 版本:工作流要求特定版本,或者更新后需要换回以前的版本时,从版本列表中选择并安装。
- 禁用:暂时停用插件或排查插件冲突时使用。插件文件会继续保留,重启后停止加载。
- 启用:重新使用已经禁用的插件,重启后恢复加载。
- :卸载当前插件。
完成安装、更新、版本切换、启用、禁用或卸载后,页面会显示 待生效。只处理一项时可以点击 立即重启;连续处理多个插件时,每次选择 稍后,全部完成后再点击页头的 重启。
操作失败时,原因会显示在对应插件下方。先确认网络是否正常、选择的版本是否存在,以及插件说明中是否还有其他要求。
通过 Git URL 安装
搜索不到需要的插件,或者插件作者提供了 Git 地址时,可以直接安装:
- 点击顶部的 Git 安装。
- 粘贴插件作者提供的完整 Git 地址,地址需要以
http://或https://开头。 - 点击 安装,等待页面顶部的进度完成。
- 看到 待生效 后,点击 立即重启。
- ComfyUI 回到 空闲中 后,重新打开工作流。
页面以 GitHub 地址为例。以后更新、禁用或卸载这个插件,仍然在当前列表中操作。
插件安装后缺少节点
- 点击 刷新,确认插件已经出现在 已安装中。
- 到运行概览查看最新日志,搜索插件名称。
- 确认工作流要求的插件版本与当前安装版本一致。
- 日志中出现加载失败或缺少其他插件时,按照提示补齐,再重启 ComfyUI。
仍然无法使用时,可前往点击生成后立即报错继续排查。