简单介绍如何在Debian上安装ComfyUI，使用的显卡为Tesla P4。

环境说明

  • 操作系统：Debian 13 Trixie (Linux)
  • 架构：amd64 (x86_64)
  • GPU: Tesla P4 (8GB)

准备

1. 检查 Python 版本

bash
1
python3 --version

2. 安装 python3-venv（如果没有）

bash
1
apt install python3.13-venv -y

安装步骤

1. 创建虚拟环境

bash
1
python3 -m venv /opt/python/comfyui/cfui

2. 克隆 ComfyUI 仓库

bash
1
git clone https://github.com/comfyanonymous/ComfyUI.git /opt/python/comfyui/ComfyUI

3. 安装依赖

bash
1
/opt/python/comfyui/cfui/bin/pip install -r /opt/python/comfyui/ComfyUI/requirements.txt

4. PyTorch 版本兼容性

如果使用旧版 GPU（如 Tesla P4，compute capability 6.1），默认安装的 PyTorch 2.10.0 需要 CUDA 7.0+，会导致 no kernel image is available for execution 错误。

需要降级 PyTorch 版本：

bash
12
/opt/python/comfyui/cfui/bin/pip uninstall torch torchvision torchaudio -y
/opt/python/comfyui/cfui/bin/pip install torch==2.6.0+cu118 torchvision==0.21.0+cu118 torchaudio==2.6.0+cu118 --index-url https://download.pytorch.org/whl/cu118

5. 安装 xFormers（可选，提升性能）

xFormers 可以加速注意力计算，推荐安装：

bash
12
/opt/python/comfyui/cfui/bin/pip install xformers --index-url https://download.pytorch.org/whl/cu118
/opt/python/comfyui/cfui/bin/pip install torchvision==0.22.1 torchaudio==2.7.1 --index-url https://download.pytorch.org/whl/cu118

启动 ComfyUI

基础启动（后台）

bash
1
nohup /opt/python/comfyui/cfui/bin/python /opt/python/comfyui/ComfyUI/main.py --listen 0.0.0.0 --port 8188 > /opt/python/comfyui/comfyui.log 2>&1 &

启动参数

参数 说明
--listen 监听地址，默认 127.0.0.1
--port 端口号，默认 8188
--cuda-device GPU设备ID，默认 0
--default-device 默认设备，可选 cuda, cpu

性能优化

显存优化模式

参数 说明 适用场景
--highvram 模型常驻显存 显存 >= 16GB
--normalvram 正常模式（默认） 显存 8-16GB
--lowvram 低显存模式 显存 < 8GB
--novram 不用显存 显存极小
--cpu 纯CPU模式 无GPU

精度优化

参数 说明
--fp16-unet UNet半精度
--fp16-vae VAE半精度
--fp16-text-enc 文本编码器半精度
--fp32-unet UNet全精度
--cpu-vae VAE放CPU运行（节省显存）

注意力机制优化

参数 说明
--use-split-cross-attention 分块交叉注意力（推荐）
--use-quad-cross-attention 四叉交叉注意力
--use-pytorch-cross-attention PyTorch原生注意力
--use-sage-attention Sage注意力
--use-flash-attention Flash注意力
--disable-xformers 禁用xformers

内存优化

参数 说明
--disable-xformers 禁用xformers（有时更稳定）
--disable-cuda-malloc 禁用CUDA内存分配器
--disable-smart-memory 禁用智能内存管理
--async-offload 异步卸载（需要指定streams数量）
--disable-async-offload 禁用异步卸载

缓存优化

参数 说明
--cache-lru LRU缓存
--cache-ram 内存缓存
--cache-none 无缓存

其他优化

参数 说明
--force-channels-last 强制channels_last内存格式
--preview-method 预览方法: none/auto/latent2rgb/taesd

当前配置（Tesla P4 8GB）

bash
1234
nohup /opt/python/comfyui/cfui/bin/python /opt/python/comfyui/ComfyUI/main.py \
  --listen 0.0.0.0 \
  --port 8188 \
  > /opt/python/comfyui/comfyui.log 2>&1 &

当前配置说明

  • xFormers: 已安装并启用 (0.0.31.post1)
  • PyTorch: 2.7.1+cu118
  • 注意力: xformers attention
  • 智能显存: 启用（async weight offloading）

当前运行状态

  • GPU: Tesla P4 (8GB VRAM)
  • PyTorch: 2.7.1+cu118
  • 显存模式: NORMAL_VRAM
  • 服务状态: 运行中 (端口 8188)

模型存放位置

模型目录: /opt/python/comfyui/ComfyUI/models/

目录 用途
checkpoints Checkpoint 模型
loras LoRA 模型
vae VAE 模型
upscale_models 超分模型
controlnet ControlNet 模型
diffusion_models 扩散模型
text_encoders 文本编码器
clip CLIP 模型
embeddings 词嵌入

常用命令

查看 ComfyUI 进程

bash
1
ps aux | grep main.py

检查服务是否启动

bash
1
curl -s -o /dev/null -w "%{http_code}" http://localhost:8188

返回 200 表示服务正常。

查看日志

bash
1
tail -f /opt/python/comfyui/comfyui.log

停止 ComfyUI

bash
1
pkill -f main.py