跳转到主要内容

​
常规问题

Comfy桌面版是全新重写的版本，是一个多安装管理器。与旧版 Desktop（单一安装）不同，Comfy桌面版允许你同时安装、管理和运行多个 ComfyUI 版本。它还增加了快照和模型下载管理功能。旧版 Desktop（Legacy）的用户请查看迁移指南，以迁移你现有的设置。
是的。源代码在 GitHub 上可用。Comfy桌面版采用双重许可证：AGPL-3.0-or-later，或从 Comfy Org 获取商业许可证（licensing@comfy.org）。
Comfy桌面版是多种安装方式之一。你仍然可以根据需要选择便携版（Windows）、手动安装或 Comfy Cloud。对于大多数用户，推荐使用 Comfy桌面版，因为它易于使用，并提供一键更新和快照管理等特色功能。
不可以。Comfy Desktop 启动后不久会检查一次新版本，之后每 10 分钟检查一次，这个检查无法关闭。唯一的更新设置是桌面端设置 → 更新里的自动安装桌面端更新，它默认开启。
  • 开启时：新版本会在后台下载并自动安装。下载期间标题栏显示 正在下载更新…，更新可以应用时显示 桌面端更新已就绪。
  • 关闭时：Comfy Desktop 仍会检查并通知你，但不再自行下载。标题栏改为显示 桌面端更新 胶囊按钮，点击它才会下载更新并提示重启。
