系统要求
- 操作系统: 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:克隆并安装
pnpm run init 会安装依赖并构建内置的 bootstrap Python。
启动应用
ELECTRON_DISABLE_SANDBOX=1,因为 Electron 沙箱在 Linux 开发环境里经常无法启动。
下一步:使用 Comfy Desktop
应用运行后,了解如何创建实例、管理安装和配置设置。
更新
源码检出没有应用内自动更新。拉取最新代码后再启动:可选:本地打包
若要自己生成.deb 或 AppImage(不是 Comfy Org 的正式下载):
dist/。如果 AppImage 因为 Chromium 无法创建沙箱而失败,再用 --no-sandbox 重试。该参数会关闭所有进程的 Electron 沙箱。
清理残留数据
停止源码运行不会删除 ComfyUI 安装或应用数据。只有在需要彻底清理时才删除这些文件夹:
要彻底删除所有内容:
- 删除
Comfy-Desktop克隆目录 - 删除配置文件夹:
~/.config/comfyui-desktop-2 - 删除数据、缓存和状态文件夹:
~/.local/share/comfyui-desktop-2、~/.cache/comfyui-desktop-2和~/.local/state/comfyui-desktop-2 - 删除各个安装:在应用内删除,或手动删除
~/ComfyUI-Installs以及你配置过的自定义安装目录 - 删除共享模型库:
~/ComfyUI-Shared(仅在你不再需要这些文件时)