Skip to main content
Comfy Desktop 可以在 Linux 上运行,但目前还没有正式发布的 Linux 安装包。下载页 只提供 Windows 和 macOS。在 Linux 上,请克隆 Comfy Desktop 仓库 并从源码运行。

系统要求

  • 操作系统: Linux(推荐 Ubuntu 22.04 或更高版本)
  • 架构: x64
  • Node.js: v22 LTS 或更高版本
  • pnpm: v10 或更高版本(用 Corepack 启用)
  • GPU: 推荐独立 GPU(NVIDIA / AMD),但不是必须
  • 磁盘空间: 每个 ComfyUI 安装建议至少 4.85 GB

从源码构建并运行

这些步骤与仓库 README 的 Development 部分一致。

前置条件

安装 Node.js 22,然后启用 pnpm:
如果不用 nvm,请从 nodejs.org 安装 Node.js 22。

克隆并安装

pnpm run init 会安装依赖并构建内置的 bootstrap Python。

启动应用

这会以开发模式启动 Comfy Desktop。脚本会设置 ELECTRON_DISABLE_SANDBOX=1,因为 Electron 沙箱在 Linux 开发环境里经常无法启动。

下一步:使用 Comfy Desktop

应用运行后,了解如何创建实例、管理安装和配置设置。

更新

源码检出没有应用内自动更新。拉取最新代码后再启动:

可选:本地打包

若要自己生成 .deb 或 AppImage(不是 Comfy Org 的正式下载):
产物在 dist/。如果 AppImage 因为 Chromium 无法创建沙箱而失败,再用 --no-sandbox 重试。该参数会关闭所有进程的 Electron 沙箱。

清理残留数据

停止源码运行不会删除 ComfyUI 安装或应用数据。只有在需要彻底清理时才删除这些文件夹: 要彻底删除所有内容:
  1. 删除 Comfy-Desktop 克隆目录
  2. 删除配置文件夹~/.config/comfyui-desktop-2
  3. 删除数据、缓存和状态文件夹~/.local/share/comfyui-desktop-2~/.cache/comfyui-desktop-2~/.local/state/comfyui-desktop-2
  4. 删除各个安装:在应用内删除,或手动删除 ~/ComfyUI-Installs 以及你配置过的自定义安装目录
  5. 删除共享模型库~/ComfyUI-Shared(仅在你不再需要这些文件时)