安装后
自定义节点
使用社区构建的插件和自定义节点扩展 ComfyUI。
自定义节点是社区构建的插件,为 ComfyUI 添加新功能 — 从面部修复到视频生成再到高级超分辨率。
安装自定义节点
方法一:ComfyUI Manager(推荐)
ComfyUI Manager 是一个插件,可以让你直接在 ComfyUI 界面中浏览、安装和更新自定义节点。
安装 ComfyUI Manager:
- 在
ComfyUI/custom_nodes/文件夹中打开终端 - 运行:
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
- 重启 ComfyUI
安装后,点击 ComfyUI 工具栏中的 Manager 按钮可以:
- 浏览可用的自定义节点
- 一键安装节点
- 更新已安装的节点
- 安装导入工作流中缺失的节点
方法二:手动 Git Clone
- 在
ComfyUI/custom_nodes/中打开终端 - 克隆节点仓库:
cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git
- 安装依赖(如果节点有
requirements.txt):
cd [node-name]
pip install -r requirements.txt
- 重启 ComfyUI
方法三:复制文件
一些简单的节点只是一个 .py 文件。直接将其复制到 custom_nodes/ 中:
ComfyUI/
└── custom_nodes/
└── my_node.py
重启 ComfyUI 即可加载。
热门自定义节点
| 节点 | 功能 |
|---|---|
| ComfyUI-Manager | 浏览和安装其他自定义节点 |
| ComfyUI-GGUF | 加载量化 GGUF 模型以降低 VRAM 使用 |
| ComfyUI-Impact-Pack | 面部检测、分割、细节增强 |
| ComfyUI-AnimateDiff | 将图片动画化为短视频 |
| ComfyUI-IPAdapter | 使用参考图像引导生成风格 |
| ComfyUI-ControlNet | 高级 ControlNet 支持(姿态、深度、边缘检测) |
| ComfyUI-VideoHelperSuite | 加载、预览和保存视频文件 |
| ComfyUI-KJNodes | 实用工具节点合集 |
| rgthree-comfy | 工作流组织和生活质量改善节点 |
| efficiency-nodes-comfyui | 批处理和工作流效率工具 |
修复"红色节点"
工作流中的红色节点表示 ComfyUI 找不到所需的自定义节点。这通常发生在导入使用了你未安装的节点的工作流时。
使用 ComfyUI Manager:
- 点击 Manager 按钮
- 点击 Install Missing Custom Nodes
- Manager 会识别并安装所需内容
- 重启 ComfyUI
不使用 Manager:
- 阅读红色节点上显示的节点名称
- 在 GitHub 上搜索该节点
- 通过 git clone 手动安装
更新自定义节点
使用 ComfyUI Manager: 点击 Manager → Update All
手动更新:
cd ComfyUI/custom_nodes/[node-name]
git pull
pip install -r requirements.txt # if exists
更新后重启 ComfyUI。
故障排除
| 问题 | 解决方案 |
|---|---|
| 导入工作流后出现红色节点 | 通过 Manager 或手动安装缺失的节点 |
| 节点已安装但不显示 | 重启 ComfyUI。检查控制台是否有导入错误 |
启动时出现 ModuleNotFoundError |
节点需要额外的 Python 包。在节点文件夹中运行 pip install -r requirements.txt |
| 节点冲突/崩溃 | 某些节点之间不兼容。通过重命名文件夹来禁用(例如添加 .disabled)。参见依赖冲突 |
| Manager 无法安装 | 检查你的网络连接。某些网络会屏蔽 GitHub |
深入了解
关于高级插件管理 — 节点映射、仓库迁移、批量安装和 Git LFS 问题 — 参见插件管理指南。如果你正在搭建复杂的多工作流环境,参见工作流环境配置。
如需系统性的错误诊断,请使用故障排除决策树。
Wonderful Launcher 文档