ComfyUI 管理器

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

注意事项

• V3.38：安全补丁 - 管理器数据已迁移到受保护路径。请参阅 迁移指南。
• V3.16：新增对 uv 的支持。请在 config.ini 中设置 use_uv。
• V3.10：移除了“双击功能”。
  • 此功能现已迁移到 https://github.com/ltdrdata/comfyui-connection-helper。
• V3.3.2：全面重构。正式支持 https://registry.comfy.org/。
• 您可以在 ComfyUI 节点信息 页面查看所有节点的详细信息。

安装方法

安装[方法1]（通用安装方式：仅安装 ComfyUI-Manager）

若要在已有的 ComfyUI 安装基础上添加 ComfyUI-Manager，可按以下步骤操作：

1. 打开终端（cmd），进入 ComfyUI/custom_nodes 目录。
2. 运行命令：git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager。
3. 重启 ComfyUI。

安装[方法2]（便携版 ComfyUI 安装方式：仅安装 ComfyUI-Manager）

1. 安装 Git：
   • 下载地址：https://git-scm.com/download/win
   • 选择独立版本，并勾选“使用 Windows 默认控制台窗口”选项。
2. 将 scripts/install-manager-for-portable-version.bat 文件下载到已安装的 "ComfyUI_windows_portable" 目录中。
   • 不要直接点击链接，请右键选择“另存为…”。
3. 双击 install-manager-for-portable-version.bat 批处理文件。

安装[方法3]（通过 comfy-cli 安装：同时安装 ComfyUI 和 ComfyUI-Manager）

推荐使用：comfy-cli 提供了丰富的 CLI 功能来管理 ComfyUI。

• 前提条件：Python 3、Git

Windows：

python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install

Linux/macOS：

python -m venv venv
. venv/bin/activate
pip install comfy-cli
comfy install

• 更多信息请参阅：https://github.com/Comfy-Org/comfy-cli

安装[方法4]（适用于 Linux + venv 环境：安装 ComfyUI 和 ComfyUI-Manager）

若要在 Linux 系统上使用 venv 环境安装 ComfyUI 并集成 ComfyUI-Manager，可按以下步骤操作：

• 前提条件：Python 3、python3-venv、Git

1. 将 scripts/install-comfyui-venv-linux.sh 文件下载到空的安装目录中。
   • 不要直接点击链接，右键选择“另存为…”。
   • ComfyUI 将被安装在指定目录的子目录中，而该目录将包含生成的可执行脚本。
2. 运行命令：chmod +x install-comfyui-venv-linux.sh。
3. 运行命令：./install-comfyui-venv-linux.sh。

安装注意事项

• 必须遵守：ComfyUI-Manager 文件必须准确放置在 ComfyUI/custom_nodes/comfyui-manager 路径下。
  • 不建议以压缩包形式进行安装。
• 切勿：直接解压到 ComfyUI/custom_nodes 目录，导致 Manager 内容如 __init__.py 直接放置于此目录中。
  • 必须先从 ComfyUI/custom_nodes 中移除所有 ComfyUI-Manager 文件。
• 切勿：解压后文件路径为 ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager。
• 切勿：解压后文件路径为 ComfyUI/custom_nodes/ComfyUI-Manager-main。
  • 在这些情况下，虽然 ComfyUI-Manager 可能会运行，但它不会被 ComfyUI 识别，也无法进行更新，且存在重复安装的风险。请将其移除，并通过 git clone 方法正确安装。

根据您的系统配置，您可以运行 ./run_gpu.sh 或 ./run_cpu.sh 来启动 ComfyUI。

Colab 笔记本

本仓库提供了 Colab 笔记本，允许您安装并使用 ComfyUI，包括 ComfyUI-Manager。要使用 ComfyUI，请点击此链接：https://colab.research.google.com/github/ltdrdata/ComfyUI-Manager/blob/main/notebooks/comfyui_colab_with_manager.ipynb。

• 支持安装 ComfyUI。
• 支持基本安装 ComfyUI-Manager。
• 支持在重新启动 Colab 笔记本时自动安装自定义节点的依赖项。

使用方法

1. 在主菜单中点击“管理器”按钮

   

