最近在折腾 Stable Diffusion 时,你是否也厌倦了 WebUI 的界面,想尝试更灵活、更强大的节点式工作流?ComfyUI 无疑是当前最热门的进阶选择。然而,从零开始配置 Python 环境、安装 PyTorch、处理 CUDA 版本冲突、下载各种模型和插件……这一系列操作足以劝退大部分新手和急于体验的开发者。
好消息是,国内大神“秋叶aaaki”发布了最新的ComfyUI V17 中文整合包,它完美解决了上述所有痛点。这个整合包不仅支持从 30 系到 50 系的 NVIDIA 显卡,还提供了 Windows 和 macOS 的一键安装方案,内置了大量常用插件和模型,开箱即用。本文将为你带来这份整合包的超详细安装、配置与上手教程,无论你是 Windows 用户还是 Mac 用户,都能快速踏上 ComfyUI 的创作之旅。
1. ComfyUI 与秋叶整合包:为什么是更好的选择?
在深入安装步骤之前,我们有必要先理解 ComfyUI 是什么,以及为什么秋叶整合包如此受欢迎。
1.1 什么是 ComfyUI?
ComfyUI 是一个基于节点(Node)的 Stable Diffusion 图形用户界面(GUI)。与 Automatic1111 的 WebUI 不同,它将 AI 图像生成的每一步——如加载模型、编写提示词、设置采样器、后期处理等——都抽象为一个个可连接、可配置的“节点”。你可以像搭积木一样,通过连接这些节点来构建复杂且可复现的工作流。
核心优势:
- 可视化与可解释性:每一步操作都清晰可见,你能精确理解图像是如何被“计算”出来的。
- 工作流可保存与分享:你可以将搭建好的节点流程图保存为
.json或.png文件,与他人分享。别人导入后,能完全复现你的生成过程,包括所有参数。 - 更高的灵活性与控制力:可以实现更复杂的多步处理,如区域重绘、多模型混合、条件控制等,是进阶玩家和商业创作的利器。
- 资源占用相对友好:由于其异步执行和更精细的控制,在某些场景下内存和显存的使用效率更高。
1.2 为什么选择秋叶 ComfyUI 整合包?
官方 ComfyUI 只是一个纯净的框架,需要用户自行解决所有依赖和环境问题。秋叶整合包的出现,极大地降低了使用门槛:
- 一键安装,开箱即用:整合了 Python、PyTorch、CUDA/cuDNN(Windows)、依赖库等所有运行环境,无需手动配置。
- 预置丰富资源:
- 插件:内置了众多实用插件,如
ComfyUI-Manager(插件管理器)、Impact Pack(功能增强节点包)、ControlNet预处理器节点等。 - 模型:通常包含基础模型如
SDXL、SD1.5,以及一些常用的 LoRA、VAE,省去大量下载时间。 - 中文优化:对界面进行了汉化,对国内用户更友好。
- 插件:内置了众多实用插件,如
- 多平台与多显卡支持:明确支持 Windows 和 macOS 系统,并对 NVIDIA 30系、40系、50系显卡进行了适配和测试。
- 持续更新与社区支持:秋叶团队会跟随 ComfyUI 官方版本和重要插件进行更新,修复已知问题,并有活跃的社区可供交流求助。
对于绝大多数想要快速体验 ComfyUI 强大功能的用户来说,使用整合包是最高效、最省心的选择。
2. 安装前准备:系统与硬件要求
在下载安装包之前,请确保你的设备满足以下基本要求。
2.1 硬件要求
- 操作系统:Windows 10/11 64位,或 macOS(建议 Monterey 12.0 或更高版本)。
- 处理器(CPU):建议 Intel Core i5 或 AMD Ryzen 5 及以上。
- 内存(RAM):最低 8GB,建议 16GB 或以上。处理高分辨率图像或复杂工作流时,内存越大越好。
- 显卡(GPU):
- NVIDIA 显卡(Windows/macOS):这是最佳体验的选择。整合包针对以下系列进行了优化:
- 30 系列:RTX 3050, 3060, 3070, 3080, 3090 等。
- 40 系列:RTX 4050, 4060, 4070, 4080, 4090 等。
- 50 系列:新发布的 RTX 50 系列显卡。
- Apple Silicon Mac(macOS):支持 M1, M2, M3 系列芯片,通过 Apple 的 Metal Performance Shaders (MPS) 进行加速。
- AMD 显卡 / Intel 核显:理论上可以通过 CPU 或 DirectML(Windows)模式运行,但速度会非常慢,且可能遇到兼容性问题。整合包主要优化了 NVIDIA CUDA 和 Apple MPS 路径。
- NVIDIA 显卡(Windows/macOS):这是最佳体验的选择。整合包针对以下系列进行了优化:
- 存储空间:至少需要20GB 的可用硬盘空间。如果你计划下载更多大模型(每个模型约 2-7GB),则需要预留 50-100GB 或更多空间。建议安装在 SSD 上以提升加载速度。
2.2 软件与驱动准备
- Windows 用户:
- 确保系统已安装最新的显卡驱动。可以前往 NVIDIA 官网 下载 Game Ready 或 Studio 驱动。
- 关闭所有杀毒软件和 Windows Defender 的实时保护(仅限安装过程),防止误删文件或阻止脚本运行。安装完成后可重新开启。
- macOS 用户:
- 确保系统已更新到较新的版本(如 Sonoma, Ventura, Monterey)。
- 对于 Apple Silicon Mac,系统已内置所需框架,无需额外安装驱动。
3. 秋叶 ComfyUI V17 整合包下载与安装
这是最核心的一步,我们将分 Windows 和 macOS 两个平台详细讲解。
3.1 获取整合包
由于版权和分发原因,整合包通常通过网盘分享。你可以通过搜索“秋叶 ComfyUI 整合包 V17”在相关论坛、视频教程描述或公众号中找到下载链接(常见于百度网盘或123云盘)。
重要提示:下载时请认准“秋叶aaaki”发布的版本,注意核对文件大小和发布日期,避免下载到旧版或带有恶意软件的包。V17 版本通常是一个大小为 10-20GB 的压缩包(如comfyui_v17_秋叶整合包.7z或.zip)。
3.2 Windows 系统安装步骤
假设你已下载好整合包压缩文件。
步骤 1:解压文件
- 使用解压软件(如 7-Zip、Bandizip)将下载的压缩包解压到你希望安装的目录。路径中不要包含中文或特殊字符,例如可以解压到
D:\AI\ComfyUI。 - 解压完成后,目录结构应类似下图:
ComfyUI_windows/ ├── ComfyUI/ # ComfyUI 主程序目录 ├── python_embeded/ # 内置的 Python 环境 ├── 启动器/ # 秋叶开发的图形化启动器 ├── 更新/ # 更新脚本和说明 ├── 依赖/ # 可能需要的额外依赖 └── 启动脚本.bat # 传统的命令行启动脚本
步骤 2:运行启动器(推荐)
- 进入
启动器文件夹,双击运行A启动器.exe。 - 首次运行,启动器可能会进行一些初始化操作,如检查环境、下载必要组件等,请保持网络通畅。
- 启动器界面通常包含以下功能:
- 一键启动:点击后自动启动 ComfyUI 服务。
- 高级选项:可设置监听端口(默认 8188)、是否开放公网访问、显存优化策略等。
- 插件管理:方便地安装、更新、禁用插件。
- 模型管理:快速下载或切换基础模型、VAE、LoRA等。
- 版本更新:一键更新整合包到最新版本。
步骤 3:启动 ComfyUI
- 在启动器中,直接点击“一键启动”按钮。
- 会弹出一个命令行窗口,开始加载模型和插件。首次启动时间较长,因为需要初始化环境和加载内置模型,请耐心等待,直到看到类似以下输出:
... Starting server To see the GUI go to: http://127.0.0.1:8188 - 此时,打开你的浏览器(Chrome/Firefox/Edge 等),访问
http://127.0.0.1:8188,即可看到 ComfyUI 的节点式界面。
步骤 4(备选):使用传统脚本启动如果启动器遇到问题,可以退回使用传统方式:
- 返回整合包根目录,双击
启动脚本.bat。 - 同样等待命令行输出完成,在浏览器中访问
http://127.0.0.1:8188。
3.3 macOS 系统安装步骤
macOS 版本的整合包结构与 Windows 类似,但启动方式不同。
步骤 1:解压文件
- 将下载的
.dmg或.zip文件解压到“应用程序”文件夹或你指定的位置(如~/Applications/)。 - 确保路径无中文。
步骤 2:启动 ComfyUI
- 找到解压后的文件夹,其中应包含一个名为
启动ComfyUI或Start ComfyUI的应用程序/脚本。 - 首次运行时,系统可能会提示“无法打开,因为来自不受信任的开发者”。解决方法:
- 在
访达中右键点击该应用,选择打开,然后在弹出的对话框中再次点击打开。 - 或者,进入
系统设置 -> 隐私与安全性,在“安全性”部分找到相关提示,点击仍要打开。
- 在
- 双击运行启动脚本。会打开一个终端窗口,开始加载。
- 等待终端输出
To see the GUI go to: http://127.0.0.1:8188后,用浏览器访问该地址。
对于 Apple Silicon Mac (M1/M2/M3):整合包通常已配置为使用MPS (Metal Performance Shaders)后端,这能充分利用 Apple 芯片的 GPU 性能。你可以在启动脚本或 ComfyUI 的设置中确认是否启用了 MPS。
4. 首次运行与基础配置
成功打开浏览器界面后,我们进行一些必要的初始配置。
4.1 界面初识与汉化
- 界面布局:中间大片空白区域是“画布”,用于拖放和连接节点。左侧是节点选择菜单。
- 启用中文:秋叶整合包通常预装了汉化。如果界面仍是英文,可以:
- 在画布空白处右键,选择
Add Node->utils->Install Custom Nodes(或类似选项)。 - 搜索并安装
ComfyUI-CN或Chinese-Localization插件(具体名称以整合包内插件列表为准)。 - 安装后,在界面设置中切换语言。
- 在画布空白处右键,选择
4.2 安装 ComfyUI Manager(插件管理器)
这是最重要的插件,它让你能轻松浏览、安装、更新其他插件。
- 如果左侧节点列表里没有
Manager相关节点,说明需要安装。 - 点击界面右上角的
Manager按钮(如果已安装),或者按照以下命令手动安装(适用于高级用户):- 打开终端,进入你的 ComfyUI 安装目录下的
custom_nodes文件夹。 - 执行:
git clone https://github.com/ltdrdata/ComfyUI-Manager.git - 重启 ComfyUI。
- 打开终端,进入你的 ComfyUI 安装目录下的
- 安装成功后,
Manager按钮会出现在右上角,点击可以打开管理器界面,在这里可以搜索、安装、更新插件。
4.3 配置模型路径
整合包可能已经预置了模型,但你可能想使用自己已有的 Stable Diffusion 模型(如从 WebUI 迁移过来)。
- 找到 ComfyUI 目录下的
models文件夹,其子目录结构如下:models/ ├── checkpoints/ # 放置 Stable Diffusion 大模型 (.safetensors, .ckpt) ├── vae/ # 放置 VAE 模型 ├── loras/ # 放置 LoRA 模型 ├── controlnet/ # 放置 ControlNet 模型 ├── upscale_models/ # 放置超分辨率模型 (如 ESRGAN) └── ... # 其他类型模型目录 - 将你已有的模型文件,分别放入对应的文件夹。例如,把
xxx.safetensors放入checkpoints。 - 回到浏览器界面,点击节点菜单中的
Load Checkpoint节点,在下拉列表中应该就能看到你刚放入的模型了。
5. 创建你的第一个工作流:文生图
让我们通过构建一个最简单的文生图工作流,来熟悉 ComfyUI 的基本操作。
5.1 清空画布与添加节点
- 如果画布上有默认的工作流,可以按
Ctrl+A全选,然后按Delete键删除。 - 我们需要的核心节点:
Load Checkpoint:加载大模型。CLIP Text Encode (Prompt):编写正面提示词。CLIP Text Encode (Negative):编写负面提示词。Empty Latent Image:设置生成图像的初始尺寸和批次。KSampler:采样器,是图像生成的核心。VAE Decode:将采样后的潜空间数据解码为最终图像。Save Image:保存图像。
5.2 连接节点与配置参数
添加并连接节点:
- 右键画布 ->
Add Node->loaders->Load Checkpoint。 - 同样方式添加两个
CLIP Text Encode节点(来自conditioning类别)。 - 添加
Empty Latent Image(来自latent类别)。 - 添加
KSampler(来自sampling类别)。 - 添加
VAE Decode(来自latent类别)。 - 添加
Save Image(来自image类别)。
- 右键画布 ->
连接节点(用鼠标从一个节点的输出点拖到另一个节点的输入点):
Load Checkpoint的MODEL输出 →KSampler的model输入。Load Checkpoint的CLIP输出 → 两个CLIP Text Encode节点的clip输入。Load Checkpoint的VAE输出 →VAE Decode的vae输入。CLIP Text Encode (正面)的CONDITIONING输出 →KSampler的positive输入。CLIP Text Encode (负面)的CONDITIONING输出 →KSampler的negative输入。Empty Latent Image的LATENT输出 →KSampler的latent_image输入。KSampler的LATENT输出 →VAE Decode的samples输入。VAE Decode的IMAGE输出 →Save Image的images输入。
配置参数:
- 在
Load Checkpoint节点,选择你想要使用的大模型。 - 在两个
CLIP Text Encode节点中,分别输入正面提示词(如masterpiece, best quality, 1girl, in the forest)和负面提示词(如lowres, bad anatomy, worst quality)。 - 在
Empty Latent Image节点,设置width和height(如 512x512 或 1024x1024)。batch_size设为 1。 - 在
KSampler节点,设置以下关键参数:seed: 随机种子,可以固定一个数字以便复现。steps: 采样步数,如 20-30。cfg: 提示词相关性,如 7-8。sampler_name: 选择采样器,如euler、dpmpp_2m。scheduler: 选择调度器,如normal、karras。
- 在
5.3 生成与保存
- 点击画布右下角的
Queue Prompt按钮,开始生成。 - 右侧会显示生成进度。完成后,生成的图片会显示在
Save Image节点上,并自动保存到 ComfyUI 输出目录(通常是ComfyUI/output文件夹下以日期命名的子文件夹中)。 - 保存工作流:点击界面右上角的
Save按钮,可以将当前节点布局和所有参数保存为一个.json文件,方便日后调用或分享。
6. 常见问题与故障排除 (FAQ)
在安装和使用过程中,你可能会遇到以下问题。
6.1 安装与启动问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 启动器闪退或报错 | 1. 路径包含中文/空格。 2. 杀毒软件拦截。 3. 运行库缺失(Windows)。 | 1. 将整合包移动到纯英文路径。 2. 暂时关闭杀毒软件,或将安装目录加入白名单。 3. 安装 Visual C++ Redistributable 等运行库。 |
访问http://127.0.0.1:8188无响应 | 1. ComfyUI 服务未成功启动。 2. 端口被占用。 | 1. 检查命令行窗口是否有错误日志。首次启动加载模型很慢,请多等几分钟。 2. 在启动器“高级选项”中修改端口号(如 8189),然后重启。 |
启动时提示CUDA out of memory | 显存不足。 | 1. 在启动器“高级选项”中启用--lowvram或--medvram模式。2. 生成时降低图像分辨率或 batch_size。3. 关闭其他占用显存的程序。 |
| macOS 提示“无法打开” | 安全策略限制。 | 按照上文 3.3 节的步骤,在“隐私与安全性”中允许运行。 |
6.2 运行与生成问题
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 节点菜单是空的或缺少节点 | 1. 插件未正确加载。 2. 浏览器缓存问题。 | 1. 重启 ComfyUI。 2. 按 Ctrl+F5强制刷新浏览器页面。3. 通过 ComfyUI Manager 检查插件状态。 |
| 加载模型时报错 | 1. 模型文件损坏。 2. 模型类型放错了文件夹。 3. 模型与当前 ComfyUI 版本不兼容。 | 1. 重新下载模型文件。 2. 检查模型是否放入了正确的 models子目录。3. 尝试使用整合包自带的模型测试。 |
| 生成图片全黑或全灰 | VAE 未正确连接或选择。 | 确保Load Checkpoint节点的VAE输出连接到了VAE Decode节点。也可以尝试单独加载一个 VAE 模型并连接。 |
| 生成速度极慢(非 NVIDIA/Apple GPU) | 正在使用 CPU 模式运行。 | AMD/Intel 显卡在 Windows 上可尝试安装 DirectML 版本的 PyTorch,但这需要手动配置环境,整合包可能未包含。建议使用 NVIDIA 显卡以获得最佳体验。 |
6.3 插件与模型管理问题
- 如何安装新插件?使用ComfyUI Manager。打开 Manager,在“Install Custom Nodes”标签页搜索插件名,点击 Install 即可。安装后需要重启 ComfyUI。
- 如何更新整合包?使用启动器内的“更新”功能,或查看整合包根目录下
更新文件夹内的说明。更新前务必备份你的models文件夹和重要的工作流文件。 - 模型应该去哪里下载?常用的模型下载站有 Civitai、Hugging Face。下载时注意模型类型(Checkpoint, LoRA, VAE, ControlNet等),并放入对应的文件夹。
7. 进阶技巧与最佳实践
当你熟悉基础操作后,这些技巧能提升你的效率和作品质量。
7.1 工作流管理与分享
- 使用模板:将常用的、稳定的工作流保存为
.json模板。新建项目时直接加载模板,在其基础上修改。 - 模块化:将复杂工作流中重复的部分(如一组固定的 LoRA 应用节点、高清修复节点组)保存为“自定义节点组”,方便复用。
- 分享与导入:ComfyUI 工作流可以保存为
.png图片(内嵌了工作流数据)。你可以直接将别人分享的.png图片拖入 ComfyUI 画布,即可自动还原整个工作流,这是其最强大的特性之一。
7.2 性能优化
- 显存优化:
- 在启动参数中添加
--lowvram或--medvram。 - 使用
TAESD等轻量级 VAE 解码器加速预览。 - 及时清理不用的节点,复杂工作流可以分步执行。
- 在启动参数中添加
- 生成速度:
- 使用更快的采样器,如
euler、dpmpp_2m_sde_gpu。 - 适当减少采样步数(20-30 步通常足够)。
- 考虑使用
LCM或Turbo等快速生成本地模型。
- 使用更快的采样器,如
7.3 资源整理与维护
- 模型分类:在
models各子目录下,建立更细分的文件夹,如checkpoints/portrait/,loras/clothing/,便于管理。 - 定期清理:
ComfyUI/temp和ComfyUI/output文件夹可能会积累大量临时文件和输出图片,定期清理以释放磁盘空间。 - 备份配置:定期备份你的
ComfyUI/custom_nodes配置和重要的工作流文件。
从繁琐的环境配置中解放出来,秋叶 ComfyUI V17 整合包确实为 AI 图像创作爱好者打开了一扇便捷之门。它不仅让你能快速体验节点式工作流的强大与灵活,其预置的中文环境和丰富插件更是锦上添花。记住,ComfyUI 的学习曲线在于理解节点间的数据流逻辑,多尝试、多拆解别人分享的工作流是进步最快的方式。