Skip to content
ComfyUI Wiki
帮助构建更好的 ComfyUI 知识库 成为赞助者

ComfyUI Desktop 安装使用指南

ComfyUI Desktop 是 ComfyUI 官方推出的桌面端一键安装版本,可以像常规软件一样安装,支持快捷安装、自动配置 Python 环境及依赖,并支持导入已有的 ComfyUI 设置、模型、工作流和文件。

ComfyUI Desktop 是一个开源项目,完整代码请访问 GitHub 仓库

ComfyUI Desktop 总是基于稳定版本构建的,这意味着它的更新总是滞后于开发版本或者便携版本的更新,如果你想要体验最新的功能可以尝试手动安装或者使用便携版本。

系统要求

  • Windows 版本:需要 NVIDIA 显卡(不支持 AMD GPU)
  • macOS 版本:需要 Apple Silicon 芯片
  • Linux:暂不支持
⚠️

由于 ComfyUI Desktop 仍处于 Beta 状态,实际的安装过程可能会发生变化。

下载地址

有任何问题请在 官方论坛GitHub Issues 反馈。

💡

反馈时请附带对应的 log 错误日志和界面截图,便于官方更好地定位问题。在反馈前建议先搜索论坛内容,查看是否已有类似问题的解决方案。

安装教程

下载安装包

Windows 用户下载:

运行安装程序

Windows 安装步骤:

  1. 点击此处下载 ComfyUI安装程序
  2. 下载完成后双击安装包进行安装
  3. 安装完成后桌面会生成 ComfyUI Desktop 快捷方式

ComfyUI Desktop Windows 安装

Windows ComfyUI Desktop 快捷方式

首次启动与初始化

双击桌面快捷方式(Windows)或在 Launchpad 中找到 ComfyUI(macOS)启动程序。

首次启动会进入初始化设置流程:

步骤 1:开始界面

点击 “Get Started” 开始初始化。

ComfyUI Desktop 开始界面

步骤 2:选择 GPU 模式

Windows 用户可选择:

  • NVIDIA 显卡(推荐):直接支持 PyTorch 和 CUDA
  • 手动配置:需要手动安装 Python 环境
  • CPU 模式:仅适用于开发或特殊情况 Windows GPU 选择界面

步骤 3:选择安装位置

安装位置选择

选择 ComfyUI 相关内容的安装位置:

  • Python 虚拟环境
  • 模型文件
  • 自定义节点

建议:

  • 新建一个单独的空白文件夹作为安装目录
  • 确保磁盘至少有 15GB 可用空间
  • 选择 SSD 位置以提高性能

步骤 4:迁移现有安装(可选)

如果你之前安装过 ComfyUI,可以选择迁移:

  • 用户文件
  • 模型文件(不会复制,只是建立关联)
  • 自定义节点(会重新安装)

迁移设置

步骤 5:桌面版设置

ComfyUI Desktop 设置

配置偏好设置:

  • 自动更新:是否在有更新时自动更新
  • 使用情况分析:是否收集匿名使用数据帮助改进
  • 镜像设置:如果网络访问受限,可配置镜像

如果出现红色 ❌ 提示镜像失败,可以尝试以下镜像:

Python 安装镜像:

https://python-standalone.org/mirror/astral-sh/python-build-standalone

PyPI 镜像:

完成安装

如果一切正常,安装程序将完成 Python 环境配置并自动进入 ComfyUI Desktop 界面。

ComfyUI 主界面

进行第一次图像生成

安装完成后,你可以:

  1. 加载默认工作流(workflow)
  2. 下载所需的模型文件
  3. 开始生成图像
💡

首次使用时可能需要下载模型文件,这可能需要一些时间,具体取决于你的网络速度。

添加外部模型路径

你可以在 ComfyUI 的菜单中添加外部模型来链接你本地的模型文件

添加外部模型路径

通过上图的模式可以打开 extra_model_paths.yaml 文件添加外部模型路径:

  • WindowsC:\Users\<你的用户名>\AppData\Roaming\ComfyUI\extra_model_paths.yaml
  • macOS~/Library/Application Support/ComfyUI/extra_model_paths.yaml

更新 ComfyUI

启用自动更新

目前 ComfyUI Desktop 仅支持自动更新,会在有可用更新的时候提示你进行下载和安装,你也可以手动检查更新:

  1. 在设置中启用自动更新
  2. 或在菜单中选择”检查更新”

ComfyUI Desktop 手动检查更新

卸载 ComfyUI Desktop

Windows 卸载方法:

简单卸载: 在 Windows 设置中卸载程序,不会删除模型文件、自定义节点等。 Windows 简单卸载

完整卸载: 除了卸载程序,还需手动删除:

  • C:\Users\<你的用户名>\AppData\Local\@comfyorgcomfyui-electron-updater
  • C:\Users\<你的用户名>\AppData\Local\Programs\@comfyorgcomfyui-electron
  • C:\Users\<你的用户名>\AppData\Roaming\ComfyUI
💡

如果删除了安装目录,模型、自定义节点、输入输出文件也将被删除。

故障排除

网络连接问题

如果安装过程中遇到网络问题:

  1. 检查网络连接
  2. 尝试使用 VPN
  3. 配置镜像设置

设备不支持

如果显示设备不支持:

  • Windows:确保有 NVIDIA 显卡
  • macOS:确保是 Apple Silicon 芯片

获取帮助

如果遇到其他问题:

Windows 用户: 查看日志文件:C:\Users\<你的用户名>\AppData\Roaming\ComfyUI\logs

获取支持:

  1. 访问 官方论坛 寻求帮助
  2. GitHub 提交问题报告

提交问题时请包含:

  • 错误日志
  • 系统信息
  • 详细的错误描述
  • 复现步骤