Skip to main content

​
常规问题

Comfy桌面版是全新重写的版本，是一个多安装管理器。与旧版 Desktop（单一安装）不同，Comfy桌面版允许你同时安装、管理和运行多个 ComfyUI 版本。它还增加了快照和模型下载管理功能。旧版 Desktop（Legacy）的用户请查看迁移指南，以迁移你现有的设置。
是的。源代码在 GitHub 上可用。Comfy桌面版采用双重许可证：AGPL-3.0-or-later，或从 Comfy Org 获取商业许可证（licensing@comfy.org）。
Comfy桌面版是多种安装方式之一。你仍然可以根据需要选择便携版（Windows）、手动安装或 Comfy Cloud。对于大多数用户，推荐使用 Comfy桌面版，因为它易于使用，并提供一键更新和快照管理等特色功能。

​
安装与设置

完整详情请参阅系统要求。
  • 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 在每次更新之前自动创建快照。快照捕获：
  • 自定义节点及其版本
  • 模型文件
  • 设置和配置
你可以从应用的 快照 部分浏览和恢复任意快照。

​
如何停止/退出 Comfy Desktop

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

​
故障排除

  1. Windows： 尝试以管理员身份运行一次
  2. macOS： 如果看到安全警告，前往 系统设置 → 隐私与安全性，点击 仍要打开
  3. Linux： 确保已安装 FUSE 2（sudo apt install libfuse2）
  4. 查看下载页面获取最新版本
  • 确保 NVIDIA 驱动是最新的
  • 在 Linux 上，验证 CUDA toolkit 是否已安装
  • 确认安装类型支持 GPU（Standalone 和 Git Clone 支持；云端连接使用远程 GPU）
  • 检查网络连接
  • 先通过应用菜单手动创建快照
  • 如果问题持续，恢复到上一个快照再重试
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 应用本身）请打开实例的 管理 面板，使用 终端 标签页。参见安装管理。
Comfy Desktop 和它的安装在磁盘上是分开的。要卸载应用及其安装：
  1. 从应用内删除安装（右键 → 移除）或手动删除安装文件夹
  2. 卸载应用：使用系统标准方法（Windows 的添加/删除程序，macOS 拖到废纸篓，Linux 包管理器）
这不会删除应用设置、日志、共享模型和输出。残留目录和完整清理步骤见 Windows、macOS、Linux。
不可以。Comfy Desktop 是本地 GUI 应用程序，不支持无头（headless）模式、纯服务器模式或远程操作。它需要图形桌面环境来启动和管理 ComfyUI 实例。如果需要无头或服务器部署，请使用 手动安装的 ComfyUI 或 Windows 便携版。