Linux 系统安装 ComfyUI 教程

⚠️ 重要提示： 安装步骤可能随 ComfyUI 的发展而变化。请始终查阅官方仓库获取最新信息。本指南反映的是 2025 年中期的最新实践。

ℹ️ 更新说明： 关于桌面版安装的最新信息，请查阅官方文档。

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

1. Comfy CLI（推荐） — 官方命令行工具，简化安装过程
2. 手动安装 — 对环境拥有完全控制权

Comfy Desktop：目前 Linux 尚未正式支持。请查看官方文档获取更新。

系统要求

• Python 3.12 或 3.13（推荐 3.13）
• NVIDIA GPU 支持 CUDA，建议 4GB 以上显存
• AMD GPU — 支持 ROCm 7.2（仅 Linux）
• Intel GPU — Arc 系列通过原生 PyTorch torch.xpu 支持
• 内存： 至少 8 GB，推荐 16 GB
• 存储： SSD，至少 20 GB 可用空间（最低要求——典型工作流的模型很容易占用 50–100 GB 以上）

Comfy CLI（推荐）

Comfy CLI 是官方命令行工具，可简化安装和管理。

第 1 步：确保 Python 环境

确保已安装 Python 3.12 或 3.13：

python3 --version

如果 Python 未安装或版本过旧：

sudo pacman -S python python-pip

第 2 步：安装 Comfy CLI

pip install comfy-cli

第 3 步：安装 ComfyUI

comfy install

该命令将下载并使用默认设置安装 ComfyUI。更多选项请参阅完整 Comfy CLI 指南。

第 4 步：启动 ComfyUI

comfy launch

在浏览器中访问 http://127.0.0.1:8188。

方法三：手动安装

第 1 步：安装依赖

安装系统依赖：

# Ubuntu/Debian
sudo apt update
sudo apt install git python3 python3-pip python3-venv -y

# 安装 NVIDIA GPU 依赖
# 确保已安装 NVIDIA 驱动和 CUDA 工具包

第 2 步：克隆仓库

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

第 3 步：创建虚拟环境

python3 -m venv .venv
source .venv/bin/activate

第 4 步：安装 GPU 和 ComfyUI 依赖

# 使用 CUDA 13.0 安装 PyTorch
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

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

# 使用 ROCm 支持安装 PyTorch
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

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

# 使用 Intel GPU 支持安装 PyTorch
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# Intel Arc 需要额外配置
# 参见：https://github.com/comfyanonymous/ComfyUI?tab=readme-ov-file#manual-install-windows-linux

第 5 步：启动 ComfyUI

python main.py

对于 AMD GPU 或仅 CPU 模式：

python main.py --cpu

更多启动选项，请参阅 ComfyUI 启动参数 指南。

第 6 步：访问界面

打开浏览器并访问 http://127.0.0.1:8188。

下一步

• 安装模型 — 添加 checkpoint 模型、LoRA 等
• 安装自定义节点 — 扩展 ComfyUI 功能
• ComfyUI 界面指南 — 学习界面基础