> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何在 ComfyUI 中安装自定义节点

> 本部分将指导你如何使用不同的方式来进行 ComfyUI 自定义节点的安装

## 什么是自定义节点？

自定义节点是ComfyUI的扩展插件，能够增加新功能，如高级图像处理、机器学习微调、颜色调整等。这些节点由社区开发，可显著扩展ComfyUI的基础功能。

<Warning>
  在安装自定义节点前，你有必要对自定义节点进行审查，由于 ComfyUI 是一个开源项目，也有可能存在恶意利用自定义节点进行攻击的插件

  1. 请只安装来自可信作者和社区常用的自定义节点
  2. 在安装前了解插件功能，避免安装不明来源的插件以确保系统安全
  3. 避免安装冷门插件和来路不明的插件，未经审核的插件可能存在安全风险,进而导致你的电脑被黑客入侵。
</Warning>

## 安装自定义节点

所有的自定义节点安装都需要完成下面的两个步骤：

1. 克隆节点代码到 `ComfyUI/custom_nodes` 目录
2. 安装对应的 Python 依赖

本文对比三种安装方式。**ComfyUI Manager** 在大多数当前 ComfyUI 发行版中已内置，可先阅读 [ComfyUI Manager 概述](/zh/manager/overview) 了解功能与启用方式。当节点不在注册表中或需要固定某一版本时，可使用 **Git 克隆** 或 **ZIP 下载**。

| 方法                       | 优点                                 | 缺点                                       |
| ------------------------ | ---------------------------------- | ---------------------------------------- |
| **ComfyUI Manager** (推荐) | 1. 自动化安装<br />2. 依赖处理<br />3. 图形界面 | 不在 registry 中注册的节点无法通过 Manager 直接搜索到     |
| **Git 克隆**               | 可以安装不在 registry 中注册的节点             | 1. 需要Git知识<br />2. 手动处理依赖<br />3. 存在安装风险 |
| **代码仓库 ZIP 下载**          | 1. 无需Git<br />2. 手动处理一切            | 1. 需要手动处理依赖<br />2. 无版本控制<br />3. 存在安装风险 |

提示： 在安装自定义节点前，请先查看插件的 README 文件，了解插件的安装方法和使用方法，有些插件有对特定的包和环境有要求，比如对应的模型、依赖的版本、常见问题解决等

### 方法一:ComfyUI Manager（推荐）

<Note>
  使用此方法前，请确认环境中已可用 ComfyUI Manager。若未看到或尚未启用，请先阅读 [ComfyUI Manager 概述](/zh/manager/overview)，并按 [安装指南](/zh/manager/install) 操作。
</Note>

ComfyUI Manager 提供了两种 UI 版本来管理自定义节点，请选择与你界面匹配的指南：

<Columns cols={2}>
  <Card title="新 UI（Desktop 用户默认启用）" icon="sparkles" href="/zh/manager/pack-management">
    新版节点管理界面，Desktop 用户默认启用。
  </Card>

  <Card title="传统 UI" icon="rectangle-history" href="/zh/manager/legacy-ui">
    经典的 Manager 界面，用于自定义节点的安装管理。
  </Card>
</Columns>

### 方法二：使用 Git 手动安装

适用于 Manager 中找不到的新节点或需要特定版本时， 需要你的系统中已经安装好了 [Git](https://git-scm.com/)

<Steps>
  <Step title="获取仓库URL">
    在GitHub页面点击"Code"按钮复制HTTPS链接
  </Step>

  <Step title="进入custom_nodes目录">
    ```bash theme={null}
    cd /path/to/ComfyUI/custom_nodes
    ```
  </Step>

  <Step title="克隆仓库">
    ```bash theme={null}
    git clone [仓库URL]
    ```
  </Step>

  <Step title="安装依赖">
    安装依赖需要安装到对应的 ComfyUI 环境中，请注意不要混淆到你的系统环境， 否则可能会导致你的系统环境污染

    <Tabs>
      <Tab title="Windows便携版">
        在 Windows 便携版中， 依赖需要安装到对应的嵌入式 Python 环境中

        ```bash theme={null}
        python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[节点目录名]\requirements.txt
        ```
      </Tab>

      <Tab title="手动安装">
        在你的 ComfyUI 环境中安装依赖

        ```bash theme={null}
        cd [节点目录名]
        pip install -r requirements.txt
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="重启ComfyUI并刷新浏览器">
    重启ComfyUI并刷新浏览器， 检查对应的插件是否安装成功, 在启动日志界面是否出现`import failed`的错误提示
  </Step>
</Steps>

### 方法三:ZIP下载安装（不推荐）

适用于无法使用 Git 或 Manager 安装的用户

<Warning>
  我们不是非常推荐使用这种方式来进行安装，因为这种安装方式会丢失 Git 版本控制能力，导致你无法进行后续的版本管理
</Warning>

<Steps>
  <Step title="在GitHub页面点击 `Code` → `Download ZIP`">
    在GitHub页面点击 `Code` → `Download ZIP`

    <img src="https://mintcdn.com/dripart-docs-recommend-assets-api/g5cr9KIJXlIfM-V4/images/installation/custom_nodes/install-custom-nodes-by-zip.jpg?fit=max&auto=format&n=g5cr9KIJXlIfM-V4&q=85&s=e55e92dfe95af6e05cbd2a1f4d7ac07f" alt="在GitHub页面点击 Code → Download ZIP" width="2000" height="1115" data-path="images/installation/custom_nodes/install-custom-nodes-by-zip.jpg" />
  </Step>

  <Step title="解压ZIP文件">
    解压ZIP文件
  </Step>

  <Step title="将解压后的文件夹复制到 `ComfyUI/custom_nodes/` 目录">
    将解压后的文件夹复制到 `ComfyUI/custom_nodes/` 目录
  </Step>

  <Step title="手动安装依赖项（同Git方法的第4步）">
    重启ComfyUI并刷新浏览器
  </Step>

  <Step title="检查插件是否安装成功">
    重启后在 ComfyUI Manager 中检查对应的插件是否安装成功, 是否出现`import failed`的错误提示
  </Step>
</Steps>

## 自定义节点资源

目前在 ComfyUI 中除了基础的节点扩展功能扩展之外，自定义节点还包括包括以下的扩展资源

* [节点文档](/zh/custom-nodes/help_page): 这个功能支持所有的自定义节点和基础节点，你可以通过这个功能来查看节点文档，了解节点的作用和使用方法，你可以通过像作者PR来贡献对应的节点文档
* [自定义节点工作流模板](/zh/custom-nodes/workflow_templates): 自定义节点的工作流模板，节点作者提供的示例工作流，可在 ComfyUI 的模板中浏览加载
* [多语言支持](/zh/custom-nodes/i18n)

如果你是自定义节点作者，你可以添加对应的内容来让你的自定义节点使用更加友好