一句话定义
装 ComfyUI 有三条路：桌面版（图形安装器,最省心）、便携版（Windows 免安装 zip）、手动安装（git + Python 环境,最可控）——装完启动本地服务,浏览器打开 http://127.0.0.1:8188 即用。
为什么重要
安装是第一道劝退门槛:装错 Python 版本、模型放错盘、显卡驱动不兼容,都会让你还没见到画布就放弃。一次装对,后面所有章节顺畅。
前置知识
核心概念
三条安装途径对比：
| 途径 | 平台 | 特点 | 适合 |
|---|---|---|---|
| Desktop 桌面版 | Windows / macOS | 官方安装器,自带 Python 环境管理,自动装依赖 | 大多数个人用户 |
| 便携版 portable | Windows | 解压即用,run_nvidia_gpu.bat 一键启动 | 想快速开跑的 Windows 用户 |
| 手动安装 | 全平台/服务器 | git clone + venv + pip install -r requirements.txt,再 python main.py | Linux 服务器、需要自定义环境的进阶用户 |
硬件基线（2026 年时点的大致体验,供预期管理）：
| 硬件 | 体验 |
|---|---|
| NVIDIA ≥8GB 显存 | SD1.5/SDXL 流畅;Flux fp8 可跑但偏紧 |
| NVIDIA 12-24GB | 全家族模型舒适 |
| Apple Silicon(M 系列) | 统一内存够大即可跑,MPS 后端,速度约为同级 N 卡的一半 |
| AMD | Linux(ROCm) 可用;Windows 支持有限 |
| 纯 CPU | 能跑 SD1.5,一张图数分钟,只适合验证 |
原理与机制
ComfyUI 是一个 Python 服务:主进程加载模型进显存/内存,内置 HTTP 服务器(默认端口 8188)提供前端页面与 API。启动参数决定了资源策略:
--lowvram/--novram：显存不足时分层换入换出模型,变慢但不崩。--cpu：纯 CPU 推理(调试用)。--force-fp16：半精度,省显存(Mac 上通常需要)。--listen 0.0.0.0：允许局域网访问(注意安全,默认只监听本机)。
手动安装的关键步骤(macOS 为例):
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
python3.12 -m venv venv &;& source venv/bin/activate
pip install -r requirements.txt
python main.py模型目录是装完后的第二件事:所有模型按类型放进 ComfyUI/models/ 下的子目录(checkpoints、loras、vae、clip、unet、upscale_models、controlnet…),详见 模型文件与目录组织。
直观类比
桌面版像"一键装好的家电";手动安装像"买零件自己装"——前者省心,后者你能完全掌控(比如把模型目录指向另一块大硬盘)。
实例与案例
- 挂载已有模型库:编辑根目录
extra_model_paths.yaml,把 A1111 或其他安装的模型路径指过来,避免重复下载数十 GB:
a1111:
base_path: /path/to/stable-diffusion-webui/models
checkpoints: checkpoints
loras: Lora- 多机共享:在服务器手动安装并
--listen,局域网内其他设备浏览器访问即可,笔记本不需要显卡。
常见误区
- Python 版本过新/过旧:跟随官方 README 推荐的版本(通常 3.10-3.12 一带),最新版 Python 可能缺轮子。
- 下载模型随手放桌面:必须放
models/对应子目录,或用 extra_model_paths 指过去,否则加载器列表里永远是空的。 - 显存崩了就换电脑:先试
--lowvram、tiled 解码(见 性能优化与显存管理),8GB 卡其实能跑大部分工作流。 - 防火墙/杀软拦截 8188 端口:本地端口放行即可;除非显式
--listen,服务不会暴露到公网。
自测题
- 三种安装途径分别适合什么人?你的机器选哪条?
--lowvram的代价与收益是什么?- 想让 ComfyUI 直接使用另一个软件已下载的模型,该改哪个文件?
- ComfyUI 默认监听哪个地址和端口?为什么默认不对外开放?
参考答案
- 桌面版适合大众;便携版适合 Windows 快速上手;手动安装适合 Linux/服务器/进阶定制。按自身情况选择。
- 收益:显存不够也能跑;代价:模型分层换入换出,速度显著下降。
- 根目录
extra_model_paths.yaml,把外部模型库的 base_path 指过去并映射子目录。 - 默认
127.0.0.1:8188,只监听本机回环;加--listen才对局域网开放,避免未授权访问。
与其他知识点的关系
- 模型文件与目录组织 紧接着解决"模型从哪来、放哪里"。
- 性能优化与显存管理 深入显存与性能调优。
- 安全:不可信工作流与 pickle 风险 解释为什么不要用管理员权限、不要来路不明的 .pt。
延伸阅读
- 官方安装文档(各平台分册):docs.comfy.org
- 桌面版发布说明:blog.comfy.org