Skip to main content
Comfy Desktop 可以在 Linux 上运行。官方 .deb 包(Debian/Ubuntu)和 AppImage 通过 Comfy Desktop 仓库 分发,请使用通用下载链接下载(会自动识别你的平台)。大多数用户建议使用其中一种安装包。如果想从源码运行应用,请克隆仓库并按照以下步骤操作。

系统要求

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

安装官方安装包

通过通用下载链接下载 Linux 安装包(会自动识别你的平台),然后安装:
AppImage 的使用方式:
如果应用无法启动,可能是发行版阻止了 Electron 沙箱(Ubuntu 24.04+ 会通过 AppArmor 限制非特权 user namespace)。此时再用 --no-sandbox 重试。注意该参数会关闭所有进程的 Electron 沙箱,只在沙箱启动失败时使用。

从源码构建并运行

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

前置条件

先安装编译工具和 git。新装的 Ubuntu 默认没有这些,而 pnpm run init 会编译 node-pty 等原生模块,缺少 build-essential 时会报 Error: not found: make
然后安装 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(仅在你不再需要这些文件时)
如果你是通过 .deb 或 AppImage 安装的,应用还会把配置文件和日志保存在 ~/.config/Comfy Desktop。可以运行仓库里的 reset-linux.sh 脚本清理这些内容:它会删除所有已知的应用数据,但不会影响 ~/ComfyUI-Installs