安装与更新

Comfy Desktop 常见问题

Comfy Desktop 的常见问题与故障排除

一般问题

Comfy Desktop 和旧版 Desktop (Legacy) 有什么区别?

Comfy Desktop 是全新重写的版本,是一个多安装管理器。与旧版 Desktop(单一安装)不同,Comfy Desktop 允许你同时安装、管理和运行多个 ComfyUI 版本。还增加了快照和模型下载管理等功能。

如果你在使用旧版 Desktop Legacy,请查看迁移指南

Comfy Desktop 是开源的吗?

是的!源代码在 GitHub 上可用。

Comfy Desktop 会取代便携版/手动安装吗?

Comfy Desktop 是多种安装方式之一。你仍然可以根据需要选择便携版(Windows)手动安装Comfy Cloud。Desktop 因易用性和一键更新、快照管理等特色功能而被推荐给大多数用户。

安装与设置

系统要求是什么?

详细请查阅系统要求

  • Windows: Windows 10+,支持 CUDA 的 NVIDIA GPU
  • macOS: macOS 13+ (Ventura),Apple Silicon (M1+)
  • Linux: Ubuntu 22.04+,推荐支持 CUDA 的 NVIDIA GPU
  • 磁盘: 每个独立安装至少 4.85 GB
  • 内存: 最低 8 GB,推荐 16 GB
没有管理员权限可以安装 Comfy Desktop 吗?

Windows 上独立安装不需要管理员权限。macOS 上初次安装需要管理员权限。Linux 上系统依赖需要管理员权限,但应用本身运行在用户空间。

如何下载 Comfy Desktop?

从官方 ComfyUI 下载页面 下载最新版本。

可以同时安装旧版 Desktop Legacy 和 Comfy Desktop 吗?

可以共存。但我们建议将实例迁移到新的 Comfy Desktop,然后逐步卸载旧版。请参考迁移指南

使用

如何添加新的 ComfyUI 安装?

打开 Comfy Desktop,点击 添加安装,选择类型:

  • Standalone — 全新安装,自带 Python
  • Git Clone — 关联现有 Git 仓库
  • Portable — 导入便携版安装(Windows)
  • Cloud — 连接 Comfy Cloud
能同时运行多个 ComfyUI 版本吗?

可以!Comfy Desktop 就是为此设计的。每个安装运行在独立的隔离环境中,拥有自己的 Python 和依赖关系。它们可以同时在独立窗口中启动。

我的模型、自定义节点和设置存储在哪里?

每个安装是自包含的:

  • Standalone: 所有数据在安装文件夹内
  • Git Clone: 数据在仓库的 models/custom_nodes/user/ 文件夹中
快照如何工作?

Comfy Desktop 在每次更新之前自动创建快照。快照捕获:

  • 自定义节点及其版本
  • 模型文件
  • 设置和配置

你可以从应用的 快照 部分浏览和恢复任意快照。

如何停止/退出 Comfy Desktop

要停止正在运行的 ComfyUI 实例(停止 Python 后端但保持应用打开):

  1. 点击实例卡片上的 ⋮(kebab 菜单)
  2. 选择 停止
  3. 在对话框中确认

这将停止 ComfyUI Python 进程,但桌面应用窗口保持打开,以便随时重新启动。要完全退出桌面应用,请右键单击系统托盘图标并选择 退出。关闭窗口可能只是回到 Dashboard(取决于最后窗口关闭设置),使用系统托盘方法可确保完全退出。

故障排除

安装后应用无法启动
  1. Windows: 尝试以管理员身份运行一次
  2. macOS: 如果看到安全警告,前往 系统设置 → 隐私与安全性,点击 仍要打开
  3. Linux: 确保已安装 fuse2sudo apt install fuse2
  4. 查看下载页面获取最新版本
GPU 检测不到
  • 确保 NVIDIA 驱动是最新的
  • 在 Linux 上,检查 CUDA toolkit 是否已安装
  • 确认安装类型支持 GPU(Standalone 和 Git Clone 支持;云端连接使用远程 GPU)
安装更新失败
  • 检查网络连接
  • 先通过应用菜单手动创建快照
  • 如果问题持续,恢复到上一个快照再重试
如何卸载 Comfy Desktop?

Comfy Desktop 和它的安装在磁盘上是分开的。完整卸载:

  1. 从应用内删除安装(右键 → 移除)或手动删除安装文件夹
  2. 卸载应用 — 使用系统标准方法(Windows 的添加/删除程序,macOS 拖到废纸篓,Linux 包管理器)
Comfy Desktop 可以无头或服务器模式运行吗?

不可以。Comfy Desktop 是本地 GUI 应用程序,不支持无头(headless)模式、纯服务器模式或远程操作。它需要图形桌面环境来启动和管理 ComfyUI 实例。

如果需要无头或服务器部署,请使用 手动安装的 ComfyUIWindows 便携版

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本,并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明,不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0来源和修改说明