ComfyUI Manager：安装节点、修复 erreurs

#ComfyUI Manager 的用途

ComfyUI 默认只能完成其内置节点所支持的功能。除此之外的一切——高级 ControlNet、预处理器、放大器、视频工具和便捷节点——都来自称为 custom nodes 的扩展。每个 custom node 都是一个包含 Python 代码的 Git 仓库，放置在安装目录的 custom_nodes 文件夹中，并在启动时加载。

没有 Manager 时，安装扩展就意味着手动克隆仓库、在正确的环境中安装其 Python 依赖，然后重新启动。Manager 可在界面窗口中完成这些步骤。它最重要的是提供了三个最终总会用到的功能：检测工作流中缺失的 nodes、修复拒绝加载的 nodes 的按钮，以及在更新不顺利后恢复到之前状态的快照。

Custom Nodes Manager

目录：搜索、安装、更新、停用和卸载已收录的扩展。

Install Missing Custom Nodes

分析已打开的工作流，并列出导致节点变红的缺失扩展。

Model Manager

将知名模型直接下载到正确的 models 子文件夹中。

Update All

一次性更新所有已安装的扩展。虽然方便，但这也是最常导致原本正常的安装损坏的命令。

Snapshot Manager

记录安装状态（ComfyUI 版本、扩展、Python 软件包），以便之后恢复。

#前提：知道你的 custom_nodes 文件夹在哪里

Manager 和所有扩展一样，位于 custom_nodes 文件夹中。其位置取决于您安装 ComfyUI 的方式；“节点已安装但不存在”的问题，有一半源于扩展放在了错误的文件夹中，或依赖安装到了错误的 Python 中。

ComfyUI Desktop

基础文件夹就是您在安装时选择的文件夹（通常是 Documents 中的 ComfyUI 文件夹）。其中包含 custom_nodes、models、input 和 output。Python 环境由应用管理，位于旁边的 .venv 文件夹中。

Windows便携版

在解压后的归档中：ComfyUI_windows_portable/ComfyUI/custom_nodes。专用 Python 位于 ComfyUI_windows_portable/python_embeded，安装依赖时必须使用它，绝不能使用系统 Python。

手动安装（git clone）

ComfyUI/custom_nodes，以及您为 ComfyUI 创建的虚拟环境。执行任何 pip 命令前请先激活该环境。

在所有情况下

必须安装 Git 且可访问：Manager 会使用它克隆仓库。在 Windows 上，请在终端中使用 git --version 检查。

如果尚未安装 ComfyUI，请先阅读 ComfyUI 安装指南，该指南会比较 Desktop、portable 和手动安装。本指南假定你已经拥有一个能够生成图像的安装。

#根据您的版本安装 ComfyUI Manager

有三种情况，其中第一种在 2026 年最常见：Manager 已经存在。安装任何东西之前，先检查界面顶部栏中是否有 Manager 按钮。

#情况 1：它已包含在内（Desktop、comfy-cli）

ComfyUI Desktop 应用内置 Manager。使用命令行工具 comfy-cli 安装时也是如此，因为它默认会添加 Manager。如果界面顶部显示 Manager 按钮，您无需进行任何操作：进入下一节。

#情况 2：较新的 ComfyUI，已集成但被禁用的 Manager

ComfyUI 主仓库现在已将 Manager 作为可选依赖集成其中。它不会自动启用：必须先安装 ComfyUI 根目录中的 manager_requirements.txt 文件，然后使用 --enable-manager 选项启动服务器。对于近期的手动安装，这是首选路径，因为这样 Manager 会跟随你的 ComfyUI 所需的版本。

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

为了不必每次都重新输入该选项，请将其添加到启动脚本或服务中。在便携版中，应将其放在 run_nvidia_gpu.bat 文件命令行末尾（或其 AMD 或 Intel 对应文件的末尾）。

#情况 3：在 custom_nodes 中进行经典安装

