ComfyUI-Manager 高效管理 AI 绘画工作流节点和模型

安全性与权限管理

从 V3.38 版本开始，引入了增强的安全特性：

• 受保护的系统路径：配置文件迁移到 user/__manager/ 目录
• 四级安全策略：
  • strong：仅允许更新 ComfyUI
  • normal：允许安装/更新注册的自定义节点和模型（默认）
  • normal-：额外允许通过 Git URL 或 pip 本地安装
  • weak：允许所有操作（仅限隔离开发环境）

您可以在 config.ini 文件中调整安全级别，确保在不同使用场景下的安全性。

高级使用技巧

命令行工具 cm-cli

对于高级用户，提供了强大的命令行工具 cm-cli，无需启动 ComfyUI 界面即可管理节点：

# 查看已安装节点
python cm-cli.py show installed
# 安装新节点
python cm-cli.py install ComfyUI-Impact-Pack ComfyUI-Inspire-Pack
# 更新所有节点
python cm-cli.py update all
# 保存快照
python cm-cli.py save-snapshot
# 恢复快照
python cm-cli.py restore-snapshot my_snapshot.json

组件共享与协作

支持多种组件共享方式：

• 复制粘贴：将组件以 JSON 格式复制到剪贴板
• 拖放导入：直接拖放 .pack 或 .json 文件
• 示例包：Impact.pack 展示了标准的组件包格式

缺失节点自动检测

当打开一个工作流时，如果缺少必要的节点，ComfyUI-Manager 会自动检测并显示 "Install Missing Custom Nodes" 按钮，点击即可一键安装所有缺失的依赖节点。

配置与优化

配置文件详解

主要配置文件是 config.ini，支持以下关键配置：

[default]
git_exe = # 手动指定 git 可执行文件路径
use_uv = # 使用 uv 替代 pip 安装依赖
bypass_ssl = # SSL 错误时设置为 True
security_level = normal # 安全级别：strong|normal|normal-|weak
network_mode = public # 网络模式：public|private|offline

网络优化设置

对于网络受限的环境，提供了灵活的配置选项：

# 设置 GitHub 镜像
export GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com
# 设置 Hugging Face 镜像
export HF_ENDPOINT=https://some-hf-mirror.com

依赖管理高级功能

• 自定义 pip 映射：通过 pip_overrides.json 重定向特定包的安装源
• 包黑名单：在 pip_blacklist.list 中列出禁止安装的包
• 自动修复：在 pip_auto_fix.list 中指定 pip 要求，自动修复版本不匹配

故障排除与常见问题

安装问题

问题：安装失败或节点不显示 解决方案：

1. 检查网络连接，尝试使用网络镜像
2. 确认 ComfyUI 版本是否为 v0.3.76 或更高
3. 查看 Manager 的启动日志，定位具体错误

问题：SSL 证书验证失败 解决方案：在 config.ini 中添加 bypass_ssl = True

更新问题

问题：无法更新 ComfyUI-Manager 自身 解决方案：进入 ComfyUI-Manager 目录执行：

git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull

安全迁移指南

如果您从旧版本升级到 V3.38，需要了解重要的安全迁移变更：

1. 配置自动迁移：config.ini 会自动迁移到新位置
2. 快照手动迁移：需要从 .legacy-manager-backup/snapshots/ 手动复制到 user/__manager/snapshots/
3. 安全级别调整：旧版本的低安全级别会自动提升到 normal

最佳实践与建议

工作流管理

1. 定期创建快照：在进行重大更改前保存快照
2. 使用版本控制：为重要工作流创建多个快照版本
3. 清理无用节点：定期检查并卸载不再使用的节点

性能优化

1. 选择合适的网络模式：根据环境设置 network_mode
2. 利用缓存：在稳定环境下使用 DB: Local 模式加快加载速度
3. 批量操作：使用命令行工具进行批量安装和更新

团队协作

1. 共享快照文件：将配置好的环境快照分享给团队成员
2. 统一节点版本：确保团队成员使用相同的节点版本
3. 建立内部频道：为团队创建私有的自定义节点频道