Skip to content
Follow me on X
•ComfyUI Wiki
安装指南1. 安装 ComfyUI1.4 Linux

Qwen-Image-Layered 发布 - 支持图像分层编辑的生成模型

2025/12/19

如何在Linux上安装ComfyUI

⚠️ 重要提示： 本文档可能不会随时保持最新。请优先参考 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 官网 获取最新的安装命令。

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 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 说明。

问题：ROCm 链接失效

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

  • 使用 ROCm 6.4 版本
  • 访问 PyTorch 官网 获取最新的安装命令

虚拟环境路径问题

问题：关闭 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

相关链接

1.3 Mac1.5 Run on Cloud