ComfyUI 自定义节点与 ComfyUI-Manager 安装教程

ComfyUI 的强大之处很大程度上来自社区开发的自定义节点（custom nodes）：预处理器、放大工具、视频处理、各种新模型的支持……网上分享的工作流也经常会用到它们。

ComfyUI-Manager

ComfyUI-Manager 是管理自定义节点的工具，可以搜索、安装、更新、禁用自定义节点，也能自动找出工作流缺少的节点。

启用方式

• 桌面版：已内置。

• 手动安装 / 便携版：先安装 Manager 的依赖包，再通过参数启动：

  pip install -r manager_requirements.txt
  python main.py --enable-manager

  便携版请在 run_nvidia_gpu.bat 的启动命令后面加上 --enable-manager，并使用便携版自带的 Python 安装依赖包。

（Manager 的启用方式曾随版本调整，请以 ComfyUI README 的最新说明为准。）

启用后，界面上会出现 Manager 按钮。

安装自定义节点

1. 打开 Manager → Custom Nodes Manager。
2. 搜索节点名称，例如 controlnet aux。
3. 点击 Install，选择版本。
4. 安装完成后重新启动 ComfyUI，并刷新浏览器。

安装工作流缺少的节点

加载别人分享的工作流时，缺少的节点会显示为红色，并弹出提示。

1. 打开 Manager → Install Missing Custom Nodes。
2. 勾选列出的节点并安装。
3. 重新启动。

更新与管理

• Update All：更新 ComfyUI 和所有自定义节点。
• 在 Custom Nodes Manager 中可以禁用（Disable）或卸载单个节点。
• 某个自定义节点导致 ComfyUI 无法启动时，先禁用它，或到 custom_nodes 文件夹中将它移走。

手动安装

不使用 Manager 时：

cd ComfyUI/custom_nodes
git clone https://github.com/作者/节点储存库.git
cd 节点储存库
pip install -r requirements.txt   # 如果有这个文件

便携版要使用自带的 Python 安装：

..\..\..\python_embeded\python.exe -m pip install -r requirements.txt

重新启动 ComfyUI 即可。

常用的自定义节点

只安装真正需要的节点即可，安装太多会拖慢启动速度，也更容易发生冲突。

安全注意事项

自定义节点是可以在你的电脑上执行任意代码的 Python 程序。

• 只安装知名、有人维护、星数多的节点。
• 不要安装 Manager 中标记为存在安全隐患的节点。
• 不要随意安装来源不明的工作流所要求的冷门节点。
• 曾发生过自定义节点夹带恶意程序的事件，安装前多看看作者和社区评价。

常见问题

安装后节点仍然是红色

• 确认已重新启动 ComfyUI 并刷新浏览器。
• 查看启动时的终端信息，搜索 IMPORT FAILED，通常是缺少 Python 包或版本冲突。

更新 ComfyUI 后出错

ComfyUI 本体更新后，部分自定义节点可能需要同步更新。先执行 Update All；仍有问题时，到该节点的 GitHub 页面查看是否有相关反馈。

更新于 2026年10月12日