2. 如果您点击“安装自定义节点”或“安装模型”，将打开一个安装对话框。

   

   • 有三种数据库模式：DB: 频道（1天缓存）、DB: 本地 和 DB: 频道（远程）。

     • 频道（1天缓存）利用有效期为一天的频道缓存信息，快速显示列表。
       • 当没有缓存、缓存过期或通过频道（远程）获取外部信息时，这些信息会被更新。
       • 每次重新启动 ComfyUI 时，此模式始终设置为默认模式。
     • 本地使用存储在 ComfyUI-Manager 本地的信息。
       • 这些信息仅在您更新 ComfyUI-Manager 时才会更新。
       • 对于自定义节点开发者来说，在将节点注册到 custom-node-list.json 并进行测试时，应使用此模式。
     • 频道（远程）从远程频道获取信息，始终显示最新列表。
     • 如果由于网络错误无法检索，则会强制使用本地信息。

   • 获取更新菜单会在本地获取自定义节点的更新数据。实际更新则需在安装自定义节点菜单中点击更新按钮来应用。

3. 点击“安装”或“尝试安装”按钮。

   

   

   • 已安装：该项目已安装。

   • 安装：点击此按钮将安装该项目。

   • 尝试安装：这是一个无法确认安装信息的自定义节点。点击该按钮以尝试安装。

   • 如果顶部出现红色背景的“频道”指示器，则表示当前并非默认频道。由于所持有的信息量与默认频道不同，许多自定义节点在此频道状态下可能不会显示。

     • 频道设置影响广泛，不仅会影响节点列表，还会影响“全部更新”等所有功能。

   • 背景为黄色的冲突节点会列出与相应扩展存在冲突的节点。这个问题需要由开发者解决，用户应注意，由于这些冲突，某些节点可能无法正常工作，因此需要相应地进行安装。

4. 分享

• 您可以通过点击主菜单底部的“分享”按钮，或从图像节点的上下文菜单中选择“分享输出”来分享工作流。
• 目前支持通过 https://comfyworkflows.com/、 https://openart.ai、https://youml.com 以及 Matrix 频道进行分享。

• 通过管理器菜单中的“分享设置”，您可以配置主菜单中的“分享”按钮或上下文菜单上的“分享输出”按钮的行为。
  • 无：从主菜单中隐藏
  • 全部：显示一个对话框，用户可以在其中选择分享标题。

路径

自 V3.38 起，管理器使用受保护的系统路径以增强安全性。

• * 如果不带任何选项运行，默认路径为 ComfyUI/user。 * 可以使用 --user-directory 来设置。

ComfyUI 版本	管理器路径
v0.3.76+（带有系统用户 API）	<USER_DIRECTORY>/__manager/
较旧版本	<USER_DIRECTORY>/default/ComfyUI-Manager/

• 基本配置文件：config.ini
• 可配置的频道列表：channels.list
• 可配置的 pip 替代项：pip_overrides.json
• 可配置的 pip 黑名单：pip_blacklist.list
• 可配置的 pip 自动修复：pip_auto_fix.list
• 保存的快照文件：snapshots/
• 启动脚本文件：startup-scripts/
• 组件文件：components/

注意：有关升级详情，请参阅迁移指南。

extra_model_paths.yaml 配置

以下设置基于标记为 is_default 的部分进行应用。

• custom_nodes: 自定义节点的安装路径
  • 导入时无需遵循设置为 is_default 的路径，但这是 ComfyUI 节点管理器安装自定义节点的路径。
• download_model_base: 模型下载路径

快照管理器

• 当您按下“保存快照”或在“管理器菜单”上使用“全部更新”时，当前的安装状态快照会被保存。
  • 快照文件目录：<USER_DIRECTORY>/default/ComfyUI-Manager/snapshots
  • 您可以重命名快照文件。
• 按下“恢复”按钮可恢复到相应快照的安装状态。
  • 但是，对于未由 Git 管理的自定义节点，快照支持并不完整。
• 按下“恢复”后，将在下次启动 ComfyUI 时生效。
  • 所选的快照文件会保存在 <USER_DIRECTORY>/default/ComfyUI-Manager/startup-scripts/restore-snapshot.json 中，重启 ComfyUI 时会应用该快照，随后将其删除。

cm-cli：面向高级用户的命令行工具

• 提供了一种工具，允许您在不运行 ComfyUI 的情况下使用 ComfyUI-Manager 的功能。
• 更多详情请参阅 cm-cli 文档。

如何将您的自定义节点注册到 ComfyUI-Manager 中

• 将条目添加到位于 ComfyUI-Manager 根目录下的 custom-node-list.json 文件中，并提交拉取请求。
• 注意：在进行更改后提交 PR 之前，请务必勾选“使用本地 DB”，并确保在“安装自定义节点”对话框中扩展列表能够正常加载。有时，缺少或多余的逗号会导致 JSON 语法错误。
• 剩余的 JSON 文件将在未来通过脚本自动更新，因此您无需担心。

