Skip to content
帮助构建更好的 ComfyUI 知识库 成为赞助者

如何在Linux上安装ComfyUI

在 Linux 上安装 ComfyUI 有两种主要方式:

  1. 使用 Comfy CLI 安装(推荐) - 最简单、最快速的方式
  2. 使用 ComfyUI 源码安装 - 传统的手动安装方式

本教程将详细介绍这两种安装方法,其中重点推荐使用 Comfy CLI 进行安装。

方法一:使用 Comfy CLI 安装 ComfyUI(推荐)

Comfy CLI 是 ComfyUI 官方提供的命令行工具,能够大大简化 ComfyUI 的安装和管理过程。

第一步:系统环境准备

1. 确保 Python 环境

ComfyUI 需要 Python 3.9 或更高版本。检查您的 Python 版本:

python3 --version 

如果系统没有安装 Python 或版本过低,请按照以下步骤安装:

Ubuntu/Debian 系统:

sudo apt update
sudo apt install python3 python3-pip python3-venv

CentOS/RHEL/Fedora 系统:

# CentOS/RHEL
sudo yum install python3 python3-pip
# 或者 Fedora
sudo dnf install python3 python3-pip

Arch Linux:

sudo pacman -S python python-pip

2. 安装 Git(如果未安装)

# Ubuntu/Debian
sudo apt install git
 
# CentOS/RHEL
sudo yum install git
 
# Fedora
sudo dnf install git
 
# Arch Linux
sudo pacman -S git

3. 创建虚拟环境(推荐)

使用虚拟环境可以避免包冲突问题:

# 创建名为 comfy-env 的虚拟环境
python3 -m venv comfy-env
 
# 激活虚拟环境
source comfy-env/bin/activate

注意: 每次使用 ComfyUI 前都需要激活虚拟环境。要退出虚拟环境,使用 deactivate 命令。

第二步:安装 Comfy CLI

在激活的虚拟环境中安装 comfy-cli:

pip install comfy-cli

配置命令行自动补全(可选)

为了获得更好的使用体验,可以启用命令行自动补全:

comfy --install-completion

第三步:安装 ComfyUI

使用 comfy-cli 安装 ComfyUI 非常简单,只需要一条命令:

comfy install

此命令将:

  • 下载并安装最新版本的 ComfyUI
  • 自动安装 ComfyUI-Manager(节点管理器)
  • 配置基本的项目结构

安装选项

您可以使用以下选项来自定义安装:

# 安装到默认位置 ~/comfy
comfy install
 
# 安装到指定目录
comfy --workspace=/path/to/your/workspace install
 
# 在当前目录操作已存在的 ComfyUI(主要用于更新)
comfy --here install
 
# 操作最近执行或安装的 ComfyUI
comfy --recent install
 
# 只安装 ComfyUI,不安装 ComfyUI-Manager
comfy install --skip-manager

检查安装路径

您可以使用以下命令检查当前工作空间:

# 检查默认工作空间
comfy which
 
# 检查指定选项的工作空间
comfy --recent which
comfy --here which

第四步:安装 GPU 支持

NVIDIA GPU(CUDA)

如果您使用 NVIDIA GPU,需要安装 CUDA 支持:

# 安装 PyTorch with CUDA 支持
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124

注意: 请根据您的 CUDA 版本选择对应的 PyTorch 版本。访问 PyTorch 官网 获取最新的安装命令。

AMD GPU(ROCm)

如果您使用 AMD GPU:

# 安装 PyTorch with ROCm 支持
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0

仅使用 CPU

如果只使用 CPU 运行:

# 安装 CPU 版本的 PyTorch
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

第五步:启动 ComfyUI

安装完成后,启动 ComfyUI:

comfy launch

默认情况下,ComfyUI 将在 http://localhost:8188 上运行。

常用启动选项

# 后台运行
comfy launch --background
 
# 指定监听地址和端口
comfy launch -- --listen 0.0.0.0 --port 8080
 
# 使用 CPU 模式
comfy launch -- --cpu
 
# 低显存模式
comfy launch -- --lowvram
 
# 停止后台运行的实例
comfy stop

方法二:使用 ComfyUI 源码安装

如果您更喜欢传统的安装方式,也可以直接从源码安装:

1. 克隆 ComfyUI 仓库

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

2. 创建虚拟环境

python3 -m venv venv
source venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

4. 安装 GPU 支持

根据您的 GPU 类型安装对应的 PyTorch 版本(参考上面的步骤)。

5. 启动 ComfyUI

python main.py

相关链接