ComfyUI-Manager 插件管理工具使用指南
快速上手：三种安装方式
标准安装方法（最常用）
如果你已经安装了 ComfyUI，这是最推荐的安装方式：
- 打开终端，进入 ComfyUI 的
custom_nodes目录 - 重启 ComfyUI 即可开始使用
执行克隆命令：
git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
便携版专用安装
针对 ComfyUI 便携版本，安装更加简单：
- 确保系统已安装 Git 工具
- 下载
scripts/install-manager-for-portable-version.bat到便携版安装目录 - 双击运行批处理文件，一切自动完成！
命令行工具安装
使用 comfy-cli 工具，一次性搞定所有安装：
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
核心功能详解
智能插件管理中心
ComfyUI-Manager 提供完整的插件生命周期管理：
- 一键安装：告别手动下载和配置
- 自动更新：保持插件始终最新版本
- 冲突检测：自动识别并提示插件兼容性问题
- 批量管理：同时处理多个插件的安装和卸载
三种数据库模式对比
| 模式 | 特点 | 适用场景 |
|---|---|---|
| Channel (1 天缓存) | 快速显示列表，自动更新缓存 | 日常使用 |
| Local | 使用本地存储信息，更新频率低 | 插件开发者测试 |
| Channel (远程) | 实时获取最新插件列表 | 追求最新功能 |
快照管理功能
当你点击'保存快照'或使用'全部更新'时，当前的安装状态快照会被自动保存。这个功能特别适合：
- 项目备份：为不同的创作项目保存不同的插件配置
- 环境迁移：轻松将配置转移到其他设备
- 版本回滚：快速恢复到之前的稳定状态
实战操作指南
基础使用流程
- 打开管理器：在 ComfyUI 主界面点击"Manager"按钮
- 选择安装：点击'安装自定义节点'或'安装模型'
- 确认安装：点击'安装'或'尝试安装'按钮
组件共享功能
通过以下方式轻松分享你的工作流：
- 在主菜单底部点击分享按钮
- 在图像节点的上下文菜单中选择分享输出
缺失节点自动安装
当你打开一个工作流时，如果缺少某些必要的节点，系统会自动显示可安装的扩展节点列表。
高级配置技巧
安全策略设置
通过修改 config.ini 文件调整安全级别：
- strong：最高安全级别，限制高风险功能
- normal：平衡安全与功能，限制高风险功能
- weak：最大功能开放，适合开发环境
环境变量配置
系统支持通过环境变量进行灵活配置：
- COMFYUI_PATH：指定 ComfyUI 安装路径
- GITHUB_ENDPOINT：配置 GitHub 反向代理
- HF_ENDPOINT：配置 Hugging Face 反向代理
故障排除宝典
常见问题解决方案
Git 执行文件问题：
- 如果 Git 安装在非标准位置，在
config.ini中指定完整路径
更新失败处理：
- 进入 ComfyUI-Manager 目录执行更新命令
SSL 证书错误：
- 在
config.ini中添加bypass_ssl = True
文件路径说明
从 V3.38 版本开始，ComfyUI-Manager 使用受保护的系统路径：
| ComfyUI 版本 | 管理器路径 |
|---|---|
| v0.3.76+ | <USER_DIRECTORY>/__manager/ |
| 旧版本 | <USER_DIRECTORY>/default/ComfyUI-Manager/ |
主要配置文件包括：
- 基础配置：
config.ini - 频道列表：
channels.list - 快照文件：
snapshots/ - 启动脚本：
startup-scripts/
总结
ComfyUI-Manager 是 AI 绘画创作中的得力助手。通过合理使用这个工具，你可以：
- 节省大量插件管理时间
- 保持工作环境的稳定和清洁
- 快速切换不同的创作项目配置
- 轻松分享和备份你的工作成果