这是历史方法，Manager 的仓库中仍有文档说明；对于没有 manager_requirements.txt 文件的 ComfyUI 版本，这是唯一可行的方法。将仓库克隆到 custom_nodes 中，然后完全重启 ComfyUI。

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
# puis arrêter ComfyUI (Ctrl+C) et le relancer
cd ..
python main.py

cd ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
cd ..\..
.\python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
# puis relancer run_nvidia_gpu.bat

重启时，请查看终端。若看到提及 ComfyUI-Manager 及其版本号的行，就表示加载成功。如果看到的是其名称旁边的 IMPORT FAILED，则说明依赖没有安装到正确的 Python 中：请使用 ComfyUI 的环境重新执行 pip 命令。

#使用 Manager 添加自定义节点

1. 01
   打开目录

   点击顶部栏中的 Manager，然后点击 Custom Nodes Manager。首次打开时会下载已收录扩展的列表，这可能需要几秒钟。
2. 02
   搜索扩展

   在搜索框中输入其名称或关键词。各列显示作者、描述、GitHub 星标数以及（视版本而定）最后更新时间。请确认作者确实对应我们向您推荐的仓库：相似名称很常见。
3. 03
   安装

   点击 Install。Manager 会将仓库克隆到 custom_nodes，并安装其 requirements.txt 中列出的依赖。操作期间终端会不断滚动。如果该扩展存在于 Comfy Registry 中，Manager 通常会提供一个已发布且带版本号的版本，而不是最新的 Git 修订版：请选择已发布版本，它更稳定。
4. 04
   重启

   横幅会提示您重启。接受提示。ComfyUI 会重新启动，重新加载所有扩展，浏览器也会重新连接。如果界面没有自动恢复，请刷新页面。
5. 05
   检查

   双击画布并输入该扩展中某个节点的名称。如果它出现在列表中，就完成了。否则，请阅读“已安装但不存在的节点”部分。

对于脚本和无界面安装，comfy-cli 可通过命令行满足相同需求：执行 comfy node install，随后输入扩展名称，即可将其安装到当前启用的 ComfyUI 安装中。Manager 和 comfy-cli 读取的是同一个 custom_nodes 文件夹，因此可以混用。

#缺少节点：工作流打开后出现红色节点

这是 Manager 最主要的使用场景。您加载一个在线找到或从图像中提取的工作流，ComfyUI 会显示一个窗口，列出缺失的节点类型，并在画布上显示红色区块。该工作流使用了您尚未安装的扩展。

1. 01
   读取缺失类型列表

   警告窗口会显示节点的内部名称。请记下这些名称：如果自动检测失败，它们有助于找回扩展。
2. 02
   启动 Install Missing Custom Nodes

   在 Manager 菜单中，此按钮会将缺失节点与已知扩展数据库进行匹配，并显示提供这些节点的扩展。勾选它们并安装。
3. 03
   重启并重新加载工作流

   重启后，重新打开工作流文件（或再次拖入图像）。红色节点应已恢复正常颜色。
4. 04
   手动处理残留文件

   如果某个节点仍然缺失，说明检测没有找到其扩展：该扩展可能未被收录、改了名称，或者节点被作者重命名。请在仓库或工作流来源的论坛中搜索该节点的内部名称，然后在目录中按名称安装扩展。

有两个常见陷阱。第一个：某个工作流要求使用一个除了直接下载链接外在其他地方都找不到的扩展。请对此保持警惕，这正是下文所述恶意节点的模式。第二个：缺失的节点实际上属于 ComfyUI 本身，因为你的版本太旧。在这种情况下，解决办法是更新 ComfyUI，而不是什么都不要安装。

#节点已安装但不存在：IMPORT FAILED、已停用、文件夹错误

扩展在 Manager 中显示为已安装，但其节点并不存在于界面中。诊断应在 ComfyUI 启动时通过终端进行：每个扩展都会列出其加载时间，加载失败的扩展会标记 IMPORT FAILED，后面跟着 Python 堆栈跟踪。该堆栈跟踪是唯一有用的信息；寻求帮助前请先复制它。

