> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-linear-mode-interface-docs-53934.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 如何在 ComfyUI 中安装自定义节点
> 本部分将指导你如何使用不同的方式来进行 ComfyUI 自定义节点的安装
## 什么是自定义节点？
自定义节点是ComfyUI的扩展插件，能够增加新功能，如高级图像处理、机器学习微调、颜色调整等。这些节点由社区开发，可显著扩展ComfyUI的基础功能。
在安装自定义节点前，你有必要对自定义节点进行审查，由于 ComfyUI 是一个开源项目，也有可能存在恶意利用自定义节点进行攻击的插件
1. 请只安装来自可信作者和社区常用的自定义节点
2. 在安装前了解插件功能，避免安装不明来源的插件以确保系统安全
3. 避免安装冷门插件和来路不明的插件，未经审核的插件可能存在安全风险,进而导致你的电脑被黑客入侵。
## 安装自定义节点
所有的自定义节点安装都需要完成下面的两个步骤：
1. 克隆节点代码到 `ComfyUI/custom_nodes` 目录
2. 安装对应的 Python 依赖
在本文中我们将介绍三种安装方法，下面是对应的优缺点对比，由于目前 [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) 还未正式加入到核心依赖中，但在未来 ComfyUI Manager 将会成为核心依赖的一部分，但本部分的指南仍旧提供了其它安装插件的指南,以便满足你的需求。
| 方法 | 优点 | 缺点 |
| ------------------------ | ---------------------------------- | ---------------------------------------- |
| **ComfyUI Manager** (推荐) | 1. 自动化安装
2. 依赖处理
3. 图形界面 | 不在 registry 中注册的节点无法通过 Manager 直接搜索到 |
| **Git 克隆** | 可以安装不在 registry 中注册的节点 | 1. 需要Git知识
2. 手动处理依赖
3. 存在安装风险 |
| **代码仓库 ZIP 下载** | 1. 无需Git
2. 手动处理一切 | 1. 需要手动处理依赖
2. 无版本控制
3. 存在安装风险 |
提示： 在安装自定义节点前，请先查看插件的 README 文件，了解插件的安装方法和使用方法，有些插件有对特定的包和环境有要求，比如对应的模型、依赖的版本、常见问题解决等
### 方法一:ComfyUI Manager（推荐）
使用 ComfyUI Manager 安装自定义节点时，在列表中的自定义节点并不代表其是安全的，请在安装前了解其功能和作用，确保只安装可信插件和热门作者的自定义节点，否则将会给你的设备带来潜在风险
1. 如果有标记`⚠️`的节点，代表其可能与其它一些插件存在依赖冲突
2. 作者名称标注为`✅`的节点，代表对应作者在 Github 的活跃度
3. 对于插件可能存在的风险行为，会在列表中使用红色字段提醒，请在确保插件安全后再进行安装
找到需要安装的节点，点击`Install`按钮
在弹出的窗口中会要求选择版本：
* `nightly` 版本: 直接从 Github 下载最新源码，但在 `security_level` 为 `normal` 时，会提示当前的安全等级设置不允许下载该插件
* `latest` 或带数字的稳定版本（推荐）: 从 [https://registry.comfy.org/](https://registry.comfy.org/) 下载经过审查的代码，不会触发安全检查
`nightly` 版本通常是最新的版本，但因为它直接从 github 下载没有经过审查的版本，存在一定的代码风险，如果你一定需要安装`nightly`版本，请将 Manager 的 `security_level` 设置为 `weak`
对应配置文件路径为 `ComfyUI/user/default/ComfyUI-Manager/config.ini`,但请注意这并不是我们推荐的配置，请只临时使用这个配置
点击安装后 Manager 会自动完成依赖的安装，并会在安装完成后提示你重启 ComfyUI
重启后在 ComfyUI Manager 中检查对应的插件是否安装成功, 是否出现`import failed`的错误提示
### 方法二:使用 Git 进行安装手动安装
适用于Manager中找不到的新节点或需要特定版本时， 需要你的系统中已经安装好了 [Git](https://git-scm.com/)
在GitHub页面点击"Code"按钮复制HTTPS链接
```bash theme={null}
cd /path/to/ComfyUI/custom_nodes
```
```bash theme={null}
git clone [仓库URL]
```
安装依赖需要安装到对应的 ComfyUI 环境中，请注意不要混淆到你的系统环境， 否则可能会导致你的系统环境污染
在 Windows 便携版中， 依赖需要安装到对应的嵌入式 Python 环境中
```bash theme={null}
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\[节点目录名]\requirements.txt
```
在你的 ComfyUI 环境中安装依赖
```bash theme={null}
cd [节点目录名]
pip install -r requirements.txt
```
重启ComfyUI并刷新浏览器， 检查对应的插件是否安装成功, 在启动日志界面是否出现`import failed`的错误提示
### 方法三:ZIP下载安装
适用于无法使用 Git 或 Manager 安装的用户
我们不是非常推荐使用这种方式来进行安装，因为这种安装方式会丢失
在GitHub页面点击 `Code` → `Download ZIP`
解压ZIP文件
将解压后的文件夹复制到 `ComfyUI/custom_nodes/` 目录
重启ComfyUI并刷新浏览器
重启后在 ComfyUI Manager 中检查对应的插件是否安装成功, 是否出现`import failed`的错误提示
## 自定义节点资源
目前在 ComfyUI 中除了基础的节点扩展功能扩展之外，自定义节点还包括包括以下的扩展资源
* [节点文档](/zh-CN/custom-nodes/help_page): 这个功能支持所有的自定义节点和基础节点，你可以通过这个功能来查看节点文档，了解节点的作用和使用方法，你可以通过像作者PR来贡献对应的节点文档
* [自定义节点工作流模板](/zh-CN/custom-nodes/workflow_templates): 自定义节点的工作流模板，节点作者提供的示例工作流，可在 ComfyUI 的模板中浏览加载
* [多语言支持](/zh-CN/custom-nodes/i18n)
如果你是自定义节点作者，你可以添加对应的内容来让你的自定义节点使用更加友好