自定义节点

自定义节点是社区构建的插件，为 ComfyUI 添加新功能 — 从面部修复到视频生成再到高级超分辨率。

安装自定义节点

方法一：ComfyUI Manager（推荐）

ComfyUI Manager 是一个插件，可以让你直接在 ComfyUI 界面中浏览、安装和更新自定义节点。

安装 ComfyUI Manager：

1. 在 ComfyUI/custom_nodes/ 文件夹中打开终端
2. 运行：

git clone https://github.com/ltdrdata/ComfyUI-Manager.git

1. 重启 ComfyUI

安装后，点击 ComfyUI 工具栏中的 Manager 按钮可以：

• 浏览可用的自定义节点
• 一键安装节点
• 更新已安装的节点
• 安装导入工作流中缺失的节点

方法二：手动 Git Clone

1. 在 ComfyUI/custom_nodes/ 中打开终端
2. 克隆节点仓库：

cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git

1. 安装依赖（如果节点有 requirements.txt）：

cd [node-name]
pip install -r requirements.txt

1. 重启 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：

1. 点击 Manager 按钮
2. 点击 Install Missing Custom Nodes
3. Manager 会识别并安装所需内容
4. 重启 ComfyUI

不使用 Manager：

1. 阅读红色节点上显示的节点名称
2. 在 GitHub 上搜索该节点
3. 通过 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 问题 — 参见插件管理指南。如果你正在搭建复杂的多工作流环境，参见工作流环境配置。

如需系统性的错误诊断，请使用故障排除决策树。