2025最新ComfyUI-Manager安装指南：4种方法助你快速部署

你是否还在为ComfyUI插件安装繁琐而烦恼？是否因系统环境差异导致部署失败？本文将详细介绍4种适用于不同场景的ComfyUI-Manager安装方法，无论你是普通用户、开发者还是使用便携版ComfyUI，都能找到适合自己的部署方案。读完本文你将获得：

• 掌握Windows/macOS/Linux全平台安装技巧
• 学会使用命令行工具快速部署
• 了解便携版ComfyUI专用安装流程
• 规避90%的常见安装错误

方法一：通用Git克隆安装（推荐开发者）

此方法适用于已安装ComfyUI的用户，通过Git直接克隆仓库到指定目录，确保文件结构正确。

操作步骤：

1. 打开终端，导航至ComfyUI的custom_nodes目录

   cd ComfyUI/custom_nodes
   

2. 克隆仓库（使用国内镜像地址）

   git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Manager comfyui-manager
   

3. 重启ComfyUI使扩展生效

验证安装：

检查文件结构是否符合要求：

ComfyUI/
└── custom_nodes/
    └── comfyui-manager/
        ├── __init__.py
        ├── README.md
        └── ...其他文件

⚠️ 注意：确保仓库直接克隆到comfyui-manager目录，避免嵌套结构（如ComfyUI-Manager/ComfyUI-Manager），这会导致扩展无法被正确识别。

方法二：便携版ComfyUI专用安装（Windows用户）

针对Windows便携版ComfyUI用户，项目提供了一键安装脚本，无需手动配置环境。

准备工作：

1. 安装Git（选择"使用Windows默认控制台窗口"选项）
2. 确保ComfyUI便携版已解压到本地目录

安装步骤：

1. 下载安装脚本：scripts/install-manager-for-portable-version.bat

2. 将脚本复制到ComfyUI便携版根目录

3. 双击运行脚本，自动完成以下操作：

   • 检查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（需手动安装依赖）

安装步骤：

1. 下载脚本：scripts/install-comfyui-venv-linux.sh

2. 添加执行权限：

   chmod +x install-comfyui-venv-linux.sh
   

3. 运行脚本：

   ./install-comfyui-venv-linux.sh
   

4. 脚本会自动完成：

   • 创建虚拟环境
   • 安装ComfyUI核心
   • 配置ComfyUI-Manager
   • 生成启动脚本

启动应用：

安装完成后，使用生成的脚本启动：

./run_gpu.sh  # 显卡加速版
# 或
./run_cpu.sh   # CPU运行版

安装验证与故障排除

验证安装成功：

启动ComfyUI后，检查顶部菜单栏是否出现"Manager"按钮。若未显示，可通过以下步骤排查：

1. 检查日志文件：查看ComfyUI启动日志是否有相关错误信息
2. 验证文件权限：确保所有文件对当前用户有读取权限
3. 检查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用户优先方法四（专用脚本）

安装完成后，你可以：

1. 探索Manager功能：点击顶部菜单栏"Manager"按钮
2. 安装自定义节点：通过"Install Custom Nodes"菜单
3. 管理模型文件：使用"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管理和更新自定义节点。