ComfyUI安装与配置指南：Windows/Mac/Linux全平台部署教程

# 访问ComfyUI官方GitHub发布页面
# https://github.com/comfyanonymous/ComfyUI/releases

# 下载最新的Windows便携版
# 文件名类似：ComfyUI_windows_portable.zip

# 1. 将下载的zip文件解压到目标目录
#    建议解压到D盘或E盘，避免C盘空间不足
#    例如：D:\ComfyUI\

# 2. 进入解压后的目录
cd D:\ComfyUI

# 3. 运行启动脚本
#    双击 run_nvidia_gpu.bat（NVIDIA显卡用户）
#    或双击 run_cpu.bat（仅CPU运行，速度极慢）

正在下载依赖...
Installing torch...
Installing torchvision...
Installing transformers...
...
ComfyUI已启动！
请在浏览器中打开: http://127.0.0.1:8188

# 1. 安装Git
# 下载地址：https://git-scm.com/download/win

# 2. 安装Python 3.10
# 下载地址：https://www.python.org/downloads/
# 安装时勾选 "Add Python to PATH"

# 3. 安装NVIDIA CUDA Toolkit（如果尚未安装）
# 下载地址：https://developer.nvidia.com/cuda-downloads
# 推荐 CUDA 12.1 或更高版本

# 打开命令提示符（CMD）或PowerShell

# 克隆ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git

# 进入目录
cd ComfyUI

# 创建并激活虚拟环境
python -m venv venv
venv\Scripts\activate

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

# 确保在虚拟环境中
venv\Scripts\activate

# 启动ComfyUI
python main.py

# 或指定监听地址和端口
python main.py --listen 0.0.0.0 --port 8188

# 安装Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Python 3.10
brew install [email protected]

# 验证安装
python3.10 --version

# 克隆ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

# 创建虚拟环境
python3.10 -m venv venv
source venv/bin/activate

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

# 安装PyTorch MPS版本
pip install torch torchvision torchaudio

# 激活虚拟环境
source venv/bin/activate

# 使用MPS加速启动
python main.py --device mps

# 浏览器打开 http://127.0.0.1:8188

# 安装Python
brew install [email protected]

# 克隆并安装
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
python3.10 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# CPU模式启动（Intel Mac没有GPU加速）
python main.py --device cpu

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装基础依赖
sudo apt install -y git python3 python3-venv python3-pip \
    libgl1 libglib2.0-0 libsm6 libxext6 libxrender-dev

# 安装NVIDIA驱动（如果尚未安装）
sudo apt install -y nvidia-driver-535
# 或安装最新版本
sudo ubuntu-drivers autoinstall

# 验证GPU
nvidia-smi

# 安装CUDA 12.1
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2204/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update
sudo apt install -y cuda-toolkit-12-1

# 配置环境变量
echo 'export PATH=/usr/local/cuda-12.1/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/local/cuda-12.1/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

# 验证CUDA
nvcc --version

# 克隆ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

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

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

# 启动
source venv/bin/activate
python main.py --listen 0.0.0.0 --port 8188

# 后台运行（使用nohup）
nohup python main.py --listen 0.0.0.0 --port 8188 > comfyui.log 2>&1 &

# 或使用screen/tmux
screen -S comfyui
python main.py --listen 0.0.0.0 --port 8188
# 按 Ctrl+A, D 分离会话

# Ubuntu/Debian
sudo apt install -y docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker

# 将当前用户加入docker组
sudo usermod -aG docker $USER
# 重新登录后生效

# 拉取ComfyUI官方Docker镜像
docker pull ghcr.io/ai-dock/comfyui:latest

# 运行ComfyUI容器
docker run -d \
    --name comfyui \
    --gpus all \
    -p 8188:8188 \
    -v /path/to/models:/app/ComfyUI/models \
    -v /path/to/output:/app/ComfyUI/output \
    ghcr.io/ai-dock/comfyui:latest

# 查看运行状态
docker ps

# 查看日志
docker logs comfyui

# docker-compose.yml
version: '3.8'

services:
  comfyui:
    image: ghcr.io/ai-dock/comfyui:latest
    container_name: comfyui
    ports:
      - "8188:8188"
    volumes:
      - ./models:/app/ComfyUI/models
      - ./output:/app/ComfyUI/output
      - ./input:/app/ComfyUI/input
      - ./custom_nodes:/app/ComfyUI/custom_nodes
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]
    restart: unless-stopped

# 启动
docker-compose up -d

# 停止
docker-compose down

# 查看日志
docker-compose logs -f

# 进入ComfyUI目录
cd ComfyUI

# 克隆ComfyUI-Manager
cd custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
cd ..

# 重启ComfyUI

# 查看已安装的插件
ls ComfyUI/custom_nodes/

# 更新所有插件
cd ComfyUI/custom_nodes
for dir in */; do
    if [ -d "$dir/.git" ]; then
        echo "更新 $dir"
        cd "$dir" && git pull && cd ..
    fi
