ComfyUI-Manager安装与使用完全指南

ComfyUI-Manager是一个专为增强ComfyUI可用性而设计的扩展插件。它提供了管理功能，可以安装、移除、禁用和启用各种ComfyUI自定义节点。此外，该扩展还提供了集线器功能和便捷功能，用于访问ComfyUI内的广泛信息。

环境准备与系统要求

在开始安装前，请确保你的系统满足以下要求：

系统要求：

• 操作系统：Windows 10/11、macOS Big Sur+、Linux Ubuntu 20.04+
• Python版本：3.9-3.11（推荐3.10稳定版）
• 内存配置：建议16GB RAM以获得最佳体验
• 存储空间：预留5GB可用空间

环境验证： 打开终端或命令提示符，输入以下命令检查环境：

python --version
git --version

确保Python和Git正确安装并配置了环境变量。

核心安装方法

方法一：通用Git克隆安装（推荐大多数用户）

这是最直接可靠的安装方式，适合已有ComfyUI环境的用户：

1. 定位ComfyUI目录 导航到你的ComfyUI安装目录下的custom_nodes文件夹：

   cd path/to/ComfyUI/custom_nodes
   

2. 克隆仓库 使用以下命令克隆ComfyUI-Manager：

   git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager comfyui-manager
   

3. 重启ComfyUI 完成克隆后，重启ComfyUI应用程序

验证安装： 检查文件结构是否正确：

ComfyUI/
└── custom_nodes/
    └── comfyui-manager/
        ├── __init__.py
        ├── js/
        ├── glob/
        └── scripts/

方法二：便携版一键安装（Windows用户专属）

针对Windows便携版用户，我们提供了专用脚本：

1. 下载安装脚本 获取脚本文件：scripts/install-manager-for-portable-version.bat

2. 运行安装

   • 将脚本复制到ComfyUI便携版根目录
   • 双击运行，自动完成所有配置

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

方法四：Linux+venv环境安装（ComfyUI + ComfyUI-Manager）

要在Linux上使用venv环境安装ComfyUI和ComfyUI-Manager，可以按照以下步骤操作：

前提条件：python-is-python3, python3-venv, git

1. 下载脚本文件：scripts/install-comfyui-venv-linux.sh到空的安装目录
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-Manager中被识别，并且无法执行更新。还存在重复安装的风险。请删除它并通过git clone方法正确安装。

使用指南

基本操作流程

1. 点击主菜单上的"Manager"按钮

2. 如果你点击"Install Custom Nodes"或"Install Models"，将打开一个安装程序对话框。

   • 有三种数据库模式：DB: Channel (1day cache)、DB: Local和DB: Channel (remote)。

     • Channel (1day cache)利用有效期为一天的Channel缓存信息快速显示列表。
       • 当没有缓存时、缓存过期时或通过Channel（remote）检索外部信息时，此信息将被更新。
       • 每当你重新启动ComfyUI时，此模式始终设置为默认模式。
     • Local使用存储在ComfyUI-Manager中的本地信息。
       • 此信息仅在更新ComfyUI-Manager时更新。
       • 对于自定义节点开发者，在custom-node-list.json中注册节点并进行测试时应使用此模式。
     • Channel (remote)从远程频道检索信息，始终显示最新列表。
     • 在由于网络错误无法检索的情况下，它将强制使用本地信息。

   • Fetch Updates菜单在本地检索自定义节点的更新数据。实际更新通过在Install Custom Nodes菜单中单击Update按钮来应用。

3. 点击"Install"或"Try Install"按钮。

   • Installed：此项目已安装。
   • Install：单击此按钮将安装该项目。
   • Try Install：这是一个无法确认安装信息的自定义节点。单击按钮尝试安装它。

分享功能

• 你可以通过单击主菜单底部的Share按钮或从Image节点的Context Menu中选择Share Output来分享工作流。

• 目前，它支持通过Matrix频道进行分享。

• 通过Manager菜单中的Share设置，你可以配置主菜单中Share按钮或Context Menu上Share Output按钮的行为。

  • None：从主菜单隐藏
  • All：显示一个对话框，用户可以在其中选择分享标题。

路径配置

在ComfyUI-Manager V3.0及更高版本中，配置文件和动态生成的文件位于<USER_DIRECTORY>/default/ComfyUI-Manager/下。

• <USER_DIRECTORY>

  • 如果执行时没有任何选项，则路径默认为ComfyUI/user。
  • 可以使用--user-directory <USER_DIRECTORY>进行设置。

• 基本配置文件：<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini

• 可配置的频道列表：<USER_DIRECTORY>/default/ComfyUI-Manager/channels.ini

• 可配置的pip覆盖：<USER_DIRECTORY>/default/ComfyUI-Manager/pip_overrides.json

• 可配置的pip黑名单：<USER_DIRECTORY>/default/ComfyUI-Manager/pip_blacklist.list

• 可配置的pip自动修复：<USER_DIRECTORY>/default/ComfyUI-Manager/pip_auto_fix.list

• 保存的快照文件：<USER_DIRECTORY>/default/ComfyUI-Manager/snapshots

• 启动脚本文件：<USER_DIRECTORY>/default/ComfyUI-Manager/startup-scripts

• 组件文件：<USER_DIRECTORY>/default/ComfyUI-Manager/components

快照管理功能

• 当你在Manager Menu上按下Save snapshot或使用Update All时，当前安装状态快照将被保存。
  • 快照文件目录：<USER_DIRECTORY>/default/ComfyUI-Manager/snapshots
  • 你可以重命名快照文件。
• 按下"Restore"按钮可恢复到相应快照的安装状态。
  • 但是，对于不受Git管理的自定义节点，快照支持不完整。
• 当你按下Restore时，将在下次ComfyUI启动时生效。
  • 选定的快照文件保存在<USER_DIRECTORY>/default/ComfyUI-Manager/startup-scripts/restore-snapshot.json中，在重启ComfyUI时，快照将被应用然后删除。

故障排除

常见问题解决

问题1：Manager按钮未显示

• 检查custom_nodes目录结构是否正确
• 确认__init__.py文件存在
• 查看ComfyUI启动日志是否有错误信息

问题2：SSL证书错误 编辑配置文件，添加以下内容：

bypass_ssl = True

问题3：Git路径问题 手动指定Git执行路径：

git_exe = C:/Program Files/Git/bin/git.exe

问题4：事件循环错误（Windows） 编辑配置文件，添加以下内容：

windows_selector_event_loop_policy = True

安全策略

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

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

• high级别的风险功能

  • Install via git url、pip install
  • 未在default channel中注册的自定义节点的安装
  • 修复自定义节点

• middle级别的风险功能

  • 卸载/更新
  • 在default channel中注册的自定义节点的安装
  • 恢复/删除快照

• low级别的风险功能

  • 更新ComfyUI

组件共享

• 复制和粘贴

  • 当从剪贴板粘贴组件时，它支持以下JSON格式的文本。

    {
      "kind": "ComfyUI Components",
      "timestamp": <current timestamp>,
      "components":
        {
          <component name>: <component nodedata>
        }
    }
    

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

• 拖放

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

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

环境变量配置

可以使用环境变量配置以下功能：

• 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

总结

ComfyUI-Manager是一个功能强大的ComfyUI扩展管理器，它极大地简化了自定义节点的安装和管理过程。通过本文提供的多种安装方法和详细使用指南，你可以根据自己的系统环境和需求选择最适合的安装方案。

安装完成后，你将能够轻松浏览、安装和更新数百个自定义节点，管理AI模型，以及分享和获取社区优秀工作流。记得定期使用更新功能保持插件的最新状态，享受持续优化的功能和性能提升。

对于不同的用户群体，我们建议：

• 新手用户：推荐方法二的一键安装脚本
• 普通用户：使用方法一的Git克隆安装
• 开发者：可直接阅读官方文档进行深入定制

立即安装ComfyUI-Manager，开启你的AI绘画管理新体验！