> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-462120c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Desktop 常见问题

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

## 常规问题

<Accordion title="Comfy桌面版和旧版 Desktop（Legacy）有什么区别？">
  Comfy桌面版是全新重写的版本，是一个**多安装管理器**。与旧版 Desktop（单一安装）不同，Comfy桌面版允许你同时安装、管理和运行多个 ComfyUI 版本。它还增加了快照和模型下载管理功能。

  旧版 Desktop（Legacy）的用户请查看[迁移指南](/zh/installation/desktop/usage/migrate)，以迁移你现有的设置。
</Accordion>

<Accordion title="Comfy桌面版是开源的吗？">
  是的。源代码在 [GitHub](https://github.com/Comfy-Org/Comfy-Desktop) 上可用。Comfy桌面版采用双重许可证：[AGPL-3.0-or-later](https://github.com/Comfy-Org/Comfy-Desktop/blob/main/LICENSE)，或从 Comfy Org 获取商业许可证（`licensing@comfy.org`）。
</Accordion>

<Accordion title="Comfy桌面版会取代便携版/手动安装吗？">
  Comfy桌面版是多种安装方式之一。你仍然可以根据需要选择**便携版（Windows）**、**手动安装**或 **Comfy Cloud**。对于大多数用户，推荐使用 Comfy桌面版，因为它易于使用，并提供一键更新和快照管理等特色功能。
</Accordion>

## 安装与设置

<Accordion title="系统要求是什么？">
  完整详情请参阅[系统要求](/zh/installation/system_requirements)。

  * **Windows：** Windows 10+，x64 或 ARM64。推荐使用独立 GPU（NVIDIA / AMD），但并非必需。
  * **macOS：** macOS 13+ (Ventura)，Apple Silicon (M1+)
  * **Linux：** 目前没有正式安装包。[从源码构建](/zh/installation/desktop/linux)。推荐使用独立 GPU。
  * **磁盘：** 每个独立安装至少 4.85 GB
  * **内存：** 最低 8 GB，推荐 16 GB
</Accordion>

<Accordion title="没有管理员权限可以安装 Comfy Desktop 吗？">
  **Windows** 上独立安装不需要管理员权限。**macOS** 上首次进行系统级安装时需要管理员权限。**Linux** 从源码在用户空间运行。只有安装 Node.js 等系统软件包时才可能需要管理员权限。
</Accordion>

<Accordion title="如何下载 Comfy Desktop？">
  从官方 [ComfyUI 下载页面](https://comfy.org/download) 下载最新的 Windows 或 macOS 构建。Linux 没有已发布的安装包，请[从源码构建](/zh/installation/desktop/linux)。
</Accordion>

<Accordion title="可以同时安装 Legacy Desktop 和 Comfy Desktop 吗？">
  可以共存。但我们建议将您的安装迁移到新的 Comfy Desktop，并最终卸载 Legacy Desktop。请参阅[迁移指南](/zh/installation/desktop/usage/migrate)。
</Accordion>

## 使用

<Accordion title="如何添加新的 ComfyUI 安装？">
  在仪表盘上，点击 **新建实例** 创建独立实例，或打开 **新建实例** 并选择 **添加现有实例** 来跟踪 Git 克隆或 Windows 便携版安装。使用 **Comfy Cloud** 卡片连接到云端。

  * **独立安装**：全新安装，自带 Python
  * **添加现有实例**：跟踪 Git 克隆或便携版安装
  * **云端**：连接 Comfy Cloud
</Accordion>

<Accordion title="能同时运行多个 ComfyUI 版本吗？">
  可以！Comfy Desktop 就是为此设计的。每个安装运行在独立的隔离环境中，拥有自己的 Python 和依赖关系。它们可以同时在独立窗口中启动。
</Accordion>

<Accordion title="我的模型、自定义节点和设置存储在哪里？">
  模型在实例之间默认共享。在 [桌面设置 → 存储](/zh/installation/desktop/usage/settings#存储) 中配置共享文件夹。

  * **独立安装：** 安装本身位于其安装文件夹中。自定义节点和 Python 环境按安装独立。模型通常来自共享的模型目录。
  * **Git 克隆 / 便携版（已跟踪）：** 数据保留在该现有文件夹（`models/`、`custom_nodes/`、`user/`）中。你仍然可以选择共享模型、输入和输出。
</Accordion>

<Accordion title="快照如何工作？">
  Comfy Desktop 在每次更新之前自动创建快照。快照捕获：

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

  你可以从应用的 **快照** 部分浏览和恢复任意快照。
</Accordion>

### 如何停止/退出 Comfy Desktop

要停止正在运行的 ComfyUI 实例（停止 Python 后端但保持应用打开）：

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

这会停止 ComfyUI Python 进程，但桌面应用窗口保持打开，以便随时重新启动。要完全退出桌面应用，请使用 **文件 → 退出**（或等效的操作系统退出命令）。关闭最后一个窗口将返回仪表盘，除非你退出应用。

## 故障排除

<Accordion title="安装后应用无法启动">
  1. **Windows：** 尝试以管理员身份运行一次
  2. **macOS：** 如果看到安全警告，前往 **系统设置 → 隐私与安全性**，点击 **仍要打开**
  3. **Linux：** 确保已安装 FUSE 2（`sudo apt install libfuse2`）
  4. 查看[下载页面](https://comfy.org/download)获取最新版本
</Accordion>

<Accordion title="GPU 检测不到">
  * 确保 NVIDIA 驱动是最新的
  * 在 Linux 上，验证 CUDA toolkit 是否已安装
  * 确认安装类型支持 GPU（Standalone 和 Git Clone 支持；云端连接使用远程 GPU）
</Accordion>

<Accordion title="安装更新失败">
  * 检查网络连接
  * 先通过应用菜单手动创建快照
  * 如果问题持续，恢复到上一个快照再重试
</Accordion>

<Accordion title="如何查看 Comfy Desktop 启动日志？">
  Desktop 应用会写入轮转的 `app.log` 文件。最快的查找方式是 **桌面设置 → 日志 → 诊断 → 打开日志文件夹**（左上角 ☰ 菜单）。

  默认日志文件夹：

  * **Windows:** `%APPDATA%\Comfy Desktop\logs`
  * **macOS:** `~/Library/Logs/Comfy Desktop`
  * **Linux:** `~/.config/comfyui-desktop-2/logs`

  查找 `app.log`。之前的会话会轮转为带时间戳的 `app.log_*.log` 文件。

  ComfyUI 进程输出（不是 Desktop 应用本身）请打开实例的 **管理** 面板，使用 **终端** 标签页。参见[安装管理](/zh/installation/desktop/usage/manage)。
</Accordion>

<Accordion title="如何卸载 Comfy Desktop？">
  Comfy Desktop 和它的安装在磁盘上是分开的。要卸载应用及其安装：

  1. **从应用内删除安装**（右键 → 移除）或手动删除安装文件夹
  2. **卸载应用**：使用系统标准方法（Windows 的添加/删除程序，macOS 拖到废纸篓，Linux 包管理器）

  这不会删除应用设置、日志、共享模型和输出。残留目录和完整清理步骤见 [Windows](/zh/installation/desktop/windows#卸载应用不会移除的内容)、[macOS](/zh/installation/desktop/macos#卸载应用不会删除的内容)、[Linux](/zh/installation/desktop/linux#清理残留数据)。
</Accordion>

<Accordion title="Comfy Desktop 可以无头或服务器模式运行吗？">
  不可以。Comfy Desktop 是本地 GUI 应用程序，不支持无头（headless）模式、纯服务器模式或远程操作。它需要图形桌面环境来启动和管理 ComfyUI 实例。

  如果需要无头或服务器部署，请使用 **手动安装的 ComfyUI** 或 **Windows 便携版**。
</Accordion>