IMPORT FAILED，错误为 ModuleNotFoundError

缺少 Python 依赖。在 Custom Nodes Manager 中筛选 Import Failed，然后点击 Try fix：Manager 会重新安装该扩展的依赖。如果仍然失败，请使用 ComfyUI 自带的 Python 手动安装该扩展的 requirements.txt（便携版中为 python_embeded）。

出现版本错误的 IMPORT FAILED

该扩展要求某个软件包的版本（通常是 torch、numpy、transformers），但该版本与另一个扩展或 ComfyUI 不兼容。需要权衡处理：阅读仓库中的 issues，停用不太重要的扩展，或等待修复。不要强行指定 torch 的版本，否则会破坏 ComfyUI。

扩展已停用

Manager 会在扩展文件夹名称后添加 .disabled 后缀，以禁用该扩展。ComfyUI 随后会完全忽略它。在目录中筛选 Disabled 即可重新启用，或者手动移除该后缀。

错误的文件夹

你有两个安装实例（Desktop 和便携版，或两个克隆版本），而扩展位于另一个实例的 custom_nodes 中。启动时终端最前面的几行会显示实际加载的文件夹路径。

仓库为空或不完整

中断的克隆会留下一个没有代码的文件夹。删除该扩展的文件夹，然后重新安装。

当 ComfyUI 本身无法启动，或安装后界面变得不稳定时，官方故障排除文档建议使用二分法定位问题。首先在完全不加载任何扩展的情况下启动 ComfyUI，以确认问题确实来自自定义节点。

python main.py --disable-all-custom-nodes

如果这样一切正常，请将 custom_nodes 文件夹中的一半移到旁边的文件夹，重新启动，然后对剩余的一半重复此操作，直到定位出故障扩展。拥有十个扩展时，四次重启就足够了。随后从 Manager 中卸载该扩展，并将终端日志提交到其仓库报告问题。

#注册表错误：节点列表无法加载

Manager 不会在本地存储目录：打开时，它会从 Manager 的仓库下载扩展列表；对于已发布的扩展，还会查询 Comfy Registry，即 Comfy Org 的官方仓库，作者会在其中发布带版本号的版本。当获取失败时，目录会保持为空，安装节点的操作会无限转圈，或者消息会提示列表加载失败。

服务器无法访问网络

Manager 从运行 ComfyUI 的机器下载，而不是从您的浏览器下载。在远程服务器或容器中，请确认该机器可以访问互联网（代理、防火墙、DNS）。从这台机器向 github.com 执行一次 curl 测试即可排除疑问。

数据库模式

在 Manager 窗口中，可以使用 DB 选择器从远程频道切换到列表的本地副本。本地模式允许你在 GitHub 无法访问时继续使用已知扩展；但它看不到之后添加的扩展。

Canal

Manager 提供多个列表频道（包括 default、recent、legacy、dev 等）。如果某个扩展没有出现，请先返回 default 频道，再继续查找；其他频道用于旧版或实验性扩展。

GitHub API 限制

大量请求后，GitHub 可能会暂时拒绝匿名调用。请等待几分钟，不要循环重试。

安全级别拒绝执行操作

如果 Manager 回复说当前安全级别不允许执行某项操作，这不是网络错误：请阅读下一节。

始终有效的最后手段：在 custom_nodes 中使用 git clone 手动安装，然后安装 requirements.txt 并重启。之后 Manager 会识别该扩展已安装，并能够对其进行更新。

#在启用扩展前识别风险扩展

自定义节点是在 ComfyUI 启动时执行的 Python 代码，拥有启动服务器的用户权限：它可以读取你的文件、浏览器会话令牌和钱包，并调用互联网。这并非理论上的风险。2026 年一月，ComfyUI 官方仓库记录了一批以“Upscaler_4K”为名发布在 Comfy Registry 上的节点，这些节点安装了针对浏览器、加密货币钱包和 Discord 令牌的数据窃取程序。2026 年四月，Censys 描述了一起针对暴露在互联网上的 ComfyUI 实例的攻击活动，攻击者利用无需身份验证即可执行代码的自定义节点。

