如何在Linux上安装ComfyUI

[安装指南](/zh/install "安装指南")[1. 安装 ComfyUI](/zh/install/install-comfyui "1. 安装 ComfyUI")1.4 Linux

### [Qwen-Image-Layered 发布 - 支持图像分层编辑的生成模型](/zh/news/2025-12-19-qwen-image-layered-release)

2025/12/19

# 如何在Linux上安装ComfyUI

> **⚠️ 重要提示：** 本文档可能不会随时保持最新。**请优先参考[ComfyUI 官方仓库文档](https://github.com/comfyanonymous/ComfyUI) 获取最新、最准确的安装说明**，特别是关于 AMD GPU 支持等特定配置的详细信息。官方文档是获取最新信息的最佳来源。

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

> **注意：** 请根据您的 CUDA 版本选择对应的 PyTorch 版本。访问 [PyTorch 官网](https://pytorch.org/get-started/locally/) 获取最新的安装命令。

#### 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 官网](https://pytorch.org/get-started/locally/) 查看最新的 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 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

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

## 故障排除

### AMD GPU 相关问题

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

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

**解决方案：**

1. **确认已安装正确的 ROCm 版本 PyTorch：**

python -c "import torch; print(torch.__version__)"

2. **检查是否在虚拟环境中：**

# 确保虚拟环境已激活
source comfy-env/bin/activate # 或您的虚拟环境路径

3. **对于非官方支持的 AMD 显卡，使用环境变量：**

# RDNA2 显卡
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py

# RDNA3 显卡
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py

4. **如果问题仍然存在，尝试使用 CPU 模式启动：**

python main.py --cpu

5. **参考官方文档：** 更多 AMD GPU 相关信息，请参考 [ComfyUI 官方仓库的 AMD GPU 说明](https://github.com/comfyanonymous/ComfyUI?tab=readme-ov-file#amd-gpus-linux)。

#### 问题：ROCm 链接失效

如果遇到 ROCm 6.0 链接失效的问题，请尝试：

* 使用 ROCm 6.4 版本
* 访问 [PyTorch 官网](https://pytorch.org/get-started/locally/) 获取最新的安装命令

### 虚拟环境路径问题

#### 问题：关闭 ComfyUI 后无法找到虚拟环境路径

**解决方案：**

1. **记住虚拟环境的完整路径：**

# 创建虚拟环境时，使用绝对路径或记住相对路径
cd ~/your-workspace
python3 -m venv comfy-env

2. **每次使用前激活虚拟环境：**

# 进入虚拟环境所在目录
cd ~/your-workspace
source comfy-env/bin/activate

3. **使用 comfy-cli 管理（推荐）：** comfy-cli 会自动管理虚拟环境，无需手动激活。

4. **创建启动脚本：**

# 创建 start-comfy.sh
#!/bin/bash
cd ~/your-workspace
source comfy-env/bin/activate
comfy launch

然后使用 `chmod +x start-comfy.sh` 添加执行权限。

### PyTorch 安装问题

#### 问题：PyTorch 下载被中断（Killed）

**解决方案：**

1. **增加系统交换空间（如果内存不足）**
2. **使用国内镜像源：**

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124

3. **分步安装：**

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

### 其他常见问题

#### 问题：权限错误

确保您对安装目录有写入权限：

# 检查权限
ls -la ~/comfy
# 如果需要，修改权限
chmod -R 755 ~/comfy

#### 问题：Python 版本不兼容

确保使用 Python 3.9 或更高版本：

python3 --version

## 相关链接

* [Comfy CLI 完整使用指南](/zh/install/install-comfyui/comfy-cli)
* [Comfy CLI GitHub 仓库](https://github.com/Comfy-Org/comfy-cli)
* [Comfy CLI 官方文档](https://docs.comfy.org/comfy-cli/getting-started)
* [ComfyUI 官方仓库](https://github.com/comfyanonymous/ComfyUI)
* [ComfyUI 官方 AMD GPU 说明](https://github.com/comfyanonymous/ComfyUI?tab=readme-ov-file#amd-gpus-linux)
* [PyTorch 安装指南](https://pytorch.org/get-started/locally/)

[1.3 Mac](/zh/install/install-comfyui/install-comfyui-on-mac "1.3 Mac")[1.5 Run on Cloud](/zh/install/install-comfyui/run-comfyui-on-cloud "1.5 Run on Cloud")

主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网