Comfy Desktop 常见问题

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

常规问题

[accordion] Comfy桌面版和旧版 Desktop（Legacy）有什么区别？ Comfy桌面版是全新重写的版本，是一个多安装管理器。与旧版 Desktop（单一安装）不同，Comfy桌面版允许你同时安装、管理和运行多个 ComfyUI 版本。它还增加了快照和模型下载管理功能。 旧版 Desktop（Legacy）的用户请查看迁移指南，以迁移你现有的设置。

[accordion] Comfy桌面版是开源的吗？ 是的。源代码在 GitHub 上可用。Comfy桌面版采用双重许可证：AGPL-3.0-or-later，或从 Comfy Org 获取商业许可证（licensing@comfy.org）。

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

[accordion] 可以关闭更新检查吗？ 不可以。Comfy Desktop 启动后不久会检查一次新版本，之后每 10 分钟检查一次，这个检查无法关闭。唯一的更新设置是桌面端设置 → 更新里的自动安装桌面端更新，它默认开启。 开启时：新版本会在后台下载并自动安装。下载期间标题栏显示 正在下载更新…，更新可以应用时显示 桌面端更新已就绪。 关闭时：标题栏显示 桌面端更新，更新卡片显示 有可用更新 …。更新仍会在后台下载，但不会自行安装——退出应用或下次启动都不会应用。就绪后点击 桌面端更新已就绪 并选择 重启并更新。 实例内部的 ComfyUI 版本是单独更新的。请在实例的更新标签页中选择 Stable 或 Latest on GitHub 渠道进行更新。 在 Linux 上，应用内更新器不适用于 .deb 安装。请通过通用下载链接下载新的安装包，再使用 sudo apt install ./*.deb 安装。

安装与设置

[accordion] 系统要求是什么？ 完整详情请参阅系统要求。 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

[accordion] 没有管理员权限可以安装 Comfy Desktop 吗？ Windows 上独立安装不需要管理员权限。macOS 上首次进行系统级安装时需要管理员权限。Linux 上安装 .deb 包需要 sudo；AppImage 在用户空间运行，无需管理员权限。

[accordion] 如何下载 Comfy Desktop？ 请从官方 ComfyUI 下载页面 下载最新的 Windows 或 macOS 构建。Linux 用户请使用 Comfy Desktop 仓库 中的通用下载链接获取 .deb 或 AppImage。如需从源码运行，参见 Linux 安装指南。

[accordion] 可以同时安装 Legacy Desktop 和 Comfy Desktop 吗？ 可以共存。但我们建议将您的安装迁移到新的 Comfy Desktop，并最终卸载 Legacy Desktop。请参阅迁移指南。

使用

[accordion] 如何添加新的 ComfyUI 安装？ 在仪表盘上，点击 新建实例 创建独立实例，或打开 新建实例 并选择 添加现有实例 来跟踪 Git 克隆或 Windows 便携版安装。使用 Comfy Cloud 卡片连接到云端。 独立安装：全新安装，自带 Python 添加现有实例：跟踪 Git 克隆或便携版安装 * 云端：连接 Comfy Cloud

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

[accordion] 我的模型、自定义节点和设置存储在哪里？ 模型在实例之间默认共享。在 桌面设置 → 存储 中配置共享文件夹。 独立安装： 安装本身位于其安装文件夹中。自定义节点和 Python 环境按安装独立。模型通常来自共享的模型目录。 Git 克隆 / 便携版（已跟踪）： 数据保留在该现有文件夹（models/、custom_nodes/、user/）中。你仍然可以选择共享模型、输入和输出。

[accordion] 快照如何工作？ Comfy Desktop 会在关键节点自动创建快照：每次启动和重启、更新前后，以及恢复之后。快照记录实例的 ComfyUI 版本、自定义节点及其版本，以及环境中的所有 pip 包。模型文件、输入和输出不包含在快照中。 你可以在实例的 Snapshots 标签页中浏览、恢复、导出和分享快照。参见快照。

如何停止/退出 Comfy Desktop

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

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

这会停止 ComfyUI Python 进程，但桌面应用窗口保持打开，以便随时重新启动。要完全退出桌面应用，请打开左上角的 ☰ 菜单并选择 Quit Desktop（或等效的操作系统退出命令）。关闭最后一个窗口将返回仪表盘，除非你退出应用。

故障排除

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

[accordion] 更新后 Comfy Desktop 自动关闭（Windows） 在 Windows 上，如果更新没有下载完成，Comfy Desktop 1.0.46 及更早版本可能会卡住。应用会短暂显示更新界面，然后在没有任何报错的情况下关闭。每次启动都会这样，而且应用在下载到修复版本之前就会关闭。1.0.47 及更高版本已修复此问题。 要恢复，请手动安装最新版本： 1. 下载最新的 Windows 安装程序，或从下载页面获取。 2. 运行安装程序。无需先卸载旧版本。 3. 启动 Comfy Desktop。 你的安装、模型和设置都会保留。

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

[accordion] 安装更新失败 检查网络连接 重试前先在实例的 Snapshots 标签页手动创建快照 * 如果问题持续，恢复到上一个快照再重试

[accordion] 安装或更新显示「操作失败」 进度界面会保持打开，显示 操作失败、错误信息，以及（如有输出时）自动展开的 查看日志 面板。 重启：重新执行失败的操作（如果失败的是启动，同一按钮会显示为 重启 ComfyUI）。 返回：直接回到仪表板，不再询问；失败的安装会原样留在磁盘上。 * 步骤还在运行时离开等于取消：返回仪表板 会询问 取消当前操作？。取消安装会尝试删除建到一半的文件夹（删除失败时可能残留文件）。 如果反复失败，先检查网络，再从 桌面端设置 → 日志 → Diagnostics → Open logs folder 取出 app.log（以及同目录下的 app.log_*.log）。首次安装时菜单可能只有 跳过引导 —— 先选 返回，再从仪表板打开设置。另见 如何查看 Comfy Desktop 启动日志？。

[accordion] 出现「磁盘空间不足」或「磁盘空间不足以下载模板模型」怎么办？ 在新建实例过程中，Comfy Desktop 会检查安装磁盘的可用空间。磁盘空间不足是警告——可选择仍然继续，或改选其他路径。磁盘空间不足以下载模板模型会拦截该模板；请改选更轻量的工作流或释放空间。磁盘过小时可能跳过模板步骤。详见创建新实例。

[accordion] 如何查看 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 应用本身）请打开实例的 管理 面板，使用 终端 标签页。参见安装管理。

[accordion] 可以在 ComfyUI 中使用 Ollama 吗？ ComfyUI 不会原生把 Ollama 当作扩散模型后端。不过你可以通过 ComfyUI Manager 注册表中的自定义节点，用 Ollama 提供的 LLM 做提示词生成和文本处理。 关于把 ComfyUI 接到 LLM 服务，见安装自定义节点。

[accordion] 如何卸载 Comfy Desktop？ Comfy Desktop 和它的安装在磁盘上是分开的。要卸载应用及其安装： 1. 从应用内删除安装（右键 → 移除）或手动删除安装文件夹 2. 卸载应用：使用系统标准方法（Windows 的添加/删除程序，macOS 拖到废纸篓，Linux 包管理器） 这不会删除应用设置、日志、共享模型和输出。残留目录和完整清理步骤见 Windows、macOS、Linux。

[accordion] Comfy Desktop 可以无头或服务器模式运行吗？ 不可以。Comfy Desktop 是本地 GUI 应用程序，不支持无头（headless）模式、纯服务器模式或远程操作。它需要图形桌面环境来启动和管理 ComfyUI 实例。 如果需要无头或服务器部署，请使用 手动安装的 ComfyUI 或 Windows 便携版。