安装与配置 #

┌─────────────────────────────────────────────────────────────┐
│                    硬件要求对照表                            │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  最低配置：                                                  │
│  ├── GPU: NVIDIA GTX 1060 6GB                              │
│  ├── CPU: 4核心以上                                         │
│  ├── 内存: 8GB                                              │
│  └── 存储: 20GB SSD                                         │
│                                                             │
│  推荐配置：                                                  │
│  ├── GPU: NVIDIA RTX 3060 12GB 或更高                      │
│  ├── CPU: 8核心以上                                         │
│  ├── 内存: 16GB 以上                                        │
│  └── 存储: 100GB SSD                                        │
│                                                             │
│  理想配置：                                                  │
│  ├── GPU: NVIDIA RTX 4090 24GB                             │
│  ├── CPU: 16核心以上                                        │
│  ├── 内存: 32GB 以上                                        │
│  └── 存储: 500GB NVMe SSD                                   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

操作系统：
├── Windows 10/11（推荐）
├── Linux（Ubuntu 20.04+）
└── macOS（Apple Silicon）

Python 环境：
├── Python 3.9 - 3.11（推荐 3.10）
├── pip 包管理器
└── virtualenv（可选）

GPU 驱动：
├── NVIDIA 驱动（最新版本）
├── CUDA 11.8 或 12.x
└── cuDNN（可选，自动安装）

步骤 1：下载便携版
────────────────────────
1. 访问 ComfyUI GitHub 发布页
   https://github.com/comfyanonymous/ComfyUI/releases

2. 下载最新版本的便携包
   ComfyUI_windows_portable_nvidia_cu121_or_cpu.7z

3. 解压到目标目录
   建议路径不含中文和空格

步骤 2：目录结构
────────────────────────
ComfyUI_windows_portable/
├── ComfyUI/
│   ├── models/          # 模型目录
│   │   ├── checkpoints/ # 主模型
│   │   ├── lora/        # LoRA 模型
│   │   ├── controlnet/  # ControlNet
│   │   └── ...
│   ├── custom_nodes/    # 自定义节点
│   ├── input/           # 输入图像
│   └── output/          # 输出图像
├── python_embeded/      # 内置 Python
├── run_nvidia_gpu.bat   # NVIDIA GPU 启动
├── run_cpu.bat          # CPU 启动
└── update_comfyui.bat   # 更新脚本

步骤 3：启动 ComfyUI
────────────────────────
双击运行：
├── run_nvidia_gpu.bat（NVIDIA 显卡）
├── run_cpu.bat（无显卡/CPU 模式）

等待启动完成，浏览器自动打开：
http://127.0.0.1:8188

步骤 1：安装 Python
────────────────────────
# Windows: 从 python.org 下载安装
# 推荐版本: Python 3.10.x

# Linux/macOS:
# Ubuntu
sudo apt update
sudo apt install python3.10 python3.10-venv python3-pip

# macOS (使用 Homebrew)
brew install python@3.10

步骤 2：克隆仓库
────────────────────────
# 克隆 ComfyUI 仓库
git clone https://github.com/comfyanonymous/ComfyUI.git

# 进入目录
cd ComfyUI

步骤 3：创建虚拟环境
────────────────────────
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate

# Linux/macOS:
source venv/bin/activate

步骤 4：安装依赖
────────────────────────
# 升级 pip
pip install --upgrade pip

# 安装 PyTorch（GPU 版本）
# CUDA 12.1
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121

# CUDA 11.8
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

# CPU 版本
pip install torch torchvision torchaudio

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

步骤 5：启动 ComfyUI
────────────────────────
# 启动服务
python main.py

# 指定端口
python main.py --port 8188

# 监听所有网络接口
python main.py --listen 0.0.0.0

# 低显存模式
python main.py --lowvram

步骤 1：拉取镜像
────────────────────────
# 拉取官方镜像
docker pull comfyanonymous/comfyui:latest

步骤 2：运行容器
────────────────────────
# 基本运行
docker run -d \
  --name comfyui \
  --gpus all \
  -p 8188:8188 \
  -v ./models:/app/ComfyUI/models \
  -v ./output:/app/ComfyUI/output \
  comfyanonymous/comfyui

# 参数说明
--gpus all      # 使用所有 GPU
-p 8188:8188    # 端口映射
-v              # 挂载目录

ComfyUI/models/
├── checkpoints/        # 主模型文件
│   ├── sd_v1.5.safetensors
│   ├── sdxl_base.safetensors
│   └── ...
│
├── lora/               # LoRA 模型
│   ├── style_lora.safetensors
│   └── character_lora.safetensors
│
├── controlnet/         # ControlNet 模型
│   ├── control_v11p_sd15_canny.safetensors
│   └── ...
│
├── vae/                # VAE 模型
│   ├── vae-ft-mse.safetensors
│   └── ...
│
├── embeddings/         # 文本嵌入
│   ├── negative.safetensors
│   └── ...
│
├── ipadapter/          # IP-Adapter 模型
│
├── upscale_models/     # 放大模型
│   ├── RealESRGAN_x4plus.pth
│   └── ...
│
└── clip/               # CLIP 模型

