插件安装指南

概述

插件管理指南

下图展示了常用插件和安装步骤：

这个图展示了： - ComfyUI-Manager: 插件管理器，必备插件 - ComfyUI-GGUF: 量化模型支持，低显存必备 - AnimateDiff: 动画生成插件 - IPAdapter: 图像提示插件 - VideoHelperSuite: 视频处理插件 - Impact-Pack: 功能扩展插件

安装方法

安装方法对比

graph TD
    A[插件安装] --> B[Manager安装]
    A --> C[手动安装]
    A --> D[脚本安装]

    B --> B1[简单方便]
    B --> B2[自动依赖]
    B --> B3[版本管理]

    C --> C1[灵活控制]
    C --> C2[自定义配置]
    C --> C3[手动依赖]

    D --> D1[批量安装]
    D --> D2[自动化]
    D --> D3[脚本控制]

    style A fill:#e1f5ff
    style B fill:#fff4e1
    style C fill:#ffe1f5
    style D fill:#e1ffe1

方法1: 使用ComfyUI-Manager安装

安装流程

graph TD
    A[打开ComfyUI] --> B[点击Manager]
    B --> C[点击Install]
    C --> D[搜索插件]
    D --> E[选择插件]
    E --> F[点击Install]
    F --> G[等待安装]
    G --> H[重启ComfyUI]

    style A fill:#e1ffe1
    style B fill:#fff4e1
    style C fill:#fff4e1
    style D fill:#fff4e1
    style E fill:#fff4e1
    style F fill:#fff4e1
    style G fill:#fff4e1
    style H fill:#e1ffe1

详细步骤

1. 启动ComfyUI
2. 在主界面找到"Manager"按钮
3. 点击打开Manager界面

1. 在搜索框输入插件名称
2. 或浏览插件列表
3. 查看插件信息

1. 选择要安装的插件
2. 点击"Install"按钮
3. 等待安装完成

1. 关闭ComfyUI
2. 重新启动ComfyUI
3. 验证插件安装

优点

• 简单方便
• 自动安装依赖
• 版本管理
• 一键更新

缺点

• 需要先安装Manager
• 部分插件可能不在列表中

方法2: 手动安装

安装流程

graph TD
    A[获取插件URL] --> B[克隆仓库]
    B --> C[安装依赖]
    C --> D[重启ComfyUI]
    D --> E[验证安装]

    style A fill:#e1ffe1
    style B fill:#fff4e1
    style C fill:#fff4e1
    style D fill:#fff4e1
    style E fill:#e1ffe1

详细步骤

1. 访问插件GitHub页面
2. 复制仓库URL

# 进入custom_nodes目录
cd ComfyUI/custom_nodes

# 克隆插件仓库
git clone https://github.com/username/plugin-name.git

# 或使用HTTPS
git clone https://github.com/username/plugin-name.git

# 进入插件目录
cd plugin-name

# 查看requirements.txt
cat requirements.txt

# 安装依赖
pip install -r requirements.txt

# 或手动安装
pip install package-name

1. 关闭ComfyUI
2. 重新启动ComfyUI
3. 验证插件安装

优点

• 灵活控制
• 支持所有插件
• 自定义配置

缺点

• 需要手动安装依赖
• 需要手动更新

方法3: 脚本安装

安装脚本

@echo off
echo Installing ComfyUI plugins...

cd custom_nodes

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

echo Installation complete!
pause

#!/bin/bash

echo "Installing ComfyUI plugins..."

cd custom_nodes

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

echo "Installation complete!"

使用方法

# Windows
install_plugins.bat

# Linux/Mac
chmod +x install_plugins.sh
./install_plugins.sh

插件目录结构

标准结构

ComfyUI/
├── custom_nodes/
│   ├── ComfyUI-Manager/
│   │   ├── __init__.py
│   │   ├── requirements.txt
│   │   └── ...
│   ├── ComfyUI-Impact-Pack/
│   │   ├── __init__.py
│   │   ├── requirements.txt
│   │   └── ...
│   └── ...
├── models/
├── input/
└── output/