done

# 备份插件列表
ls ComfyUI/custom_nodes/ > my_plugins_list.txt

# 批量安装插件（从列表）
while read plugin; do
    cd ComfyUI/custom_nodes
    git clone "$plugin"
done < plugins_to_install.txt

ComfyUI/
├── models/
│   ├── checkpoints/        # 主模型（SD 1.5、SDXL、Flux等）
│   ├── lora/               # LoRA模型
│   ├── controlnet/         # ControlNet模型
│   ├── ipadapter/          # IP-Adapter模型
│   ├── vae/                # VAE模型
│   ├── clip/               # CLIP模型
│   ├── embeddings/         # Embedding/Textual Inversion
│   ├── ultralytics/        # YOLO检测模型
│   ├── upscale_models/     # 超分辨率模型
│   └── style_models/       # 风格模型

# 创建目录
mkdir -p ComfyUI/models/checkpoints

# 下载SDXL Base 1.0
cd ComfyUI/models/checkpoints
wget https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_base_1.0.safetensors

# 下载SDXL Refiner 1.0
wget https://huggingface.co/stabilityai/stable-diffusion-xl-refiner-1.0/resolve/main/sd_xl_refiner_1.0.safetensors

# 下载SDXL ControlNet模型
mkdir -p ComfyUI/models/controlnet
cd ComfyUI/models/controlnet

# Canny边缘检测
wget https://huggingface.co/xinsir/controlnet-openpose-sdxl-1.0/resolve/main/controlnet-openpose-sdxl-1.0.safetensors

# OpenPose姿态
wget https://huggingface.co/xinsir/controlnet-canny-sdxl-1.0/resolve/main/controlnet-canny-sdxl-1.0.safetensors

# Depth深度
wget https://huggingface.co/diffusers/controlnet-depth-sdxl-1.0/resolve/main/diffusion_pytorch_model.safetensors

# 下载IP-Adapter Plus模型
mkdir -p ComfyUI/models/ipadapter
cd ComfyUI/models/ipadapter

# IP-Adapter Plus SDXL
wget https://huggingface.co/h94/IP-Adapter/resolve/main/sdxl_models/ip-adapter-plus_sdxl_vit-h.safetensors

# CLIP Vision模型（IP-Adapter需要）
mkdir -p ComfyUI/models/clip_vision
cd ComfyUI/models/clip_vision
wget https://huggingface.co/h94/IP-Adapter/resolve/main/models/image_encoder/model.safetensors

# 原因：GPU显存不足
# 解决方案1：使用低显存模式启动
python main.py --lowvram

# 解决方案2：使用CPU模式（速度极慢）
python main.py --device cpu

# 解决方案3：减小模型尺寸
# 使用SD 1.5模型代替SDXL（显存需求更低）

# 原因：缺少Python依赖
# 解决方案：重新安装依赖
pip install -r requirements.txt

# 如果是插件缺少依赖
cd custom_nodes/插件名称
pip install -r requirements.txt

# 原因：8188端口已被其他程序使用
# 解决方案：使用其他端口
python main.py --port 8189

# 或查看并关闭占用端口的程序
# Windows:
netstat -ano | findstr 8188
# Linux/Mac:
lsof -i :8188

# 安装xFormers
pip install xformers

# 启动时自动使用xFormers
# ComfyUI默认会检测并使用xFormers

# TensorRT可以显著提升推理速度
# 需要NVIDIA GPU和CUDA 11.8+

# 安装TensorRT
pip install tensorrt

# 在ComfyUI中使用TensorRT节点
# 通过ComfyUI-Manager安装 ComfyUI-TensorRT 插件

# 如果系统内存不足，可以增加虚拟内存
# 设置方法：
# 1. 右键"此电脑" → 属性 → 高级系统设置
# 2. 性能 → 设置 → 高级 → 虚拟内存 → 更改
# 3. 设置初始大小和最大大小为物理内存的1.5-2倍

# 设置Hugging Face镜像
export HF_ENDPOINT=https://hf-mirror.com

# 设置pip镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 使用GitHub镜像
git clone https://ghproxy.com/https://github.com/comfyanonymous/ComfyUI.git

# 或使用Gitee镜像（如果有）

添加节点：右键画布 → 选择节点类型
连接节点：从输出端口拖拽到输入端口
删除节点：选中节点 → 按 Delete 键
移动节点：左键拖拽节点
缩放画布：鼠标滚轮
平移画布：中键拖拽 / 空格+左键拖拽
保存工作流：Ctrl+S 或 菜单 → Save
加载工作流：菜单 → Load

Checkpoint Loader → CLIP Text Encode (正向/反向)
Empty Latent Image → KSampler
CLIP Text Encode (正向) → KSampler (positive)
CLIP Text Encode (反向) → KSampler (negative)
Checkpoint Loader → KSampler (model)
KSampler → VAE Decode
VAE Decode → Save Image
Checkpoint Loader → VAE Decode (vae)