简单介绍如何在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