依赖管理

依赖类型

graph TD
    A[插件依赖] --> B[Python依赖]
    A --> C[系统依赖]
    A --> D[模型依赖]

    B --> B1[PyTorch]
    B --> B2[NumPy]
    B --> B3[其他库]

    C --> C1[FFmpeg]
    C --> C2[Git]
    C --> C3[其他工具]

    D --> D1[主模型]
    D --> D2[LoRA]
    D --> D3[其他模型]

    style A fill:#e1f5ff
    style B fill:#fff4e1
    style C fill:#ffe1f5
    style D fill:#e1ffe1

安装依赖

# 安装requirements.txt
pip install -r requirements.txt

# 安装单个包
pip install package-name

# 指定版本
pip install package-name==1.0.0

# Ubuntu/Debian
sudo apt-get install ffmpeg git

# CentOS/RHEL
sudo yum install ffmpeg git

# macOS
brew install ffmpeg git

插件更新

更新方法

graph LR
    A[打开Manager] --> B[点击Update]
    B --> C[选择插件]
    C --> D[点击Update]
    D --> E[等待完成]
    E --> F[重启ComfyUI]

    style A fill:#e1ffe1
    style B fill:#fff4e1
    style C fill:#fff4e1
    style D fill:#fff4e1
    style E fill:#fff4e1
    style F fill:#fff4e1

# 进入插件目录
cd custom_nodes/plugin-name

# 拉取最新代码
git pull

# 更新依赖
pip install -r requirements.txt --upgrade

# 重启ComfyUI

插件卸载

卸载方法

1. 打开Manager
2. 点击"Manage"选项卡
3. 选择要卸载的插件
4. 点击"Uninstall"按钮
5. 确认卸载
6. 重启ComfyUI

# 删除插件目录
rm -rf custom_nodes/plugin-name

# 或在Windows中删除文件夹
# 重启ComfyUI

常见问题

Q1: 插件安装失败怎么办？

A: 检查网络连接，查看错误日志，尝试手动安装。

Q2: 依赖安装失败？

A: 升级pip，使用国内镜像，检查Python版本。

Q3: 插件不显示？

A: 重启ComfyUI，检查插件是否正确安装，查看日志。

Q4: 插件冲突怎么办？

A: 禁用冲突插件，更新插件版本，联系插件作者。

Q5: 如何回滚插件版本？

A: 使用git checkout回滚，或使用Manager的版本管理功能。

最佳实践

实践1: 使用Manager

推荐使用Manager安装和管理插件。

实践2: 备份配置

安装前备份ComfyUI配置。

实践3: 测试插件

安装新插件后先测试。

实践4: 定期更新

定期更新插件和依赖。

实践5: 文档记录

记录插件配置和使用方法。

故障排查

安装失败

graph TD
    A[安装失败] --> B[检查网络]
    A --> C[检查权限]
    A --> D[检查依赖]
    A --> E[检查日志]

    B --> B1[网络连接]
    B --> B2[代理设置]

    C --> C1[写入权限]
    C --> C2[管理员权限]

    D --> D1[Python版本]
    D --> D2[依赖版本]

    E --> E1[错误信息]
    E --> E2[日志文件]

    style A fill:#e1f5ff
    style B fill:#fff4e1
    style C fill:#ffe1f5
    style D fill:#e1ffe1
    style E fill:#e1ffe1

运行错误

• ImportError: 依赖未安装
• ModuleNotFoundError: 模块未找到
• AttributeError: 版本不兼容

1. 检查依赖是否安装
2. 检查Python版本
3. 更新插件版本
4. 查看错误日志

扩展阅读

• ComfyUI-Manager
• 常用插件推荐
• 插件使用教程

更新日志

• 2026-01-26: 初始版本创建