SD 1.5 系列推荐：
├── v1-5-pruned-emaonly.safetensors（经典）
├── realisticVisionV51.safetensors（写实）
├── dreamshaper_8.safetensors（通用）
└── deliberate_v3.safetensors（艺术）

SDXL 系列推荐：
├── sd_xl_base_1.0.safetensors（官方）
├── sdxl_turbo.safetensors（快速）
└── juggernautXL_v9.safetensors（写实）

Flux 系列：
├── flux1-dev.safetensors（开发版）
└── flux1-schnell.safetensors（快速版）

官方来源：
├── Hugging Face（主要）
│   https://huggingface.co/stabilityai
│   https://huggingface.co/runwayml
│
├── Stability AI
│   https://stability.ai
│
└── Black Forest Labs（Flux）
    https://blackforestlabs.ai

社区来源：
├── Civitai（模型分享平台）
│   https://civitai.com
│
├── Hugging Face 社区
│   https://huggingface.co/models
│
└── LiblibAI（国内平台）
    https://www.liblib.art

步骤 1：进入自定义节点目录
────────────────────────
cd ComfyUI/custom_nodes

步骤 2：克隆 Manager 仓库
────────────────────────
git clone https://github.com/ltdrdata/ComfyUI-Manager.git

步骤 3：安装依赖
────────────────────────
cd ComfyUI-Manager
pip install -r requirements.txt

步骤 4：重启 ComfyUI
────────────────────────
重启后，界面右侧会出现 Manager 按钮

ComfyUI-Manager 功能：
├── 安装自定义节点
├── 更新节点
├── 禁用/启用节点
├── 安装缺失节点
├── 模型下载
└── 工作流分享

基本参数：
────────────────────────
--port 8188              # 指定端口
--listen 0.0.0.0         # 监听地址
--disable-xformers       # 禁用 xformers

显存管理：
────────────────────────
--lowvram                # 低显存模式（~4GB）
--novram                 # 极低显存模式
--highvram               # 高显存模式（默认）
--cpu                    # CPU 模式

性能优化：
────────────────────────
--xformers               # 启用 xformers（默认）
--pytorch-cross-attention # 使用 PyTorch 注意力
--force-fp16             # 强制 FP16
--force-fp32             # 强制 FP32

其他参数：
────────────────────────
--auto-launch            # 自动打开浏览器
--cuda-device 0          # 指定 GPU 设备
--output-directory PATH  # 输出目录

Windows (run_comfyui.bat):
────────────────────────
@echo off
cd /d %~dp0
call venv\Scripts\activate
python main.py --xformers --auto-launch
pause

Linux/macOS (run_comfyui.sh):
────────────────────────
#!/bin/bash
source venv/bin/activate
python main.py --xformers --auto-launch

根据显存大小选择模式：

24GB+ 显存：
├── 默认配置
├── 可运行 SDXL + ControlNet
└── 支持高分辨率

12-16GB 显存：
├── 默认配置或 --lowvram
├── SDXL 基本运行
└── 适度分辨率

8-12GB 显存：
├── --lowvram
├── SD 1.5 推荐
└── 标准 512 分辨率

4-8GB 显存：
├── --lowvram 或 --novram
├── SD 1.5
└── 较低分辨率

<4GB 显存：
├── --cpu 或云服务
└── 考虑 Colab

软件优化：
├── 使用 xformers（默认启用）
├── 更新 GPU 驱动
├── 使用最新 PyTorch
└── 定期更新 ComfyUI

硬件优化：
├── 确保 GPU 散热良好
├── 使用 SSD 存储
├── 足够的系统内存
└── 稳定的电源供应

工作流优化：
├── 合理设置分辨率
├── 优化采样步数
├── 使用高效采样器
└── 批量处理优化

错误信息：
CUDA out of memory
或
RuntimeError: CUDA error

解决方案：
1. 检查 GPU 驱动版本
2. 使用 --lowvram 参数
3. 降低生成分辨率
4. 关闭其他 GPU 程序

错误信息：
pip install 失败

解决方案：
1. 升级 pip
   pip install --upgrade pip

2. 使用国内镜像
   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 手动安装问题包
   pip install package_name --no-cache-dir

错误信息：
Model not found
或
Failed to load model

解决方案：
1. 检查模型文件位置
2. 确认文件格式正确
3. 检查文件完整性
4. 确认模型兼容性

错误信息：
Address already in use

解决方案：
1. 更换端口
   python main.py --port 8189

2. 查找并关闭占用进程
   # Windows
   netstat -ano | findstr :8188
   
   # Linux/macOS
   lsof -i :8188

安装验证步骤：
────────────────────────
□ ComfyUI 成功启动
□ 浏览器能访问界面
□ 能加载默认工作流
□ 能加载模型文件
□ 能成功生成图像
□ Manager 正常工作

基本测试流程：
1. 加载默认工作流
2. 选择一个模型
3. 输入简单提示词
4. 点击 Queue Prompt
5. 等待生成完成
6. 检查输出图像