ComfyUI-Manager：ComfyUI 自定义节点与模型管理器｜部署与使用全指南

项目仓库： https://github.com/Comfy-Org/ComfyUI-Manager（原 ltdrdata/ComfyUI-Manager）

维护方：Comfy-Org / ltdrdata · 形态：ComfyUI 扩展 · 最新版本：V3.38 · 注册表：registry.comfy.org

1 项目简介

ComfyUI-Manager 是 ComfyUI 最核心的扩展之一：在 ComfyUI 界面里一键安装、卸载、启用、禁用自定义节点与模型，提供节点搜索、缺失依赖自动修复、工作流迁移等功能。V3.3 起官方支持 registry.comfy.org 节点注册表。

1.1 核心信息一览

1.2 适用场景

• 在 ComfyUI 里安装/管理自定义节点。
• 下载模型、修复缺失依赖、迁移工作流。

2 功能特性

• 节点管理：安装、卸载、启用、禁用。
• 模型安装：一键下载模型到对应目录。
• Hub 功能：浏览节点、查看详情。
• 依赖修复：自动检测缺失依赖并安装。
• 工作流迁移：把旧工作流迁移到新节点版本。
• uv 支持：V3.16 起在 config.ini 设 use_uv。
• 安全迁移：V3.38 数据迁移到受保护路径。

3 官方界面预览

开篇图为 Manager 的安装对话框。

4 官方跳转链接汇总

5 前置要求

• 已安装 ComfyUI。
• Python 3、git。

6 方式一：git clone 安装（通用）

cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
# 重启 ComfyUI

路径必须是 ComfyUI/custom_nodes/comfyui-manager，不要多套一层目录。

7 方式二：便携版 Windows 一键安装

下载 scripts/install-manager-for-portable-version.bat 到 ComfyUI_windows_portable 目录，双击运行。

8 方式三：comfy-cli 一键装 ComfyUI + Manager

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install comfy-cli
comfy install

9 方式四：Linux venv 一键脚本

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

10 使用

1. 主菜单点 "Manager" 按钮。
2. 选 "Install Custom Nodes" 或 "Install Models"。
3. 搜索并安装。

11 常见故障与风险

• 路径错误：Manager 必须在 ComfyUI/custom_nodes/comfyui-manager，不能多套 ComfyUI-Manager-main。
• 重复安装：删除错误目录后重新 git clone。
• 安全补丁：V3.38 起按官方迁移指南迁移用户数据。

本文基于官方 README 整理，仅供学习与部署参考；以仓库最新说明为准。