ComfyUI-Manager完整使用指南：从安装到高级配置

ComfyUI-Manager完整使用指南：从安装到高级配置

【免费下载链接】ComfyUI-Manager项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager

ComfyUI-Manager是专为增强ComfyUI可用性而设计的扩展管理工具，提供了强大的自定义节点安装、移除、禁用和启用功能。作为ComfyUI生态中不可或缺的管理组件，它不仅简化了节点管理流程，还通过集线器功能让用户能够轻松访问ComfyUI内的各类信息。

安装方法详解

标准Git安装方式

这是最常用的安装方法，适用于大多数ComfyUI环境：

1. 进入ComfyUI的custom_nodes目录
2. 执行克隆命令：git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager comfyui-manager
3. 重启ComfyUI服务

便携版本安装方案

针对Windows便携版ComfyUI用户：

1. 确保系统已安装Git工具
2. 下载scripts/install-manager-for-portable-version.bat到ComfyUI_windows_portable目录
3. 双击运行批处理文件完成安装

命令行工具集成安装

通过comfy-cli工具实现一站式安装：

python -m venv venv venv\Scripts\activate # Windows # 或 . venv/bin/activate # Linux/macOS pip install comfy-cli comfy install

核心功能使用技巧

自定义节点管理

在Manager菜单中点击"Install Custom Nodes"或"Install Models"，系统将打开安装器对话框。这里有三种数据库模式可供选择：

• Channel (1day cache)：使用带有一天有效期的频道缓存信息快速显示列表
• Local：使用ComfyUI-Manager本地存储的信息
• Channel (remote)：从远程频道获取最新信息

更新管理策略

点击"Fetch Updates"菜单可以获取本地自定义节点的更新数据。实际更新需要通过点击"Install Custom Nodes"菜单中的"Update"按钮来应用。

快照功能应用

当您在Manager菜单中按下"Save snapshot"或使用"Update All"功能时，当前安装状态的快照将被保存。快照文件存储在<USER_DIRECTORY>/default/ComfyUI-Manager/snapshots目录中。

快照操作要点：

• 可以重命名快照文件以便于管理
• 点击"Restore"按钮可以恢复到相应快照的安装状态
• 对于非Git管理的自定义节点，快照支持可能不完整

高级配置管理

配置文件详解

从V3.38版本开始，Manager使用受保护的系统路径以增强安全性。主要配置文件包括：

• 基础配置：config.ini
• 频道列表：channels.list
• pip覆盖配置：pip_overrides.json
• pip黑名单：pip_blacklist.list
• 快照文件：snapshots/目录
• 启动脚本：startup-scripts/目录

网络模式配置

在config.ini中设置network_mode参数：

• public：使用典型公共网络的环境
• private：使用封闭网络的环境，通过channel_url配置私有节点数据库
• offline：使用离线网络时不使用任何外部连接的环境

安全策略设置

通过修改config.ini文件中的security_level参数来设置安全级别：

• strong：不允许高风险和中风险功能
• normal：不允许高风险功能
• normal-：如果指定了--listen且不以127.开头，则不允许高风险功能
• weak：所有功能均可用

故障排除指南

常见问题解决方案

Git执行路径问题：如果git.exe安装在特定位置而非系统Git路径，请在生成的config.ini文件中指定完整路径。

SSL证书验证失败：当出现SSL: CERTIFICATE_VERIFY_FAILED错误时，在config.ini文件中添加bypass_ssl = True

Windows事件循环错误：在Windows上遇到事件循环错误时，编辑config.ini文件添加windows_selector_event_loop_policy = True

自定义节点支持

特殊用途文件（可选）：

• pyproject.toml- comfyregistry的规范文件
• node_list.json- 当自定义节点的NODE_CLASS_MAPPINGS模式非常规时，用于手动提供节点列表以供参考。

组件共享功能

复制粘贴操作

从剪贴板粘贴组件时，支持以下JSON格式的文本：

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

拖放功能应用

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

缺失节点安装

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

环境变量配置

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

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

示例配置

重定向GitHub访问：

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

重定向Hugging Face访问：

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

扫描器工具使用

运行scan.sh脚本时：

• 更新extension-node-map.json文件
• 更新github-stats.json统计信息

使用选项说明：

• 添加--skip-update选项跳过更新步骤
• 添加--skip-stat-update选项跳过统计更新
• 添加--skip-all选项同时跳过更新和统计更新

通过掌握这些ComfyUI-Manager的使用技巧和配置方法，您将能够更高效地管理ComfyUI扩展，充分发挥其在AI图像生成工作流中的强大功能。

【免费下载链接】ComfyUI-Manager项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager