如何安装 ComfyUI 自定义节点（插件）

本文将以安装 ComfyUI-Manager 为例进行讲解。

https://github.com/ltdrdata/ComfyUI-Manager.git

ComfyUI Manager 是一个实用的插件，可以帮助你自动安装插件、下载模型等。你可以把这个插件当作一个大型资源库，随时使用它下载内容；不过如果你在中国境内，可能会因网络访问问题导致下载体验不佳，但它仍能极大地方便你日常使用 ComfyUI。

本文将介绍以下几种插件安装方式：

1. ComfyUI Manager 安装（推荐）
2. Git 安装：使用 Git 命令进行安装
3. 手动安装：通过压缩包手动安装 ComfyUI 插件
4. 秋叶 ComfyUI 启动器安装
5. 在中国境内使用 Gitee 克隆 GitHub 仓库

除手动安装外，以上这些方式本质上都是通过 Git 进行安装，只是使用方式不同。不过在中国境内访问 GitHub 可能会存在问题，因此在本文最后，我也会介绍如何在中国境内把插件仓库克隆到 Gitee 等平台来进行安装。

安装自定义节点之后，通常还需要安装它们对应的依赖关系。每个自定义节点都有一个 requirements.txt 文件，其中包含该节点所需的 Python 依赖项。在讲解完所有安装方式之后，我们会统一讨论如何为不同的自定义节点安装依赖。

一、使用 ComfyUI Manager 安装插件

1. ComfyUI Manager 新版本菜单位置

如图所示，如果你的 ComfyUI 安装正确，那么最新版本菜单界面中 ComfyUI Manager 的位置就如上图所示。

2. ComfyUI Manager 旧版本菜单位置

如果安装成功，打开 ComfyUI 界面后，你应该会看到以下效果（旧版本） 在菜单选项中会新增一个 Manager 选项，它就是 ComfyUI Manager 的入口。

3. 使用 ComfyUI Manager 安装插件

步骤 1： 在弹出的 ComfyUI Manager 菜单中，你可以看到 自定义节点管理器（安装新插件） 入口，点击如下图所示的对应按钮

在这一步，你也可以点击界面中的 通过 Git URL 安装 按钮，然后输入对应的 Git 地址进行安装。

步骤 2： 下面是相应的 自定义节点管理器 界面

1. 在位置 1 处，在搜索框中输入你想安装的插件名称，例如 ComfyUI-Manager
2. 在位置 2 处，找到你需要的插件并点击 安装 按钮进行安装
3. 在位置 3 处，你也可以使用对应的 Git 地址进行安装
4. 等待安装完成，有时你可能需要重新启动 ComfyUI 才能让安装生效

4. 使用 ComfyUI Manager 更新插件

更新插件与安装插件类似。在相应的插件过滤器中筛选出已安装的插件，然后点击 尝试更新 按钮即可更新。

二、使用 Git 安装 ComfyUI 插件

这里我将介绍两种安装方法：

1. Git 命令行安装（需要预先安装 Git，推荐使用）
2. GitHub Desktop 安装（对不熟悉 Git 的用户更加友好）

强烈建议大家先学习 Git 的基础知识，具体可以查看 Git 安装与入门指南 章节。

1. Git 命令行安装

如何找到插件的 Git 地址

• Git 软件下载地址：https://git-scm.com/

首先找到你想要安装的插件的 Git 仓库，例如 https://github.com/ltdrdata/ComfyUI-Manager

1. 点击页面中绿色的 <>code 按钮
2. 在弹窗中点击 https 选项输入框后面的复制按钮
3. 这样你就复制到了链接 https://github.com/ltdrdata/ComfyUI-Manager.git

如何使用 Git 命令行安装插件

1. 打开 CMD 终端，首先使用 cd 指令进入你的 ComfyUI 插件所在的文件夹，例如 E:/ComfyUI_windows_portable/ComfyUI/custom_nodes

cd E:/ComfyUI_windows_portable/ComfyUI/custom_nodes

2. 然后使用 git clone 指令克隆对应的代码仓库

git clone https://github.com/ltdrdata/ComfyUI-Manager.git

3. 等待出现成功提示
4. 重新启动 ComfyUI，查看插件是否安装成功

注意：在中国使用 GitHub 很容易失败，你可以先将对应的插件仓库同步到 Gitee 等国内代码仓库，以提高成功率。

如何使用 Git 更新插件

使用 Git 更新插件的方法与前面的步骤类似，你需要先使用 cd 进入插件目录，然后使用 git pull 指令进行更新

# Enter the plugin directory
cd E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager
# Use git pull command to update
git pull

2. GitHub Desktop 安装与更新

不太推荐使用 GitHub Desktop，因为掌握 Git 其实并不复杂。

1. 首先你需要注册一个 GitHub 账号。GitHub 注册地址：https://github.com/
2. 然后从 https://desktop.github.com/ 下载 GitHub Desktop
3. 下载安装完成后，打开软件并完成账号登录

使用 GitHub Desktop 安装插件

按照以下步骤使用 GitHub Desktop 安装插件：

1. 点击 File 菜单，选择 Clone repository

2. 在弹窗中选择使用 URL 的 Clone 方式
3. 选择插件的安装目录，通常是你 ComfyUI 安装文件夹下的 custom_nodes 目录。在我的截图中，我将其设置为 D:\ComfyUI_windows_portable\ComfyUI\custom_nodes，也就是我的 ComfyUI 安装目录

