ComfyUI 安装与第一次出图

Comfy Desktop 是 ComfyUI 的官方桌面程序，会一起安装 ComfyUI 和所需的运行环境，不需要你单独配置 Python、CUDA 或 pip。你还可以在同一台电脑上保留多套安装，每套互不影响，适合分别尝试不同版本或配置。

安装前准备

先确认电脑符合以下条件：

• Windows 10 或更新版本，支持 x64 或 ARM64。建议使用 NVIDIA 或 AMD 独立显卡，但没有独立显卡也可以安装。
• macOS 13（Ventura）或更新版本，并且必须是 Apple 芯片（M1 或更新）。
• Linux。安装包提供 .deb 和 AppImage，建议使用 Ubuntu 22.04 或更新版本、x64 架构。

每一套 ComfyUI 安装大约需要 4.85 GB 磁盘空间。内存至少准备 8 GB，16 GB 使用起来更合适。之后下载的图片模型还会额外占用磁盘空间。

macOS

打开 dmg

• 拖进应用程序
• 首次去隐私与安全性
• 点仍要打开

Windows

运行 exe

• Windows 10 或更新
• x64 或 ARM64
• 欢迎页创建安装

Linux

deb 或 AppImage

• 建议 Ubuntu 22.04+
• x64
• 启动失败再看沙箱说明

安装并首次启动

进入 Comfy Desktop 下载页取得安装包，页面会自动识别你正在使用的系统。

macOS

1. 打开下载好的 .dmg。
2. 把 Comfy Desktop 拖进应用程序文件夹。
3. 从启动台或聚焦搜索打开 Comfy Desktop。

第一次启动时，macOS 可能会显示安全警告。此时打开系统设置中的 Privacy & Security（隐私与安全性），点击 Open Anyway（仍要打开）；这个按钮会允许系统启动刚刚被拦截的应用。

Windows

运行下载好的 .exe（NSIS 安装包），按照画面提示完成安装，然后从开始菜单或桌面快捷方式打开 Comfy Desktop。

第一次启动会进入欢迎画面，你可以在这里创建第一套 ComfyUI 安装。

Linux

Linux 使用通用下载链接。Debian 或 Ubuntu 用户进入安装包所在的下载目录，然后执行：

sudo apt install ./*.deb

使用 AppImage 时执行：

chmod +x ./*.AppImage
./*.AppImage

如果应用启动失败，可能是 Linux 发行版阻止了 Electron 沙箱。Ubuntu 24.04 及更新版本会通过 AppArmor 限制非特权用户命名空间。只有确认是沙箱启动失败时，才添加 --no-sandbox 重试。这个参数会关闭每个进程的 Electron 沙箱，不建议在其他情况下使用。

打开 Comfy Desktop 后，Chooser 页面会列出已有的安装实例。点击 New Instance 创建一套新的、彼此独立的 ComfyUI 安装，然后点击对应的实例卡片启动。

桌面版默认跟踪稳定版。如果希望跟随 GitHub 上的每个最新提交，可以改用便携版、手动 git 安装，或者把实例的更新频道改成 Latest on GitHub。

从 OmniProxy 取得连接参数

这里没有可以填写的通用地址、密钥或模型 ID。安装 Comfy Desktop 和完成基础文生图流程都不需要 OmniProxy。

不要把其他工具的 Base URL 填进来源不明确的节点。等出现明确的通用接入说明后，再单独进行配置。

填写工具配置

这里没有 OmniProxy 配置表。第一次出图需要先准备工作流和图片模型。

工作流可以理解为一套出图步骤，节点则是其中负责加载模型、接收文字或保存图片的操作模块。ComfyUI 启动后通常会自动载入默认的文生图工作流。

如果需要打开其他工作流，可以从菜单选择 Workflows → Open；这个选项用于载入包含工作流信息的图片或 JSON 工作流文件。

多数安装默认不带基础模型。载入工作流后，如果电脑里没有 v1-5-pruned-emaonly-fp16.safetensors，界面会提示缺少模型。点开警告后，可以查看缺少的模型及其下载链接。

要查看当前安装使用的模型目录，请点击顶部的胶囊菜单，再打开 Storage；这个入口用于查看模型等文件实际保存在哪里。顶部胶囊菜单只在桌面应用中提供。点击目录旁边的文件夹图标，可以直接在系统文件管理器中打开该目录。

模型有两种下载方式：

• 点击界面中的 Download；这个按钮会开始下载缺少的模型。桌面版会把模型保存到当前安装的 ComfyUI/models/checkpoints，下载进度可以在侧边栏的模型面板中查看。自动下载通常来自 Hugging Face，因此网络需要能够访问 Hugging Face。
• 如果长时间没有下载进度，可以在缺失模型的详情中复制下载链接，手动下载文件，并将其保存到同一个 checkpoints 目录，然后刷新或重启 ComfyUI。

模型放好后，按键盘 R，让界面重新读取节点中的模型列表。

应用

Comfy Desktop

• 它负责安装环境
• 欢迎页或新建实例
• 点卡片启动

工作流

文生图

• 通常会自动载入
• 也可以从菜单打开
• 缺模型会有警告

模型

checkpoints

• 按警告里的链接下
• 桌面版可自动保存
• 按 R 刷新列表

验证一个真实任务

准备好模型后，按以下步骤尝试第一次出图：

1. 在 Load Checkpoint 节点中选择 v1-5-pruned-emaonly-fp16.safetensors。这个节点负责载入本次出图要使用的模型。
2. 点击 Run，或按 Ctrl + Enter。Run 用来开始执行当前的出图任务。
3. 生成结果会显示在 Save Image 节点中。这个节点用于预览并保存最终图片，你可以右键把图片保存到本机。

如果 Load Checkpoint 中没有模型，或者下拉框显示 null，请先核对模型目录，再刷新或重启 ComfyUI。

截至 2026-10-09，已在 macOS 上确认从官方 dmg 取得的 Comfy Desktop 1.1.6 可以启动。由于还需要在应用中创建安装并下载检查点模型，第一次出图流程没有完成，因此这里不声称已经成功出图，也没有把 OmniProxy 接入 ComfyUI。

模型

下拉框有名字

• 不是 null
• 选中检查点
• 按 R 刷新过

生成

点 Run

• 或按 Ctrl+Enter
• 等节点跑完
• 图在 Save Image

边界

先不接网关

• 没有通用配置栏
• 不要装来路不明节点
• 出图成功即可

常见错误

• macOS 打不开：进入 系统设置 → 隐私与安全性，点击 仍要打开。安装包只支持 Apple 芯片和 macOS 13 或更新版本。
• Linux 一启动就退出：先确认使用的是 .deb 或 AppImage。只有确定为沙箱启动失败时，才添加 --no-sandbox。
• 提示缺少模型：通过警告中的链接下载检查点模型，保存到当前安装的 models/checkpoints，然后按 R 刷新。
• 模型下拉框显示 null：通过 Storage 核对模型目录，确认文件放置正确，再刷新或重启。
• 想在这里填写 OmniProxy：当前没有通用接入栏位。不要额外安装未被明确说明为通用接法的节点。

官方参考

安装总览见 Comfy Desktop。各平台的安装步骤见 macOS、Windows 和 Linux。桌面界面用法见 Using Comfy Desktop。第一次出图步骤见 Getting Started with AI Image Generation。

用你自己的 OmniProxy 配置替换每个占位符。不要发布真实密钥。

保存成功或 HTTP 200 不单独等同完整 Agent 兼容。请在 OmniProxy 调用记录中确认来源和模型。

官方来源 · ComfyUI ↗