如何在Linux上安装ComfyUI

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

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

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

方法一：使用 Comfy CLI 安装 ComfyUI（推荐）

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

第一步：系统环境准备

1. 确保 Python 环境

ComfyUI 需要 Python 3.12 或更高版本（推荐使用 Python 3.13）。检查您的 Python 版本：

python3 --version

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

Ubuntu/Debian 系统：

sudo apt update

sudoaptinstallpython3python3-pippython3-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 --extra-index-url https://download.pytorch.org/whl/cu130

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

AMD GPU（ROCm）

如果您使用 AMD GPU，需要安装 ROCm 版本的 PyTorch。根据您的系统，可以尝试以下版本：

# 尝试 ROCm 6.4（推荐，如果 6.0 链接失效）

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4

# 或者尝试 ROCm 6.0

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0

注意：如果某个 ROCm 版本链接失效，请尝试其他版本。您也可以访问 PyTorch 官网 查看最新的 ROCm 安装命令。

对于不被 ROCm 官方支持的 AMD 显卡

如果您的 AMD 显卡不被 ROCm 官方支持（如 RX 6700、RX 6600、RX 7600 等），可以使用环境变量来强制启用支持：

对于 RDNA2 架构显卡（如 RX 6700、RX 6600 等）：

HSA_OVERRIDE_GFX_VERSION=10.3.0 comfy launch

对于 RDNA3 架构显卡（如 RX 7600 等）：

HSA_OVERRIDE_GFX_VERSION=11.0.0 comfy launch

如果使用源码安装方式，则使用：

# RDNA2 显卡

HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py

# RDNA3 显卡

HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py

AMD GPU 性能优化提示

在较新的 PyTorch 版本中，您可以尝试启用实验性的内存高效注意力机制来提升性能（RDNA3 显卡默认已启用）：

TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 comfy launch -- --use-pytorch-cross-attention

您也可以尝试设置以下环境变量，可能会提升速度（但首次运行会较慢）：

PYTORCH_TUNABLEOP_ENABLED=1 comfy launch

Intel GPU

如果您使用 Intel GPU：

# 安装支持 Intel XPU 的 PyTorch

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

仅使用 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 -- --listen 0.0.0.0 --port 8080

# 使用 CPU 模式

comfy launch -- --cpu

# 低显存模式

comfy launch -- --lowvram

# 超低显存模式

comfy launch -- --novram

注意：--background 参数在某些版本的 ComfyUI 中可能不再支持。如果需要后台运行，建议使用系统级工具如 nohup 或 screen。

方法二：使用 ComfyUI 源码安装

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

1. 克隆 ComfyUI 仓库

git clonehttps://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

如果使用 AMD GPU 且遇到问题，请参考上面的 AMD GPU 故障排除说明。

故障排除

AMD GPU 相关问题

问题：启动时提示找不到 NVIDIA 驱动

原因：即使安装了 ROCm 版本的 PyTorch，如果系统检测到 NVIDIA 驱动或配置不正确，仍可能出现此错误。

解决方案：