v0.45.0 · GPL-3.0下载
首页/安装说明

comfyui安装 - 便携版解压与源码部署全流程

四种安装方式、源码部署命令、各平台后端参数与启动失败排查表。

01四种 comfyui安装 方式

按操作系统与动手能力选一种即可,四种方式共用同一套模型目录与工作流格式。

Windows 便携版(推荐)

从官方 Release 按显卡与架构选一个 .7z,解压到纯英文路径,双击 run_nvidia_gpu.bat(或对应 bat)即启动,无需装 Python。

桌面版 Desktop

下载安装包按向导装好,自动配置依赖与更新,带托盘图标,适合不想碰命令行的用户。

源码部署

git clone 仓库 → 建 venv → 装对应 PyTorch → pip install -r requirements.txt → python main.py,适合 Linux / macOS 与开发者。

Docker

用官方或社区镜像起容器,挂载 models 与 output 目录,适合服务器多卡与团队共用。

先说结论:Windows 用户想最快出图就用便携版,全程不需要命令行; macOS、Linux 或需要指定 PyTorch 版本的用户走源码部署。四条路径的最后一步都是打开 127.0.0.1:8188,界面与工作流文件完全通用。

02方式 A:Windows 便携版(最省事)

选包与核对

按显卡与架构在下载页选一个 .7z, 下载后按校验页比对该包的官方 SHA-256。comfyui安装 出问题有一半出在选错包或文件损坏。

解压

解压到 D:\ComfyUI\ 之类的纯英文短路径, 路径里有中文、空格或层级过深,容易在加载 PyTorch 时报错。解压需要预留 10–20GB 空间。

启动

NVIDIA 包双击 run_nvidia_gpu.bat;仅想试跑可用 run_cpu.bat。等控制台打印 To see the GUI go to: http://127.0.0.1:8188, 窗口不要关,它就是本地服务进程。

放模型并打开界面

把 .safetensors 放进 ComfyUI/models/checkpoints,用 Chrome / Edge 打开 127.0.0.1:8188, 在 Load Checkpoint 下拉框选到模型即安装完成。目录表见节点文档。

整合包里到底打包了什么、升级时哪些目录要搬,见便携版专页。

03方式 B:源码部署(Linux / macOS / 开发者)

git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
python3 -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
python main.py                    # 仅 CPU: python main.py --cpu

源码部署要点:Python 建议 3.10 – 3.13,PyTorch 按显卡选对应 CUDA / ROCm / XPU 轮子, Apple Silicon 走 MPS 后端;装完先运行一次让依赖自检,再打开界面。 低显存设备可加 --lowvram,纯 CPU 调试加 --cpu。 官方文档入口在 docs.comfy.org。

平台后端启动参数提示
NVIDIA 显卡CUDA默认即可;驱动旧可加 --lowvram
AMD 显卡ROCm(Linux)/ 专用便携包(Windows)按官方轮子安装对应 PyTorch
Intel ArcXPU安装 IPEX 相关依赖后再启动
Apple SiliconMPS用桌面版或源码,无需 CUDA
无独显CPUpython main.py --cpu,速度显著下降

04Docker 与桌面版

Docker 方式把 models、output、custom_nodes 三个目录挂到宿主机, 升级镜像时模型不会丢,适合服务器多卡与团队共用。桌面版 v0.9.4 则是标准安装包向导, 自动配置依赖、带托盘图标与更新检查,macOS 用户走这条路最省心。

无论哪种 comfyui安装 方式,模型目录结构与 comfyui工作流 JSON 格式都是一致的, 所以后期从便携版迁到源码部署,只需要把 models 与 user/default/workflows 拷过去。

05启动失败排查表

现象常见原因处理
双击 bat 闪退路径含中文/空格、解压不完整、杀毒删了 dll换纯英文短路径,重新解压,加白名单
No module named torch运行时目录被破坏或选错包重新解压;核对是否用了 ARM64 包
CUDA out of memory显存不足或分辨率/批量过大降分辨率、加 --lowvram、换 fp8 权重
模型下拉框为空权重没放进 checkpoints 目录按目录表放置后点刷新
8188 打不开服务未启动或端口被占用看控制台是否打印监听地址,必要时指定端口
界面空白 / 报错浏览器缓存或前端版本不匹配强刷缓存,换 Chrome / Edge,核对版本
导入工作流一片红缺自定义节点Manager 安装缺失节点,见工作流页

更多高频问题在常见问题页;硬件与架构匹配见系统要求页。 装好后直接从七步教程开始跑第一张图。