> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-stale2000-comfy-agent-guides.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 仓库](https://github.com/Comfy-Org/Comfy-Desktop) 分发，请使用[通用下载链接](https://dl.todesktop.com/241130tqe9q3y)下载（会自动识别你的平台）。大多数用户建议使用其中一种安装包。如果想从源码运行应用，请克隆仓库并按照以下步骤操作。

## 系统要求

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

## 安装官方安装包

通过[通用下载链接](https://dl.todesktop.com/241130tqe9q3y)下载 Linux 安装包（会自动识别你的平台），然后安装：

```bash theme={null}
sudo apt install ./*.deb
```

AppImage 的使用方式：

```bash theme={null}
chmod +x ./*.AppImage
./*.AppImage
```

如果应用无法启动，可能是发行版阻止了 Electron 沙箱（Ubuntu 24.04+ 会通过 AppArmor 限制非特权 user namespace）。此时再用 `--no-sandbox` 重试。注意该参数会关闭所有进程的 Electron 沙箱，只在沙箱启动失败时使用。

## 从源码构建并运行

这些步骤与仓库 README 的 [Development](https://github.com/Comfy-Org/Comfy-Desktop#development) 部分一致。

### 前置条件

先安装编译工具和 git。新装的 Ubuntu 默认没有这些，而 `pnpm run init` 会编译 `node-pty` 等原生模块，缺少 `build-essential` 时会报 `Error: not found: make`：

```bash theme={null}
sudo apt install build-essential git
```

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

```bash theme={null}
nvm install 22 && nvm use 22
corepack enable
```

如果不用 nvm，请从 [nodejs.org](https://nodejs.org/) 安装 Node.js 22。

### 克隆并安装

```bash theme={null}
git clone https://github.com/Comfy-Org/Comfy-Desktop.git
cd Comfy-Desktop
pnpm run init
```

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

### 启动应用

```bash theme={null}
./linux-dev.sh
```

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

<Card title="下一步：使用 Comfy Desktop" icon="book-open" href="/zh/installation/desktop/usage/overview">
  应用运行后，了解如何创建实例、管理安装和配置设置。
</Card>

## 更新

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

```bash theme={null}
git pull
pnpm run init
./linux-dev.sh
```

## 可选：本地打包

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

```bash theme={null}
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](https://github.com/Comfy-Org/Comfy-Desktop/blob/main/scripts/reset-linux.sh) 脚本清理这些内容：它会删除所有已知的应用数据，但不会影响 `~/ComfyUI-Installs`。