Manager 内置了一道安全护栏：其 config.ini 文件中的 security_level 键用于设置安全级别。Manager 的仓库记录了四个值：strong、normal（默认值）、normal- 和 weak。默认级别会阻止风险最高的操作，例如从任意 Git URL 安装，或按需安装 pip 软件包；当 ComfyUI 使用 --listen 在非本地地址上启动时，限制会进一步收紧。weak 级别会取消所有屏障：只有在不监听网络的机器上执行某项明确操作期间才应启用它，完成后立即恢复为 normal。各级别允许执行的操作完整列表见 Manager 的 README；如有疑问，以该文档为准。

通过目录安装，而不是使用链接

目录和 Registry 中的扩展至少有明确记录，收到举报时可以将其移除。而直接下载链接或没有历史记录的仓库则不具备这一点。

查看作者、历史记录和星标

一个上周创建、只有两次提交、没有 issue、名称还模仿知名扩展的仓库，就是典型的恶意节点特征。星标本身不能证明什么，但真正有人使用的扩展通常会有星标，也会有未关闭的 issue。

警惕各种承诺

所谓神奇放大器、“解锁版”商业模型，或要求使用一个在其他地方都找不到的扩展的工作流：默认拒绝。

阅读 requirements.txt

在安装未知扩展之前，打开其仓库并阅读依赖列表。与图像处理无关的软件包（浏览器访问、底层网络、特殊的归档压缩）是一个警示信号。

绝不要在没有保护措施的情况下将 ComfyUI 暴露到网络上

不使用 --listen 时，ComfyUI 只监听 127.0.0.1。如果必须将其开放到网络，请在前面配置带密码的反向代理或 VPN，并将 security_level 保持为 normal。

#更新而不破坏现有配置

更新是仅次于安装的第二大故障来源。ComfyUI 更新很快，扩展往往滞后，而“全部更新”会一次性应用所有更新。三种习惯可以避免浪费一整个上午。

1. 01
   先创建快照

   Snapshot Manager，然后选择 Save snapshot。Manager 会将 ComfyUI 的修订版本、每个扩展的修订版本以及 Python 软件包列表保存到其 snapshots 文件夹中。如果更新导致工作流损坏，重启后选择 Restore 即可将全部内容恢复到该状态。
2. 02
   一次更新一个扩展

   在目录中筛选 Update，并先更新你需要的扩展。测试相关工作流。在简单安装环境中，Update All 仍然很有用，但应在创建快照之后使用。
3. 03
   单独更新 ComfyUI

   Update ComfyUI 按钮会更新核心。请在某个扩展要求时执行，而不要习惯性更新：每次核心更新都可能破坏无人维护的扩展，ComfyUI 的 README 也明确警告，最新提交可能会破坏许多扩展。

在 ComfyUI Desktop 中，核心通过应用更新，并跟随稳定版本；Manager 在其中只用于扩展。在便携版和手动安装中，程序跟随最新提交，此时快照是您唯一的安全网。一个能正常运行的工作流，比更新的版本更有价值。

#深入了解

Manager 解决的是扩展问题；它不能替代理解节点图。下面的指南将涵盖链路的其他部分，从安装 ComfyUI 到需要 custom nodes 的使用场景。

• ComfyUI：本地安装与入门
• ControlNet：构建图像，自定义节点的典型用法
• 在本地生成图像：工具概览
• Fooocus：无需节点和扩展的替代方案

本指南查阅的官方来源：ComfyUI 文档中的 Manager 页面和 custom nodes 安装页面、custom nodes 故障排除页面，以及 ComfyUI-Manager 仓库的 README（其中介绍了安全级别）。文中引用的菜单标签与这些页面所描述的 Manager 界面相对应；不同版本之间可能有所变化。

• ComfyUI 文档：Manager 界面
• ComfyUI 文档：安装 custom node
• ComfyUI 文档：排查自定义节点故障
• ComfyUI-Manager 仓库（README、安全级别）