ComfyUI Manager

介绍

ComfyUI-Manager 是一个旨在提升 ComfyUI 可用性的扩展。它提供管理功能，用于安装、移除、禁用和启用 ComfyUI 的各种自定义节点。此外，该扩展还提供了枢纽功能和便捷功能，方便访问ComfyUI内的各种信息。

安装前须知

• 只安装可信来源插件 — 避免来源不明、冷门插件，防止潜在安全或稳定性问题。
• 安装插件需要两个步骤：
• 将节点代码放入 ComfyUI/custom_nodes 目录；
• 安装节点所需的 Python 依赖（如果有）到 ComfyUI 的运行环境中。
• 根据你使用的是 桌面版 / 便携版 / 自定义环境，依赖安装方式略有不同。 确认使用的是 ComfyUI 环境，而非系统 Python环境。
• 安装前要装git，安装方法看这里

安装方法 — 三种方式任选

ComfyUI 官方支持下列三种主流方法安装自定义节点：

下面分别介绍每种方法的具体步骤。

方法一：通过 ComfyUI Manager 安装

步骤

1. 要先安装ComfyUI-Manager
2. 启动 ComfyUI → 点击界面左侧 /顶部的 “Manager” 按钮。
3. 选择 “Install Custom Nodes”。
4. 在插件列表里搜索你想要安装的插件。 注意插件前面的标志： ⚠️ → 可能与其它插件有依赖冲突，安装前请谨慎。
5. 点击对应插件的 Install（安装）按钮。 选择合适版本（一般选 latest 或稳定版本，不建议用 nightly / 未审核版本，除非你完全了解风险）。
6. 等待 Manager 自动下载、安装插件代码与依赖。 完成后 Manager 会提示你重启 ComfyUI。
7. 重启 ComfyUI → 刷新浏览器界面 → 确认 Manager 中已安装插件，没有 import failed 错误。

方法二：通过 Git 克隆 (Git Clone) 手动安装

适用于插件不在 Manager registry 中，或你想安装最新版／特定分支插件时。

步骤

1. 确保你的系统已安装 Git。 如果没有，看这里的安装方法。
2. 找到你要安装插件的 GitHub 仓库 → 点击 “Code” → 复制 HTTPS 链接。
3. 打开命令行 (Terminal / CMD)，定位到 ComfyUI 的插件目录： cd /path/to/ComfyUI/custom_nodes
4. 执行克隆命令： git clone [插件仓库 URL] 例如： git clone https://github.com/ 作者/ComfyUI-MyNode.git
5. 如果插件有依赖，进入 ComfyUI 的 Python 环境安装依赖。 比如如果你用的是 便携版： python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\<插件目录>\requirements.txt 对于桌面版或虚拟环境用户，也按此方法操作。
6. 重启 ComfyUI，刷新界面 → 检查插件是否加载成功，有无 import failed 错误。

方法四：通过 ZIP 包手动安装（备用，不推荐）

适合不熟悉 Git、不能使用 Manager 的情况，但需要一定操作谨慎。

步骤

1. 在 GitHub 插件页面，点击 “Code → Download ZIP” 下载压缩包。
2. 解压 ZIP 文件，将得到的插件文件夹复制到 ComfyUI/custom_nodes/。 （主要去除main后缀）
3. 如果插件含 requirements.txt，进入 ComfyUI 的 Python 环境安装依赖（同 Git 方法步骤 5）。
4. 重启 ComfyUI → 刷新界面 → 检查插件是否加载成功。

缺点：无版本控制； 更新插件时需手动重复操作； 如果插件有依赖冲突，管理比较麻烦。

安装后建议 & 排查错误

• 安装完插件、搭建自定义节点后，务必重启 ComfyUI 否则插件可能不被识别。
• 如果 ComfyUI 启动时报错 import failed：可能是依赖没装好、版本冲突、插件不兼容。 建议回头看插件的 README，按照指示安装依赖，或尝试稳定版本。
• 对于便携版用户：一定要用内嵌 Python 环境 (python_embeded\python.exe) 来安装依赖，不能用系统 Python，否则 ComfyUI 启动环境不会识别这些依赖。
• 如果插件过多，可能出现依赖冲突； 建议仅安装必要插件、记录已安装插件清单。