Flux.1 Kontext Dev 开源版本发布,ComfyUI 已原生支持
2025/06/26
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 用户下载:
- 下载链接:https://download.comfy.org/windows/nsis/x64
- 适用于带有 NVIDIA 显卡的 Windows 系统
运行安装程序
首次启动与初始化
双击桌面快捷方式(Windows)或在 Launchpad 中找到 ComfyUI(macOS)启动程序。
首次启动会进入初始化设置流程:
步骤 1:开始界面
点击 “Get Started” 开始初始化。
步骤 2:选择 GPU 模式
Windows 用户可选择:
- NVIDIA 显卡(推荐):直接支持 PyTorch 和 CUDA
- 手动配置:需要手动安装 Python 环境
- CPU 模式:仅适用于开发或特殊情况
步骤 3:选择安装位置
选择 ComfyUI 相关内容的安装位置:
- Python 虚拟环境
- 模型文件
- 自定义节点
建议:
- 新建一个单独的空白文件夹作为安装目录
- 确保磁盘至少有 15GB 可用空间
- 选择 SSD 位置以提高性能
步骤 4:迁移现有安装(可选)
如果你之前安装过 ComfyUI,可以选择迁移:
- 用户文件
- 模型文件(不会复制,只是建立关联)
- 自定义节点(会重新安装)
步骤 5:桌面版设置
配置偏好设置:
- 自动更新:是否在有更新时自动更新
- 使用情况分析:是否收集匿名使用数据帮助改进
- 镜像设置:如果网络访问受限,可配置镜像
如果出现红色 ❌ 提示镜像失败,可以尝试以下镜像:
Python 安装镜像:
https://python-standalone.org/mirror/astral-sh/python-build-standalone
PyPI 镜像:
- 阿里云:https://mirrors.aliyun.com/pypi/simple/
- 腾讯云:https://mirrors.cloud.tencent.com/pypi/simple/
- 中国科技大学:https://pypi.mirrors.ustc.edu.cn/simple/
完成安装
如果一切正常,安装程序将完成 Python 环境配置并自动进入 ComfyUI Desktop 界面。
进行第一次图像生成
安装完成后,你可以:
- 加载默认工作流(workflow)
- 下载所需的模型文件
- 开始生成图像
首次使用时可能需要下载模型文件,这可能需要一些时间,具体取决于你的网络速度。
添加外部模型路径
你可以在 ComfyUI 的菜单中添加外部模型来链接你本地的模型文件
通过上图的模式可以打开 extra_model_paths.yaml
文件添加外部模型路径:
- Windows:
C:\Users\<你的用户名>\AppData\Roaming\ComfyUI\extra_model_paths.yaml
- macOS:
~/Library/Application Support/ComfyUI/extra_model_paths.yaml
更新 ComfyUI
目前 ComfyUI Desktop 仅支持自动更新,会在有可用更新的时候提示你进行下载和安装,你也可以手动检查更新:
- 在设置中启用自动更新
- 或在菜单中选择”检查更新”
卸载 ComfyUI Desktop
Windows 卸载方法:
简单卸载:
在 Windows 设置中卸载程序,不会删除模型文件、自定义节点等。
完整卸载: 除了卸载程序,还需手动删除:
C:\Users\<你的用户名>\AppData\Local\@comfyorgcomfyui-electron-updater
C:\Users\<你的用户名>\AppData\Local\Programs\@comfyorgcomfyui-electron
C:\Users\<你的用户名>\AppData\Roaming\ComfyUI
如果删除了安装目录,模型、自定义节点、输入输出文件也将被删除。
故障排除
网络连接问题
如果安装过程中遇到网络问题:
- 检查网络连接
- 尝试使用 VPN
- 配置镜像设置
设备不支持
如果显示设备不支持:
- Windows:确保有 NVIDIA 显卡
- macOS:确保是 Apple Silicon 芯片
获取帮助
如果遇到其他问题:
Windows 用户:
查看日志文件:C:\Users\<你的用户名>\AppData\Roaming\ComfyUI\logs
获取支持:
提交问题时请包含:
- 错误日志
- 系统信息
- 详细的错误描述
- 复现步骤