Linux 上的 Comfy Desktop

Linux 上的 Comfy Desktop：安装官方 .deb 或 AppImage，或克隆仓库从源码运行。源码构建要求 Ubuntu 22.04+、x64 和 Node.js v22 LTS。

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

​

系统要求

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

​

安装官方安装包

通过通用下载链接下载 Linux 安装包（会自动识别你的平台），然后安装：

sudo apt install ./*.deb

AppImage 的使用方式：

chmod +x ./*.AppImage
./*.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：

sudo apt install build-essential git

然后安装 Node.js 22 并启用 pnpm：

nvm install 22 && nvm use 22
corepack enable

如果不用 nvm，请从 nodejs.org 安装 Node.js 22。

​

克隆并安装

git clone https://github.com/Comfy-Org/Comfy-Desktop.git
cd Comfy-Desktop
pnpm run init

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

​

启动应用

./linux-dev.sh

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

下一步：使用 Comfy Desktop

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

​

更新

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

git pull
pnpm run init
./linux-dev.sh

​

可选：本地打包

若要自己生成 .deb 或 AppImage（不是 Comfy Org 的正式下载）：

pnpm run build:linux

产物在 dist/。如果 AppImage 因为 Chromium 无法创建沙箱而失败，再用 --no-sandbox 重试。该参数会关闭所有进程的 Electron 沙箱。

​

清理残留数据

停止源码运行不会删除 ComfyUI 安装或应用数据。只有在需要彻底清理时才删除这些文件夹：

数据	默认位置	说明
安装	~/ComfyUI-Installs	你创建的每个 ComfyUI 安装（也可在应用内删除）。自定义安装路径也不会被移除。
共享模型与输出	~/ComfyUI-Shared	共享模型库、输入/输出目录
应用配置	~/.config/comfyui-desktop-2	设置和安装记录
应用数据	~/.local/share/comfyui-desktop-2	持久化应用数据
缓存	~/.cache/comfyui-desktop-2	下载缓存和其他非必要文件
状态	~/.local/state/comfyui-desktop-2	运行时状态，例如端口锁
日志	~/.config/comfyui-desktop-2/logs	桌面应用日志（app.log）

要彻底删除所有内容：

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。