ComfyUI-Manager完整指南：轻松管理你的AI工作流扩展
【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
ComfyUI-Manager是专为ComfyUI设计的强大管理工具，它让AI创作者能够轻松安装、管理和维护各种自定义节点。无论你是刚接触ComfyUI的新手，还是寻求更高效工作流程的资深用户，这个扩展都能显著提升你的创作效率。通过ComfyUI-Manager，你可以一键安装数百个社区开发的节点，管理模型文件，创建配置快照，甚至通过命令行工具自动化管理任务。
🤔 为什么你需要ComfyUI-Manager？
如果你曾经尝试过手动管理ComfyUI的自定义节点，可能会遇到以下痛点：
- 安装繁琐：每个节点都需要单独克隆仓库、处理依赖
- 版本冲突：不同节点可能要求相互冲突的Python包版本
- 更新困难：手动跟踪数十个节点的更新状态几乎不可能
- 配置丢失：重装系统或迁移环境时难以恢复完整配置
ComfyUI-Manager正是为了解决这些问题而设计的。它提供了一个集中式的管理界面，让你能够：
- 📦 一键安装和卸载自定义节点
- 🔄 批量更新所有已安装节点
- 🚫 启用或禁用特定节点
- 💾 创建和恢复配置快照
- 🛠️ 自动处理依赖冲突
🚀 快速开始：安装ComfyUI-Manager
标准安装方法
对于大多数用户，安装ComfyUI-Manager非常简单：
- 打开终端或命令提示符
- 导航到你的ComfyUI安装目录下的
custom_nodes文件夹 - 执行以下命令克隆仓库：
cd /path/to/ComfyUI/custom_nodes git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager- 重启ComfyUI
就是这么简单！重启后，你会在ComfyUI界面顶部看到一个"Manager"菜单项。
便携版安装
如果你使用的是便携版ComfyUI，安装过程略有不同：
- 下载安装脚本：scripts/install-manager-for-portable-version.bat
- 将脚本文件放入你的便携版ComfyUI根目录
- 双击运行批处理文件
脚本会自动处理所有安装步骤，包括Git的配置和依赖安装。
🎯 核心功能详解
1. 节点管理界面
安装完成后，点击ComfyUI顶部的"Manager"菜单，你会看到以下选项：
| 菜单项 | 功能描述 | 使用场景 |
|---|---|---|
| Install Custom Nodes | 浏览和安装自定义节点 | 需要新功能时 |
| Update All | 批量更新所有已安装节点 | 保持节点最新 |
| Manage Custom Nodes | 管理已安装节点（启用/禁用） | 解决冲突或临时禁用 |
| Model Manager | 下载和管理AI模型 | 需要新模型时 |
| Snapshot Manager | 创建和恢复配置快照 | 备份或迁移环境 |
| Settings | 配置管理器选项 | 调整网络、安全等设置 |
2. 节点安装流程
安装新节点只需三步：
- 浏览节点库：在"Install Custom Nodes"界面中，你可以按类别或搜索查找需要的节点
- 查看详细信息：点击节点名称查看描述、作者、依赖要求等信息
- 一键安装：点击"Install"按钮，管理器会自动处理克隆、依赖安装等所有步骤
💡专业提示：安装前可以点击"Try Install"按钮测试安装过程，这不会实际安装但会显示可能的问题。
3. 快照管理功能
快照是ComfyUI-Manager最强大的功能之一。它可以保存你当前所有节点的安装状态，包括：
- ✅ 所有已安装的节点及其版本
- 📦 相关的Python依赖包
- ⚙️ 配置文件状态
创建快照：
# 通过命令行工具 python custom_nodes/ComfyUI-Manager/cm-cli.py save-snapshot --output my-backup.json # 或通过界面 Manager → Snapshot Manager → Save Snapshot恢复快照： 当你需要迁移环境或恢复配置时，只需选择相应的快照文件，管理器会自动还原所有节点和依赖。
🔧 高级配置技巧
配置文件详解
ComfyUI-Manager使用几个关键配置文件来自定义行为：
| 配置文件 | 位置 | 作用 |
|---|---|---|
| config.ini | <USER_DIRECTORY>/__manager/ | 主配置文件 |
| channels.list | 同上 | 自定义节点源列表 |
| pip_overrides.json | 同上 | Python包版本覆盖 |
| pip_blacklist.list | 同上 | 禁止安装的包列表 |
安全设置优化
从V3.38版本开始，ComfyUI-Manager增强了安全性，将用户数据迁移到受保护的系统路径。你可以根据使用环境调整安全级别：
[default] security_level = normal # 可选：strong|normal|normal-|weak安全级别说明：
- strong：最高安全，禁用所有高风险功能
- normal：平衡安全与功能（推荐）
- normal-：非本地监听时增强安全
- weak：最低安全，所有功能可用
网络模式配置
根据你的网络环境选择合适的模式：
[default] network_mode = public # 可选：public|private|offline| 模式 | 适用场景 | 特点 |
|---|---|---|
| public | 标准公网环境 | 使用默认远程节点数据库 |
| private | 内网/私有网络 | 使用配置的私有channel_url |
| offline | 完全离线环境 | 仅使用本地缓存数据 |
💻 命令行工具：cm-cli
对于高级用户，ComfyUI-Manager提供了强大的命令行工具cm-cli，让你无需启动ComfyUI就能管理节点。
常用命令示例
# 查看已安装节点 python cm-cli.py show installed # 安装新节点 python cm-cli.py install ComfyUI-Impact-Pack --channel default # 更新所有节点 python cm-cli.py update all # 创建快照 python cm-cli.py save-snapshot --output backup.json # 从快照恢复 python cm-cli.py restore-snapshot backup.json批量操作技巧
# 批量安装多个节点 python cm-cli.py install node1 node2 node3 # 禁用冲突节点 python cm-cli.py disable conflicting-node # 检查更新但不安装 python cm-cli.py update --check-only🛠️ 故障排除指南
常见问题与解决方案
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 安装失败 | 网络连接问题 | 检查代理设置或使用镜像源 |
| 节点冲突 | 依赖版本不兼容 | 在Manager中禁用冲突节点 |
| 启动缓慢 | 节点加载过多 | 禁用不常用的节点 |
| 更新错误 | 节点仓库变更 | 手动删除节点文件夹重新安装 |
环境检查脚本
ComfyUI-Manager提供了环境检查脚本，帮助你诊断问题：
# 运行检查脚本 ./check.sh # 或Windows系统 check.bat检查脚本会验证：
- Python版本兼容性
- 关键依赖包状态
- 系统路径配置
- Git可执行性
📊 数据库模式选择
ComfyUI-Manager支持三种数据库模式，适应不同使用场景：
| 模式 | 更新频率 | 使用场景 | 特点 |
|---|---|---|---|
| Channel (1天缓存) | 每天更新 | 日常使用 | 快速显示，缓存一天 |
| Local | 仅管理器更新时 | 开发者测试 | 使用本地嵌入数据 |
| Channel (远程) | 实时 | 需要最新列表 | 总是获取最新信息 |
切换方法：在Manager界面的"Install Custom Nodes"页面顶部选择。
🔄 工作流分享功能
ComfyUI-Manager集成了工作流分享功能，让你可以轻松分享创作：
分享方式：
- 点击主菜单底部的Share按钮
- 在图像节点的右键菜单中选择"Share Output"
支持平台：
- https://comfyworkflows.com/
- https://openart.ai
- https://youml.com
- Matrix频道
分享设置： 在Manager菜单的Share settings中，可以配置分享按钮的行为：
None：从主菜单隐藏All：显示对话框让用户选择分享标题
🎨 自定义节点注册指南
如果你是节点开发者，想要将自己的节点添加到ComfyUI-Manager中：
准备节点信息：
- 确保节点有清晰的README
- 提供准确的依赖要求
- 包含示例工作流
添加节点条目： 编辑
custom-node-list.json文件，按照现有格式添加你的节点信息。测试本地注册： 在提交PR前，启用"Use local DB"模式，确保节点列表能正常加载。
提交PR： 向ComfyUI-Manager仓库提交Pull Request。
💡重要提示：在提交前仔细检查JSON语法，避免缺少或多余的逗号导致语法错误。
📈 最佳实践建议
1. 定期维护流程
为了保持系统稳定，建议建立以下维护习惯：
- 每周：检查节点更新（
Update All） - 每月：清理缓存文件（
./check.sh --clean） - 每季度：备份配置快照
- 重大更新前：总是创建快照备份
2. 节点管理策略
- 按需安装：只安装真正需要的节点，避免不必要的依赖冲突
- 分类管理：将相关功能的节点分组管理
- 定期清理：卸载长时间不使用的节点
- 版本控制：重要项目使用快照功能记录完整配置
3. 性能优化技巧
- 延迟加载：在
prestartup_script.py中启用延迟加载策略 - 缓存利用：利用管理器缓存减少重复下载
- 并发下载：根据网络状况调整
MAX_DOWNLOAD_WORKERS - 内存管理：为Python设置适当的内存优化环境变量
🚀 下一步学习路径
掌握了ComfyUI-Manager的基础使用后，你可以进一步探索：
- 自动化管理：学习使用cm-cli进行脚本化节点管理
- 私有部署：搭建自己的节点源服务器
- 高级配置：深入研究配置文件选项
- 社区贡献：为开源项目提交改进或新功能
ComfyUI-Manager不仅仅是一个管理工具，它是你AI创作工作流的核心枢纽。通过合理使用其各项功能，你可以：
- ✅ 减少90%的节点管理时间
- ✅ 避免95%的依赖冲突问题
- ✅ 实现一键环境迁移和恢复
- ✅ 保持工作流的最新和稳定
现在就开始使用ComfyUI-Manager，让你的AI创作之旅更加顺畅高效！记住，良好的工具管理习惯是高效创作的基础。Happy creating! 🎨
资源链接：
- 官方文档：docs/en/cm-cli.md
- 安全迁移指南：docs/en/v3.38-userdata-security-migration.md
- 核心管理模块：glob/manager_core.py
- 命令行工具源码：cm-cli.py
【免费下载链接】ComfyUI-ManagerComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
