ComfyUI-Manager 插件安装与管理使用指南

ComfyUI-Manager 插件安装与管理使用指南

ComfyUI-Manager 是一款专为增强 ComfyUI 可用性设计的扩展工具，提供了安装、移除、禁用和启用各种自定义节点的管理功能，还具备中心功能和便捷操作，帮助用户轻松访问 ComfyUI 内的各类信息。

快速安装指南

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

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

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

1. 安装 git
2. 下载 scripts/install-manager-for-portable-version.bat 到 "ComfyUI_windows_portable" 目录
3. 双击运行 install-manager-for-portable-version.bat

方法 3：通过 comfy-cli 安装（推荐）

推荐：comfy-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

方法 4：Linux+venv 安装（ComfyUI + ComfyUI-Manager）

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 方法正确安装。

您可以通过运行 ./run_gpu.sh 或 ./run_cpu.sh 来启动 ComfyUI，具体取决于您的系统配置。

快速使用指南

1. 点击主菜单上的 "Manager" 按钮
2. 点击 "Install Custom Nodes" 或 "Install Models"，将打开安装器对话框。
   • 有三种数据库模式：DB: Channel (1day cache)、DB: Local 和 DB: Channel (remote)。
     • Channel (1day cache) 利用有效期为一天的 Channel 缓存信息来快速显示列表。
       • 当没有缓存、缓存过期或通过 Channel（远程）检索外部信息时，此信息将更新。
       • 每当您重新启动 ComfyUI 时，此模式始终设置为默认模式。
     • Local 使用 ComfyUI-Manager 中本地存储的信息。
       • 此信息仅在更新 ComfyUI-Manager 时更新。
       • 对于自定义节点开发人员，在 custom-node-list.json 中注册节点并测试时应使用此模式。
     • Channel (remote) 从远程通道检索信息，始终显示最新列表。
     • 如果由于网络错误无法检索，将强制使用本地信息。
   • Fetch Updates 菜单检索本地自定义节点的更新数据。实际更新通过点击 Install Custom Nodes 菜单中的 Update 按钮应用。
3. 点击 "Install" 或 "Try Install" 按钮。
   • 已安装：此项已安装。
   • 安装：点击此按钮将安装该项。
   • 尝试安装：这是无法确认安装信息的自定义节点。点击按钮尝试安装。
   • 如果顶部出现红色背景的 Channel 指示器，则表示它不是默认通道。由于持有的信息量与默认通道不同，在此通道状态下可能不会显示许多自定义节点。
     • 通道设置影响广泛，不仅影响节点列表，还影响 "全部更新" 等所有功能。
   • 黄色背景的冲突节点显示了与其他扩展冲突的节点列表。此问题需要开发人员解决，用户应注意由于这些冲突，某些节点可能无法正常运行，可能需要相应安装。
4. 分享功能
   • 您可以通过点击主菜单底部的 "Share" 按钮或从 Image 节点的上下文菜单中选择 "Share Output" 来分享工作流。
   • 目前支持通过多种平台分享，以及通过 Matrix 频道分享。
   • 通过 Manager 菜单中的 Share 设置，您可以配置主菜单中的 Share 按钮或上下文菜单上的 Share Output 按钮的行为。
     • None：从主菜单隐藏
     • All：显示一个对话框，用户可以选择分享标题。

实用功能介绍

快照管理

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

命令行工具：cm-cli

• 提供了无需运行 ComfyUI 即可使用 ComfyUI-Manager 功能的工具。
• 有关更多详细信息，请参阅 cm-cli 文档。

安装缺失节点支持

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

配置指南

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

• ComfyUI-Manager 使用的 config.ini 路径显示在启动日志消息中。
• 另请参见：路径部分

配置选项：

[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 来禁用。
• 修复节点（重新创建）：右键点击节点并选择 Fix node (recreate)，您可以重新创建节点。小部件的值被重置，而连接保持具有相同名称的连接。
  • 用于纠正以前创建的旧工作流中与自定义节点版本更改不兼容的节点错误。
• 双击节点标题：您可以在 ComfyUI-Manager 菜单中设置节点的双击行为。
  • Copy All Connections，Copy Input Connections：双击节点复制最近节点的连接。
    • 此操作针对距离节点中心直线距离 1000 像素内的最近节点。
    • 在 Copy All Connections 的情况下，它会复制现有输出，但由于不允许重复连接，原始节点的现有输出连接将断开。
    • 此功能仅复制名称匹配的输入和输出。
  • Possible Input Connections：它连接指定范围内所有匹配最接近类型的输出。
    • 此连接链接到位于目标节点左侧的节点中最近的输出。
  • Possible(left) + Copy(right)：双击标题的左半部分时，它作为 Possible Input Connections 运行，双击右半部分时，它作为 Copy All Connections 运行。
• 防止特定软件包降级
  • 例如
• 自定义 pip 映射
  • 当您创建 pip_overrides.json 文件时，它会将特定 pip 软件包的安装更改为用户定义的安装。
    • 请参考 pip_overrides.json.template 文件。
• 防止安装特定 pip 软件包
  • 在 pip_blacklist.list 文件中每行列出一个软件包名称。
• 自动恢复 pip 安装
• 如果在 pip_auto_fix.list 中列出 pip 规范要求，类似于 requirements.txt，则在启动 ComfyUI 时或在各种自定义节点安装过程中版本不匹配时，将自动恢复指定的版本。
• 可以使用 --index-url。
• 使用 aria2 作为下载器

在 config.ini 文件的 downgrade_blacklist 部分列出软件包名称，用逗号分隔。

downgrade_blacklist = diffusers, kornia

环境变量

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

• 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

故障排除

• 如果您的 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 级别风险功能
  • Install via git url，pip install
  • 安装未在 default channel 中注册的自定义节点。
  • 修复自定义节点
• middle 级别风险功能
  • 卸载/更新
  • 安装在 default channel 中注册的自定义节点。
  • 恢复/删除快照
  • 重启
• low 级别风险功能
  • 更新 ComfyUI