自定义节点支持指南

• 注意：

  • 不应再假定 GitHub 仓库名称会与 custom_nodes 目录下的子目录名称一致。custom_nodes 目录下的子目录名称将使用 pyproject.toml 文件中 name 字段的规范化名称。
  • 尽可能避免依赖目录名称进行导入。

• https://docs.comfy.org/registry/overview

• https://github.com/Comfy-Org/rfcs

特殊用途文件（可选）

• pyproject.toml - ComfyRegistry 的规范文件。

• node_list.json - 当您的自定义节点 NODE_CLASS_MAPPINGS 模式不常规时，用于手动提供节点列表以供参考。（示例）

• requirements.txt - 安装时，此 pip 依赖项将自动安装。
• install.py - 安装时，它会自动被调用。
• 所有脚本均从相应自定义节点的根路径执行。

组件共享

• 复制与粘贴

  • 演示页面
  • 从剪贴板粘贴组件时，支持以下 JSON 格式的文本。（text/plain）

    {
      "kind": "ComfyUI Components",
      "timestamp": <当前时间戳>,
      "components": 
        {
          <组件名称>: <组件节点数据>
        }
    }
    

  • <当前时间戳> 确保时间戳始终唯一。
    • “components” 应具有与存储在 <USER_DIRECTORY>/default/ComfyUI-Manager/components 中文件内容相同的结构。
      • <组件名称>：名称应采用 <前缀>::<节点名称> 的格式。
        • <组件节点数据>：为组节点的节点数据。
          • <version>：仅允许两种格式：major.minor.patch 或 major.minor。（例如：1.0、2.2.1）
          • <datetime>：保存的时间。
          • <packname>：如果 packname 不为空，则类别变为 packname/workflow，并保存在 <USER_DIRECTORY>/default/ComfyUI-Manager/components 中的 <packname>.pack 文件中。
          • <category>：如果没有类别或 packname，则保存在 components 类别中。

              "version":"1.0",
              "datetime": 1705390656516,
              "packname": "mypack",
              "category": "util/pipe",
          

• 拖放

  • 拖放 .pack 或 .json 文件会添加相应的组件。
  • 示例包：Impact.pack

• 拖放或粘贴单个组件会添加一个节点。然而，当添加多个组件时，不会添加节点。

支持安装缺失节点

• 当您点击菜单中的 Install Missing Custom Nodes 按钮时，它会显示一个包含当前工作流中不存在节点的扩展节点列表。

配置