你可能会看到 "This folder contains files. Git Can only clone empty folders" 这样的提示，不用在意。当我们输入 GitHub 仓库地址后，该提示会更新并消失

4. 在 URL 输入框中输入你想要安装的插件的 Git 仓库地址，例如 https://github.com/kijai/ComfyUI-Hunyuan3DWrapper。你会发现，随着我们输入地址，安装目录也会随之更新
5. 点击 Clone 按钮，等待安装完成

重新启动 ComfyUI，等待界面完成必要的依赖安装。至此就完成了插件安装。

使用 GitHub Desktop 更新插件

从上面的截图中可以看到，我使用 GitHub Desktop 安装了来自不同作者的几个 git 仓库

1. 点击位置 1 会打开使用 GitHub Desktop 安装的 git 仓库地址
2. 如果该插件有可用更新，你会看到像位置 2 那样的箭头提示
3. 点击对应的菜单，切换到该仓库，通常你会看到像位置 3 那样的更新提示。点击 Pull Origin 按钮即可完成插件更新

三、手动安装：从 ZIP 压缩包安装 ComfyUI 插件

首先，访问仓库地址：https://github.com/ltdrdata/ComfyUI-Manager

• 仓库通常会在 Readme 中提供安装说明，你可以按照说明进行安装

1. 点击页面上的绿色 <>code 按钮
2. 在弹出的窗口中点击 Download ZIP 按钮
3. 下载完成后，解压压缩包
4. 将解压后的文件夹复制到 comfyui/custom_nodes 插件目录
5. 重新启动 ComfyUI，检查插件是否安装成功

如果你想更新用这种方式安装的插件，只能重复手动安装的流程。

四、aaaki ComfyUI 启动器插件安装

1. 确保 ComfyUI 未在运行
2. 在 aaaki ComfyUI 启动器中，选择 版本管理\安装扩展（下图使用的是英文版界面）

3. 搜索或浏览找到你想要安装的插件，然后点击安装
4. 如果列表中没有你需要的插件，可以在该界面中使用 扩展 URL，在此处填入对应插件的 git 地址，即可通过 git 进行安装（类似于 Git 安装）

如何使用 aaaki ComfyUI 启动器更新插件

在同一个 版本管理\安装扩展 界面中，点击刷新即可让软件检测对应的 Git 仓库是否有更新。如果有更新，手动更新即可。

五、在中国使用 Gitee 克隆 GitHub 仓库

如果你身处中国，可能会因为 GitHub 访问问题导致安装失败。在这种情况下，你可以使用 Gitee 克隆对应的 GitHub 仓库，然后获取你所克隆仓库的地址，并通过前面提到的安装方法进行安装。

不过，这种方法的缺点也相当明显。由于它存储的是 GitHub 仓库的一份副本，你无法直接从上游 GitHub 仓库获取最新更新。每次需要更新插件时，你都需要先通过 Gitee 更新你的克隆仓库，然后再检查更新。

首先，你需要注册一个 Gitee 账号。Gitee 注册地址：https://gitee.com/

1. 注册完成之后，点击 +新建 按钮，选择创建仓库

2. 在新建仓库页面，选择 点击导入（Click to Import）选项

3. 在导入仓库页面，选择从 URL 导入

并填入对应的仓库地址链接，例如：

• https://github.com/ltdrdata/ComfyUI-Manager.git
• https://github.com/ltdrdata/ComfyUI-Manager

这两种格式都可以。

4. 填写完信息后点击导入

导入之后，对应的仓库就会被克隆到你的账号下。 之后如果你想更新插件代码，请记住需要先更新你的克隆仓库，然后才能获取上游的更新。

5. 位置 5 的按钮用于更新并同步上游仓库代码
6. 点击 克隆/下载 按钮，获取对应的仓库地址

7. 仓库地址如上图所示，你可以直接使用本文提到的其他安装方法进行安装

六、为 ComfyUI 自定义节点安装依赖项

完成节点安装后，为确保对应节点的功能正常运行，您还需要安装相关的依赖项。下面我将补充不同 ComfyUI 版本的依赖安装信息，以及针对中国等特殊地区的情况：在这些地区使用依赖安装指令时，可能需要使用国内镜像地址。

ComfyUI 便携版

便携版使用的是嵌入式 Python 版本，因此需要使用嵌入式 Python 来安装相应的依赖项。使用命令行进入便携版的插件目录：

cd E:/ComfyUI_windows_portable/

然后使用嵌入式 Python 安装依赖项：

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt

Python 虚拟环境

如果您为 ComfyUI 创建了自己的 Python 虚拟环境，则需要定位包含插件依赖文件所在的目录。例如，本文中我们安装了 ComfyUI-Manager 插件，因此需要找到其依赖文件所在的目录：

E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager/requirements.txt

然后使用 pip 指令安装依赖项：

pip install -r E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager/requirements.txt

使用中国国内镜像来源

对于中国大陆的用户，由于网络限制，从官方 PyPI 安装依赖时可能会遇到问题。您可以使用国内镜像来源来加快下载速度。只需在使用 pip 指令时添加 -i 参数来指定镜像来源：

# Using Tsinghua University mirror
pip install -r E:/ComfyUI_windows_portable/ComfyUI/custom_nodes/ComfyUI-Manager/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# For portable version
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

中国常用的镜像来源包括：

• 清华大学：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里云：https://mirrors.aliyun.com/pypi/simple/
• 中国科学技术大学（USTC）：https://pypi.mirrors.ustc.edu.cn/simple/