ComfyUI多平台部署:Windows、Linux、macOS全攻略
【免费下载链接】ComfyUI 最强大且模块化的具有图形/节点界面的稳定扩散GUI。 项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI
你还在为AI绘图工具的复杂部署流程烦恼吗?ComfyUI作为最强大且模块化的稳定扩散GUI(图形用户界面),支持Windows、Linux和macOS三大主流操作系统。本文将带你一步步完成跨平台部署,从环境准备到启动运行,全程无需复杂编程知识,让你轻松开启AI创作之旅。读完本文,你将获得:全平台安装指南、常见问题解决方案、模型管理技巧以及性能优化建议。
关于ComfyUI
ComfyUI是一款基于节点/流程图界面的稳定扩散(Stable Diffusion)工具,支持SD1.x、SD2.x、SDXL、SD3等多种图像模型,以及视频、音频和3D模型生成。其核心优势在于模块化设计和灵活的工作流配置,允许用户通过拖拽节点构建复杂的AI生成 pipeline(管道)。
THE 0TH POSITION OF THE ORIGINAL IMAGE
项目结构遵循清晰的模块化设计,主要目录功能如下:
- 模型存储:models/ 目录包含checkpoints、VAE、LoRA等模型文件
- 核心代码:comfy/ 目录实现扩散模型、采样器等核心功能
- 节点定义:comfy_extras/ 提供各类扩展节点
- 配置文件:extra_model_paths.yaml.example 用于模型路径配置
部署准备
硬件要求
ComfyUI对硬件的最低要求如下:
- GPU:至少4GB显存(推荐8GB以上,支持NVIDIA、AMD、Intel、Apple Silicon)
- CPU:4核以上处理器
- 内存:8GB RAM(推荐16GB)
- 存储:至少20GB可用空间(含模型文件)
软件依赖
所有平台均需安装:
- Python 3.12或3.13(推荐3.13以获得最佳支持)
- Git(用于克隆仓库)
- 模型文件(可从官方渠道获取)
依赖列表详见 requirements.txt,核心依赖包括PyTorch、Transformers等AI框架。
Windows系统部署
方法一:桌面应用(推荐新手)
- 访问官方下载页面获取Windows桌面版
- 解压后双击
ComfyUI.exe即可启动 - 首次运行会自动下载必要组件
方法二:便携包安装
- 从发布页下载Windows便携包:
ComfyUI_windows_portable_nvidia.7z - 使用7-Zip解压到任意目录
- 将模型文件放入以下路径:
ComfyUI\models\checkpoints - 双击
run_nvidia_gpu.bat启动程序
方法三:手动安装
-
克隆仓库:
git clone https://gitcode.com/GitHub_Trending/co/ComfyUI cd ComfyUI -
创建虚拟环境:
python -m venv venv venv\Scripts\activate -
安装依赖(NVIDIA GPU):
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu129 pip install -r requirements.txt -
启动应用:
python main.py
Linux系统部署
支持的发行版
- Ubuntu 22.04+/Debian 12+
- Fedora 38+
- Arch Linux
NVIDIA GPU配置
-
安装Git和Python:
sudo apt update && sudo apt install git python3.13 python3.13-venv -
克隆仓库并创建环境:
git clone https://gitcode.com/GitHub_Trending/co/ComfyUI cd ComfyUI python3.13 -m venv venv source venv/bin/activate -
安装PyTorch(CUDA):
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu129 pip install -r requirements.txt -
启动服务:
python main.py --listen 0.0.0.0
AMD GPU配置(Linux专属)
-
安装ROCm驱动(以Ubuntu为例):
sudo apt install rocm-hip-sdk -
安装PyTorch(ROCm):
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 -
启动时可能需要指定GPU架构:
# RDNA2显卡(如RX 6700) HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py # RDNA3显卡(如RX 7600) HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py
macOS系统部署
Apple Silicon(M1/M2/M3)
-
安装Homebrew和依赖:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew install git python@3.13 -
克隆仓库并创建环境:
git clone https://gitcode.com/GitHub_Trending/co/ComfyUI cd ComfyUI python3 -m venv venv source venv/bin/activate -
安装PyTorch(支持Metal加速):
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cpu -
安装依赖并启动:
pip install -r requirements.txt python main.py
Intel芯片Mac
- 按照上述步骤克隆仓库
- 安装PyTorch(CPU版):
pip install torch torchvision torchaudio - 启动时添加
--cpu参数:python main.py --cpu
模型管理
模型存放路径
ComfyUI默认模型路径结构如下:
- 检查点模型:models/checkpoints/
- VAE模型:models/vae/
- LoRA模型:models/loras/
- ControlNet:models/controlnet/
多路径配置
通过extra_model_paths.yaml.example可配置多个模型目录:
-
复制示例文件并重命名:
cp extra_model_paths.yaml.example extra_model_paths.yaml -
编辑配置文件(以A1111兼容为例):
a111: base_path: D:/stable-diffusion-webui/ checkpoints: models/Stable-diffusion vae: models/VAE loras: models/Lora
启动与验证
基本启动命令
python main.py
启动后访问 http://127.0.0.1:8188 即可打开Web界面。
高级启动参数
| 参数 | 说明 |
|---|---|
--listen | 允许网络访问 |
--port 8888 | 更改端口号 |
--cpu | 强制CPU运行 |
--preview-method taesd | 启用高质量预览 |
--tls-keyfile key.pem | 启用HTTPS |
示例(远程访问+高质量预览):
python main.py --listen --preview-method taesd
验证部署
- 检查启动日志是否有错误
- 访问Web界面,拖放示例工作流JSON文件
- 点击"Queue Prompt"测试生成
常见问题解决
依赖冲突
若出现依赖错误,尝试:
pip uninstall torch
pip install -r requirements.txt --upgrade
GPU内存不足
- 降低生成图像分辨率
- 启用内存优化:
python main.py --lowvram
AMD显卡问题
Linux用户需确保ROCm版本匹配:
# 检查ROCm版本
rocminfo | grep "ROCm Version"
macOS性能优化
Apple Silicon用户可启用MPS加速:
python main.py --use-mps
性能优化建议
硬件加速
- NVIDIA:启用CUDA和TensorRT加速
- AMD:使用ROCm 6.4+并设置环境变量:
TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 - Apple:使用最新PyTorch nightly版本
软件优化
- 更新显卡驱动至最新版
- 使用虚拟环境隔离依赖
- 定期清理缓存:
rm -rf __pycache__
总结
ComfyUI提供了灵活的跨平台部署方案,从新手友好的桌面应用到开发者首选的手动安装,可满足不同用户需求。通过合理配置模型路径和启动参数,能在各类硬件上实现高效运行。
项目持续活跃开发,建议定期通过以下命令更新:
git pull
pip install -r requirements.txt --upgrade
更多高级功能和工作流示例,请参考官方文档。
祝你的AI创作之旅顺利!如有问题,可通过项目Discord或GitHub Issues寻求支持。
【免费下载链接】ComfyUI 最强大且模块化的具有图形/节点界面的稳定扩散GUI。 项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