实例内部的 ComfyUI 版本是单独更新的。请在实例的更新标签页中选择 Stable 或 Latest on GitHub 渠道进行更新。在 Linux 上，应用内更新器不适用于 .deb 安装。请通过通用下载链接下载新的安装包，再使用 sudo apt install ./*.deb 安装。

​
安装与设置

完整详情请参阅系统要求。
  • Windows： Windows 10+，x64 或 ARM64。推荐使用独立 GPU（NVIDIA / AMD），但并非必需。
  • macOS： macOS 13+ (Ventura)，Apple Silicon (M1+)
  • Linux： 官方 .deb 和 AppImage 安装包通过 Comfy Desktop 仓库 分发。推荐使用独立 GPU。
  • 磁盘： 每个独立安装至少 4.85 GB
  • 内存： 最低 8 GB，推荐 16 GB
Windows 上独立安装不需要管理员权限。macOS 上首次进行系统级安装时需要管理员权限。Linux 上安装 .deb 包需要 sudo；AppImage 在用户空间运行，无需管理员权限。
请从官方 ComfyUI 下载页面 下载最新的 Windows 或 macOS 构建。Linux 用户请使用 Comfy Desktop 仓库 中的通用下载链接获取 .deb 或 AppImage。如需从源码运行，参见 Linux 安装指南。
可以共存。但我们建议将您的安装迁移到新的 Comfy Desktop，并最终卸载 Legacy Desktop。请参阅迁移指南。

​
使用

在仪表盘上，点击 新建实例 创建独立实例，或打开 新建实例 并选择 添加现有实例 来跟踪 Git 克隆或 Windows 便携版安装。使用 Comfy Cloud 卡片连接到云端。
  • 独立安装：全新安装，自带 Python
  • 添加现有实例：跟踪 Git 克隆或便携版安装
  • 云端：连接 Comfy Cloud
可以！Comfy Desktop 就是为此设计的。每个安装运行在独立的隔离环境中，拥有自己的 Python 和依赖关系。它们可以同时在独立窗口中启动。
模型在实例之间默认共享。在 桌面设置 → 存储 中配置共享文件夹。
  • 独立安装： 安装本身位于其安装文件夹中。自定义节点和 Python 环境按安装独立。模型通常来自共享的模型目录。
  • Git 克隆 / 便携版（已跟踪）： 数据保留在该现有文件夹（models/、custom_nodes/、user/）中。你仍然可以选择共享模型、输入和输出。
Comfy Desktop 会在关键节点自动创建快照：每次启动和重启、更新前后，以及恢复之后。快照记录实例的 ComfyUI 版本、自定义节点及其版本，以及环境中的所有 pip 包。模型文件、输入和输出不包含在快照中。你可以在实例的 Snapshots 标签页中浏览、恢复、导出和分享快照。参见快照。

​
如何停止/退出 Comfy Desktop

要停止正在运行的 ComfyUI 实例（停止 Python 后端但保持应用打开）：
  1. 点击实例卡片上的 ⋮（kebab 菜单）
  2. 选择 停止
  3. 在对话框中确认
这会停止 ComfyUI Python 进程，但桌面应用窗口保持打开，以便随时重新启动。要完全退出桌面应用，请打开左上角的 ☰ 菜单并选择 Quit Desktop（或等效的操作系统退出命令）。关闭最后一个窗口将返回仪表盘，除非你退出应用。

​
故障排除

  1. Windows： 尝试以管理员身份运行一次
  2. macOS： 如果看到安全警告，前往 系统设置 → 隐私与安全性，点击 仍要打开
  3. Linux： 确保已安装 FUSE 2（sudo apt install libfuse2）
  4. 查看下载页面获取最新版本
在 Windows 上，如果更新没有下载完成，Comfy Desktop 1.0.46 及更早版本可能会卡住。应用会短暂显示更新界面，然后在没有任何报错的情况下关闭。每次启动都会这样，而且应用在下载到修复版本之前就会关闭。1.0.47 及更高版本已修复此问题。要恢复，请手动安装最新版本：
  1. 下载最新的 Windows 安装程序，或从下载页面获取。
  2. 运行安装程序。无需先卸载旧版本。
  3. 启动 Comfy Desktop。
你的安装、模型和设置都会保留。
  • 确保 NVIDIA 驱动是最新的
  • 在 Linux 上，验证 CUDA toolkit 是否已安装
  • 确认安装类型支持 GPU（Standalone 和 Git Clone 支持；云端连接使用远程 GPU）
  • 检查网络连接
  • 重试前先在实例的 Snapshots 标签页手动创建快照
  • 如果问题持续，恢复到上一个快照再重试
在新建实例过程中，Comfy Desktop 会检查安装磁盘的可用空间。磁盘空间不足是警告——可选择仍然继续，或改选其他路径。磁盘空间不足以下载模板模型会拦截该模板；请改选更轻量的工作流或释放空间。磁盘过小时可能跳过模板步骤。详见创建新实例。
Desktop 应用会写入轮转的 app.log 文件。最快的查找方式是 桌面设置 → 日志 → 诊断 → 打开日志文件夹（左上角 ☰ 菜单）。默认日志文件夹：
  • Windows: %APPDATA%\Comfy Desktop\logs
  • macOS: ~/Library/Logs/Comfy Desktop
  • Linux: ~/.config/Comfy Desktop/logs
查找 app.log。之前的会话会轮转为带时间戳的 app.log_*.log 文件。ComfyUI 进程输出（不是 Desktop 应用本身）请打开实例的 管理 面板，使用 终端 标签页。参见安装管理。
ComfyUI 不会原生把 Ollama 当作扩散模型后端。不过你可以通过 ComfyUI Manager 注册表中的自定义节点，用 Ollama 提供的 LLM 做提示词生成和文本处理。关于把 ComfyUI 接到 LLM 服务，见安装自定义节点。
Comfy Desktop 和它的安装在磁盘上是分开的。要卸载应用及其安装：
  1. 从应用内删除安装（右键 → 移除）或手动删除安装文件夹
  2. 卸载应用：使用系统标准方法（Windows 的添加/删除程序，macOS 拖到废纸篓，Linux 包管理器）
这不会删除应用设置、日志、共享模型和输出。残留目录和完整清理步骤见 Windows、macOS、Linux。
不可以。Comfy Desktop 是本地 GUI 应用程序，不支持无头（headless）模式、纯服务器模式或远程操作。它需要图形桌面环境来启动和管理 ComfyUI 实例。如果需要无头或服务器部署，请使用 手动安装的 ComfyUI 或 Windows 便携版。