2025最新ComfyUI-Manager安装指南：4种方法助你快速部署
【免费下载链接】ComfyUI-Manager 
项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
你是否还在为ComfyUI插件安装繁琐而烦恼？是否因系统环境差异导致部署失败？本文将详细介绍4种适用于不同场景的ComfyUI-Manager安装方法，无论你是普通用户、开发者还是使用便携版ComfyUI，都能找到适合自己的部署方案。读完本文你将获得：
- 掌握Windows/macOS/Linux全平台安装技巧
- 学会使用命令行工具快速部署
- 了解便携版ComfyUI专用安装流程
- 规避90%的常见安装错误
方法一：通用Git克隆安装（推荐开发者）
此方法适用于已安装ComfyUI的用户，通过Git直接克隆仓库到指定目录，确保文件结构正确。
操作步骤：
-
打开终端，导航至ComfyUI的custom_nodes目录
cd ComfyUI/custom_nodes -
克隆仓库（使用国内镜像地址）
git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager comfyui-manager -
重启ComfyUI使扩展生效
验证安装：
检查文件结构是否符合要求：
ComfyUI/
└── custom_nodes/
└── comfyui-manager/
├── __init__.py
├── README.md
└── ...其他文件
⚠️ 注意：确保仓库直接克隆到comfyui-manager目录，避免嵌套结构（如ComfyUI-Manager/ComfyUI-Manager），这会导致扩展无法被正确识别。
方法二：便携版ComfyUI专用安装（Windows用户）
针对Windows便携版ComfyUI用户，项目提供了一键安装脚本，无需手动配置环境。
准备工作：
- 安装Git（选择"使用Windows默认控制台窗口"选项）
- 确保ComfyUI便携版已解压到本地目录
安装步骤：
-
将脚本复制到ComfyUI便携版根目录
-
双击运行脚本，自动完成以下操作：
- 检查Git环境
- 创建必要目录
- 克隆仓库到正确位置
- 安装依赖项
常见问题：
- 若提示"git不是内部或外部命令"，需将Git添加到系统环境变量
- 脚本运行失败时，可右键"以管理员身份运行"重试
方法三：Comfy-CLI一键安装（全平台支持）
Comfy-CLI是官方推出的命令行工具，可同时安装ComfyUI和Manager扩展，适合全新部署场景。
环境要求：
- Python 3.8+
- Git
- pip（Python包管理器）
安装步骤：
Windows系统：
python -m venv venv
venv\Scripts\activate
pip install comfy-cli
comfy install --manager
Linux/macOS系统：
python -m venv venv
. venv/bin/activate
pip install comfy-cli
comfy install --manager
命令说明：
comfy install：安装基础ComfyUI--manager：附加安装ComfyUI-Manager扩展--force：强制重新安装（用于修复损坏的安装）
更多CLI功能可参考官方文档：docs/en/cm-cli.md
方法四：Linux系统专用脚本安装（支持venv环境）
为Linux用户提供的自动化安装脚本，自动配置虚拟环境并安装依赖。
支持发行版：
- Ubuntu 20.04+/Debian 11+
- CentOS Stream 9+/Fedora 36+
- Arch Linux（需手动安装依赖）
安装步骤：
-
添加执行权限：
chmod +x install-comfyui-venv-linux.sh -
运行脚本：
./install-comfyui-venv-linux.sh -
脚本会自动完成：
- 创建虚拟环境
- 安装ComfyUI核心
- 配置ComfyUI-Manager
- 生成启动脚本
启动应用：
安装完成后，使用生成的脚本启动：
./run_gpu.sh # 显卡加速版
# 或
./run_cpu.sh # CPU运行版
安装验证与故障排除
验证安装成功：
启动ComfyUI后，检查顶部菜单栏是否出现"Manager"按钮。若未显示，可通过以下步骤排查：
- 检查日志文件：查看ComfyUI启动日志是否有相关错误信息
- 验证文件权限：确保所有文件对当前用户有读取权限
- 检查Python环境：确认ComfyUI使用的Python环境与安装时一致
常见问题解决：
问题1：SSL证书验证失败
编辑配置文件<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini，添加：
bypass_ssl = True
问题2：Git路径配置错误
若系统中Git未添加到环境变量，可手动指定路径：
git_exe = C:/Program Files/Git/bin/git.exe
问题3：Windows事件循环错误
出现"Overlapped Object has pending operation"错误时：
windows_selector_event_loop_policy = True
总结与后续步骤
本文介绍的4种安装方法覆盖了大多数使用场景：
- 开发者首选方法一（Git克隆）
- Windows便携版用户选择方法二（一键脚本）
- 新用户推荐方法三（Comfy-CLI）
- Linux用户优先方法四（专用脚本）
安装完成后，你可以：
- 探索Manager功能：点击顶部菜单栏"Manager"按钮
- 安装自定义节点：通过"Install Custom Nodes"菜单
- 管理模型文件：使用"Install Models"功能
🔔 提示：定期通过Manager的"Update"功能更新扩展，获取最新特性和安全修复。
如果你在安装过程中遇到其他问题，可参考项目文档或提交Issue获取帮助。
附录：文件结构说明
ComfyUI-Manager的核心文件结构如下：
comfyui-manager/
├── __init__.py # 扩展入口文件
├── README.md # 项目说明文档
├── cm-cli.py # 命令行工具
├── js/ # 前端界面代码
│ ├── comfyui-manager.js
│ └── model-manager.js
├── glob/ # 核心功能模块
│ ├── manager_core.py
│ └── manager_downloader.py
└── scripts/ # 安装脚本
├── install-comfyui-venv-linux.sh
└── install-manager-for-portable-version.bat
关键配置文件路径：
- 用户配置：
<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini - 节点数据库：
node_db/ - 快照文件：
snapshots/
通过合理选择安装方法并正确配置，ComfyUI-Manager将为你的ComfyUI工作流带来极大便利。立即安装体验，开启高效的AI创作之旅！
👍 如果你觉得本指南有帮助，请点赞收藏，关注获取更多ComfyUI技巧和最佳实践。下期我们将介绍如何利用ComfyUI-Manager管理和更新自定义节点。
【免费下载链接】ComfyUI-Manager 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-Manager
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