• 您可以修改 config.ini 文件来应用 ComfyUI-Manager 的设置。

  • ComfyUI-Manager 使用的 config.ini 路径会显示在启动日志消息中。
  • 参见：[https://github.com/ltdrdata/ComfyUI-Manager#paths]

• 配置选项：

  [default]
  git_exe = <手动指定 git 可执行文件的路径。若留空，则使用默认的 git 可执行文件路径。>
  use_uv = <使用 uv 替代 pip 进行依赖项安装。>
  default_cache_as_channel_url = <决定是否在启动时从 channel_url 指定的数据库获取数据。>
  bypass_ssl = <若出现 SSL 错误，将其设置为 True 以禁用 SSL。>
  file_logging = <配置是否创建 ComfyUI-Manager 使用的日志文件。>
  windows_selector_event_loop_policy = <若在 Windows 上发生事件循环错误，请将其设置为 True。>
  model_download_by_agent = <下载模型时，使用代理而非 torchvision_download_url。>
  downgrade_blacklist = <设置禁止降级的软件包列表。用逗号分隔列出。>
  security_level = <设置安全级别 => strong|normal|normal-|weak>
  always_lazy_install = <是否在非 Windows 环境下重启时也执行依赖项安装。>
  network_mode = <设置网络模式 => public|private|offline>
  

  • network_mode：
    • public：使用典型公共网络的环境。
    • private：使用封闭网络的环境，其中通过 channel_url 配置了私有节点数据库。（如有缓存则使用）
    • offline：使用离线网络且不进行任何外部连接的环境。（如有缓存则使用）

附加功能

• 文件日志功能

  • 此功能默认启用，可通过在 config.ini 中将 file_logging = False 来禁用。

• 修复节点（重新创建）：右键点击节点并选择“修复节点（重新创建）”时，可以重新创建该节点。小部件的值会被重置，而连接会保留相同名称的连接。

  • 用于修复旧工作流中与自定义节点版本变更不兼容的节点错误。

• 双击节点标题：您可以在 ComfyUI-Manager 菜单中设置节点的双击行为。

  • 复制所有连接、复制输入连接：双击节点会复制最近节点的连接。

    • 此操作针对距离节点中心直线距离不超过1000像素范围内的最近节点。
    • 在“复制所有连接”的情况下，它会复制现有的输出，但由于不允许重复连接，原始节点的现有输出连接会被断开。
    • 此功能仅复制名称匹配的输入和输出。

  • 可能的输入连接：它会连接指定范围内最接近类型的所有输出。

    • 这种连接会链接到目标节点左侧位置的节点中最近的输出。

  • 可能的（左）+ 复制（右）：当您双击标题的左半部分时，它会作为“可能的输入连接”运行；当您双击右半部分时，它会作为“复制所有连接”运行。

• 阻止特定包降级

  • 将包名以逗号分隔列在 config.ini 文件的 downgrade_blacklist 部分。
    • 例如：

      downgrade_blacklist = diffusers, kornia
    

• 自定义 pip 映射

  • 创建 pip_overrides.json 文件后，它会将特定 pip 包的安装方式更改为用户定义的安装方式。
    • 请参考 pip_overrides.json.template 文件。

• 阻止安装特定 pip 包

  • 将包名每行一个列在 pip_blacklist.list 文件中。

• 自动恢复 pip 安装

• 如果您在 pip_auto_fix.list 中列出类似于 requirements.txt 的 pip 规范要求，它将在启动 ComfyUI 或在各种自定义节点安装过程中版本不匹配时自动恢复指定版本。

• 可以使用 --index-url。

• 使用 aria2 作为下载器

  • 使用方法

环境变量

以下功能可以通过环境变量进行配置：

• COMFYUI_PATH：ComfyUI 的安装路径
• GITHUB_ENDPOINT：针对访问 GitHub 受限环境的反向代理配置
• HF_ENDPOINT：针对访问 Hugging Face 受限环境的反向代理配置

示例 1：

将 https://github.com/ltdrdata/ComfyUI-Impact-Pack 重定向到 https://mirror.ghproxy.com/https://github.com/ltdrdata/ComfyUI-Impact-Pack

GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com

示例 2：

将 https://huggingface.co/path/to/somewhere 改为 https://some-hf-mirror.com/path/to/somewhere

HF_ENDPOINT=https://some-hf-mirror.com 

扫描器

当您运行 scan.sh 脚本时：

• 它会更新 extension-node-map.json。

  • 为此，它会将 custom-node-list.json 中列出的自定义节点拉取或克隆到 ~/.tmp/default。
  • 若要跳过此步骤，请添加 --skip-update 选项。
  • 如果您想指定不同于 ~/.tmp/default 的路径，可以直接运行 python scanner.py [path]，而不是 scan.sh。

• 它会更新 github-stats.json。

  • 这会使用 GitHub API，因此请通过 export GITHUB_TOKEN=your_token_here 设置您的令牌，以避免快速达到速率限制而导致故障。
  • 若要跳过此步骤，请添加 --skip-stat-update 选项。

• --skip-all 选项同时应用 --skip-update 和 --skip-stat-update。

故障排除

• 如果您的 git.exe 安装在系统 Git 之外的特定位置，请先安装 ComfyUI-Manager 并运行 ComfyUI，然后在生成的 <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini 文件中，在 git_exe = 后指定包含文件名的路径。
• 如果更新 ComfyUI-Manager 本身失败，请进入 ComfyUI-Manager 目录并执行命令 git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull。
• 如果在 Windows 下出现错误信息 Overlapped Object has pending operation at deallocation on ComfyUI Manager load
  • 编辑 config.ini 文件：添加 windows_selector_event_loop_policy = True
• 如果出现 SSL: CERTIFICATE_VERIFY_FAILED 错误。
  • 编辑 config.ini 文件：添加 bypass_ssl = True

安全策略

• 编辑 config.ini 文件：添加 security_level = <LEVEL>

  • strong
    • 不允许 high 和 middle 级别的高风险功能
  • normal
    • 不允许 high 级别风险功能
    • 允许 middle 级别风险功能
  • normal-
    • 如果指定了 --listen 且不以 127. 开头，则不允许 high 级别风险功能
    • 其他情况允许 middle 级别风险功能
  • weak
    • 所有功能均可使用

• high 级别风险功能

  • 通过 git url 安装、pip install
  • 安装未注册在“默认通道”的自定义节点
  • 修复自定义节点

• middle 级别风险功能

  • 卸载/更新
  • 安装注册在“默认通道”的自定义节点
  • 恢复/移除快照
  • 重启

• low 级别风险功能

  • 更新 ComfyUI

免责声明

• 本扩展程序仅提供安装自定义节点的便利，并不保证其正常运行。

致谢

ComfyUI/ComfyUI - 一个功能强大且模块化的稳定扩散 GUI。

以及所有 ComfyUI 自定义节点开发者

ComfyUI-Manager 快速上手指南

ComfyUI-Manager 是 ComfyUI 的核心扩展工具，提供自定义节点（Custom Nodes）和模型的安装、更新、启用/禁用管理功能，并内置资源中心以便快速获取社区资源。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows, Linux, 或 macOS
• 基础依赖：
  • Python 3.8+ (推荐 3.10+)
  • Git (必须安装并配置到环境变量)
• 前置条件：已安装并可正常运行的 ComfyUI。

注意：从 V3.38 版本起，管理器数据将迁移至受保护的用户目录路径，以提升安全性。

安装步骤

您可以根据当前的 ComfyUI 部署方式选择最适合的安装方法。

方法一：通用安装（适用于标准 Git 克隆版）

如果您是通过 git clone 安装的 ComfyUI，请使用此方法。

1. 打开终端（CMD 或 PowerShell），进入 ComfyUI 的 custom_nodes 目录：

   cd path/to/ComfyUI/custom_nodes
   

2. 克隆 Manager 仓库（指定文件夹名为 comfyui-manager 以避免路径错误）：

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

3. 重启 ComfyUI。

方法二：便携版安装（适用于 Windows 整合包）

如果您使用的是 ComfyUI_windows_portable 版本：

1. 确保已安装 Git，安装时请选择 "Use Windows default console window" 选项。
2. 下载安装脚本：
   • 访问 install-manager-for-portable-version.bat
   • 右键点击链接，选择“另存为..."，将文件保存到 ComfyUI_windows_portable 根目录下。
3. 双击运行 install-manager-for-portable-version.bat 脚本。
4. 启动 ComfyUI。

方法三：使用 comfy-cli 全新安装（推荐）

如果您尚未安装 ComfyUI，推荐使用 comfy-cli 一键安装 ComfyUI 及 Manager。

前置要求：已安装 Python 3 和 Git。

Windows:

python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install

Linux/macOS:

python -m venv venv
. venv/bin/activate
pip install comfy-cli
comfy install

⚠️ 安装注意事项

• 路径规范：Manager 文件必须准确位于 ComfyUI/custom_nodes/comfyui-manager 目录下。
• 禁止直接解压：不要将下载的压缩包直接解压到 custom_nodes 目录，这会导致 __init__.py 等文件层级错误，致使插件无法识别或更新。
• 避免嵌套：确保没有形成 ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager 这样的嵌套结构。

基本使用

安装成功并重启 ComfyUI 后，界面顶部菜单栏会出现 "Manager" 按钮。

1. 安装自定义节点或模型

1. 点击主菜单上的 Manager 按钮。
2. 在弹出的菜单中选择 Install Custom Nodes（安装节点）或 Install Models（安装模型）。
3. 在安装对话框中：
   • DB 模式选择：默认使用 DB: Channel (1day cache)，加载速度快且每日更新。若需最新列表可切换为 DB: Channel (remote)。
   • 搜索与安装：输入关键词搜索所需资源。
     • 显示 Install：表示未安装，点击即可安装。
     • 显示 Installed：表示已安装。
     • 显示 Try Install：表示无法自动确认安装信息，尝试强制安装。
4. 安装完成后，根据提示重启 ComfyUI 以生效。

2. 更新所有节点

1. 点击 Manager -> Fetch Updates 获取最新的更新数据。
2. 点击 Manager -> Update All 批量更新所有已安装的自定义节点。

3. 保存与恢复快照 (Snapshot)

为了防止环境更新导致工作流失效，建议使用快照功能：

1. 保存快照：点击 Manager -> Save snapshot。当前所有节点和模型的安装状态将被记录在 <USER_DIRECTORY>/__manager__/snapshots (新版) 或 default/ComfyUI-Manager/snapshots (旧版)。
2. 恢复快照：点击 Manager -> Restore，选择之前保存的快照文件。
3. 生效：恢复操作将在下次启动 ComfyUI 时自动执行，系统将按照快照记录重新安装或回退特定版本的节点。

4. 分享工作流

• 点击主菜单底部的 Share 按钮，或在图像节点右键菜单选择 Share Output。
• 支持将工作流一键分享至 ComfyWorkflows, OpenArt, YouML 等平台。