备用安装：Comfy Desktop、macOS 与 Linux 手动安装

上一课的 Windows 便携包只是官方安装路线之一。如果你用 Mac 或 Linux，它帮不上忙；如果你想要一个「正常软件」式的体验——图形安装器、自动更新、多实例管理——那你需要的是官方桌面应用 Comfy Desktop，也就是中文圈常说的 ComfyUI 桌面版。官方 README 的原话：桌面应用是「新用户使用 ComfyUI 最简单、最好的方式」。

这节课把另外两条本地路线走通：Comfy Desktop 的下载、安装与首次设置（Windows / macOS / Linux 三平台），以及 macOS 与 Linux 的 git clone 手动安装；最后讲清楚装完怎么升级、能不能换路线。已经用便携包跑起来的同学不必重装——第 5 步会讲怎么把它纳入桌面版管理。

学完你能做什么

在 Windows、macOS（Apple Silicon）或 Linux 上装好 Comfy Desktop（ComfyUI 桌面版），并完成首次设置向导
看懂首次设置的每个选项：云端还是本地、三个勾选框、快速安装，以及给国内用户的中文镜像开关
用 git clone + pip 完成 ComfyUI 手动安装（macOS 与 Linux），按显卡装对 PyTorch
给每条路线升级：桌面版自动更新、实例 Update 标签、手动安装 git pull
说清四条安装路线（便携包 / 桌面版 / 手动 / 云端）怎么选、装过之后怎么换

你现在的困境

我是 Mac 或 Linux 用户，上一课的 Windows 便携包跟我没关系；搜「ComfyUI Mac 安装」「ComfyUI Linux 安装」，出来的教程各说各话，还都是好几年前的
想要个「正常软件」：双击安装器、能自动更新，不用每次去文件夹里找 .bat 再手动开浏览器
手动安装教程里 conda、PyTorch、CUDA 一堆词，不知道哪个是必须的；上次照着装，依赖全进了系统 Python，跟别的软件打架

什么时候用这一招

当你需要：

在 Mac（Apple Silicon）或 Linux 上安装 ComfyUI
一个带图形安装器、自动更新、快照管理的 ComfyUI 桌面版
完全掌控 Python 环境与启动参数；或在没有图形界面的 Linux 服务器上跑（桌面版明确不支持无界面服务器）
同时保留多个 ComfyUI 版本，按项目切换

而且不想：

被「装 Python → 配 CUDA → 装 PyTorch」的顺序绕晕
把依赖装进系统 Python，跟别的软件打架
每次升级都手动重下压缩包、重新解压

🎒 开始前的准备

读完上一课 ComfyUI 是什么：知道节点、连线、工作流是什么，装完打开界面不发懵
确认系统版本：桌面版要求 Windows 10 及以上 / macOS 13（Ventura）及以上 / Linux 推荐 Ubuntu 22.04 及以上
确认硬件：Mac 需 Apple Silicon（M1 及以后）；内存 8 GB 起步、官方推荐 16 GB；磁盘为每个实例留至少 4.85 GB
走手动安装路线的话：装好 Git，Python 用官方推荐的 3.13
一杯水 ☕

⚠️ 国内下载提示

ComfyUI 源码与模型多托管在 GitHub / Hugging Face，官方文档提到中国大陆用户可能需要配置代理才能稳定访问 GitHub 仓库。桌面版内置中文镜像开关（第 2 步），手动安装可以给 pip 换清华镜像（第 4 步）。

系统要求：桌面版与手动安装速查

项目	Comfy Desktop（桌面版）	手动安装（git clone）
Windows	Windows 10 及以上，x64 / ARM64	同样支持（Windows 用户还有上一课的便携包可走）
macOS	macOS 13（Ventura）及以上，Apple Silicon（M1 及以后）	Apple Silicon（M1–M4），官方说法是「较新的 macOS 版本」即可
Linux	推荐 Ubuntu 22.04 及以上，x64（.deb / AppImage）	任意能跑 Python 3.13 的发行版
内存 / 磁盘	8 GB 起步、官方推荐 16 GB；每个独立安装至少 4.85 GB	官方未单列（系统要求页只列平台、Python 版本与支持的显卡类型，没有内存/磁盘数字）
显卡	独显（NVIDIA / AMD）推荐，非必需；但 Windows 版桌面应用仅支持 NVIDIA CUDA 显卡（AMD/Intel 显卡的 Windows 用户请走便携包或手动安装）	NVIDIA / AMD（ROCm）/ Intel Arc / Apple Silicon 都行，无独显可 `--cpu`
管理员权限	Windows 安装不需要；macOS 首次系统级安装需要；Linux 装 `.deb` 要 sudo、AppImage 不要	按系统常规要求

Python 版本只有手动安装需要操心：官方推荐 3.13；3.14 能用但部分自定义节点可能有问题；3.12 是遇到依赖问题时的退路。桌面版不用你管 Python——它代管。

核心思路

Comfy Desktop 不是 ComfyUI 的另一个版本，而是一个「实例管理器」。 官方定义：一个让你从单一启动器安装、管理、启动多个 ComfyUI 实例的桌面应用。你不需要单独装 ComfyUI——Python 环境和依赖都交给它管；每个实例有独立的 ComfyUI 版本、自定义节点和设置，可以并存。

官方 FAQ 说得很直白：桌面版不取代便携包 / 手动安装，只是「对大多数用户推荐」的选项——因为省事，还带一键更新和快照管理。

注意一个新旧之别：网上老教程说的「桌面版」可能是旧版 Legacy Desktop（单实例应用）。现在的 Comfy Desktop 是完全重写的多实例管理器，官方提供从旧版迁移的通道。

手动安装是「自己搭环境」。 官方把步骤归纳为四步：建虚拟环境（避免污染系统 Python）→ 克隆代码仓库 → 装 GPU 版 PyTorch 与依赖 → python main.py 启动。桌面版和便携包把前三步藏起来了；手动安装就是亲手做一遍，换来对每一步的掌控。

四条路线一张表：

路线	适合谁	一句话
Windows 便携包（上一课）	Windows 用户，想最快跑起来	解压即用；官方 README 同时提醒：普通用户更推荐桌面应用
Comfy Desktop 桌面版（本课第 1–3 步）	想要图形安装器、自动更新、多实例管理	官方称对新用户「最简单、最好」
手动安装（本课第 4 步）	想完全掌控环境；无图形界面的 Linux 服务器	官方四步亲手搭
Comfy Cloud 云端	本机 GPU 不够强	云上运行，本机不装任何东西（本课不展开）

💡 不管哪条路，装的都是同一个 ComfyUI

节点界面、工作流、模型目录规则完全一样。装好之后放模型、出第一张图的步骤全站通用：模型放哪里。

跟我做

第 1 步：下载并安装 Comfy Desktop（ComfyUI 桌面版）

为什么：桌面版是官方推荐给新用户的路线，一个安装器把 ComfyUI、Python 环境、依赖全部代管。

按平台走：

方式 A：Windows（.exe 安装器）

打开官方下载页 https://comfy.org/download，页面会自动识别你的平台，下载 .exe 安装器
双击运行（NSIS 安装器），跟着提示走完
从开始菜单或桌面快捷方式启动 Comfy Desktop

你应该看到：Comfy Desktop 窗口打开，进入全屏的首次设置（第 2 步）。官方 FAQ 确认：Windows 上安装不需要管理员权限。

方式 B：macOS（.dmg，Apple Silicon）

在 https://comfy.org/download 下载 .dmg 文件
打开 .dmg，把 Comfy Desktop 拖进 Applications 文件夹
从启动台（Launchpad）或 Spotlight 启动

你应该看到：首次启动 macOS 可能弹安全警告——去 系统设置 → 隐私与安全性，点 仍要打开（Open Anyway） 放行。这是官方文档写明的正常流程。

方式 C：Linux（.deb 或 AppImage）

Linux 不走 comfy.org/download，用官方仓库页给的通用下载链接 https://dl.todesktop.com/241130tqe9q3y（自动识别平台，提供 .deb 与 AppImage 两种包）：

bash

# Debian / Ubuntu：在 .deb 文件所在目录执行
sudo apt install ./*.deb

# 或者 AppImage（不需要管理员权限）
chmod +x ./*.AppImage
./*.AppImage

你应该看到：Comfy Desktop 窗口打开，进入全屏的首次设置。

Comfy Desktop 已经能在我的系统上启动

⚠️ Linux 起不来先查两件事

官方文档给了两个常见原因：① AppImage 需要 FUSE 2——装一下：sudo apt install libfuse2；② Ubuntu 24.04+ 的 AppArmor 限制了 Electron 沙箱——此时可以加 --no-sandbox 重试，但官方警告该参数会禁用每个进程的 Electron 沙箱，只在沙箱启动失败时用。更多排查看装不上怎么办。

第 2 步：走完首次设置：云端还是本地、中文镜像

为什么：首次打开 Comfy Desktop 会进入一个全屏设置，问题不答完它不走；中途关掉应用，下次打开还是这个界面。

设置项逐个看：

设置项	怎么处理	说明
Cloud 还是 Local	本地运行选 Local	Local 在本机安装 ComfyUI：版本、自定义节点、启动参数都归你管，可离线运行；Cloud 在 Comfy Cloud 的 GPU 上跑，本机不装任何东西
EULA 与服务条款	必须勾	不勾无法继续
匿名使用数据	可选，默认已勾	官方声明：不收集工作流内容、提示词、生成媒体或个人信息；之后可在设置里改
测试版功能	可选，默认已勾	仅在开启数据共享时可用
Express Install（快速安装）	可选，默认不勾	勾上就跳过安装向导、按推荐设置直接装一个 Standalone 实例；不勾则先看到 ComfyUI 版本、安装位置、启动选项再写盘。勾选框下方会标出检测到的硬件，检测错了可以取消

两个细节：不选卡片时 Continue 是灰的，官方要你自己想清楚再选；检测到本机 GPU 不够强时，Cloud 卡片会带「Recommended for your hardware」徽标。装过旧版 Legacy Desktop 的话还会多一个 Migrate existing instance 勾选框（默认勾选），把工作流、模型、设置一并迁过来。

💡 国内用户：打开中文镜像

应用界面语言是中文时，首次设置会在 Continue 之后多问一句 Enable Chinese Mirrors? 选 Enable Mirrors，Git 仓库会从 gitcode.com 克隆、PyPI 包改走阿里云与腾讯镜像（替代 github.com 和 pypi.org）——官方说明这在大陆更快。选 Not now 保持默认也行，之后随时在设置里改（配置项叫 Use Chinese Mirrors (Git & PyPI)）。

点 Continue 后：

你应该看到：短暂的 Preparing your install…，随后 Local 路线进入安装进度（没勾 Express Install 会先走安装向导），完成的实例出现在仪表盘（Dashboard）上。

仪表盘上出现了我的第一个实例

第 3 步：启动实例，认识 Comfy Desktop 的日常操作

为什么：桌面版的日常就是「在仪表盘上管理实例」——启动、停止、升级都在实例卡片上。

装好的实例点卡片启动，ComfyUI 在独立窗口运行（官方 FAQ：多个实例可同时启动，各自有独立的 Python 环境）。三个常用操作：

操作	怎么做
停止实例（保留应用）	实例卡片上的 ⋮ 菜单 → Stop → 确认。停的是 ComfyUI Python 后端，桌面应用保持打开，随时可再启动
退出整个应用	左上角 ☰ 菜单 → Quit Desktop（或用系统常规退出方式）
新增实例	仪表盘上 New Instance：Standalone（全新安装、自带 Python）、Add Existing Instance（把 git clone 或上一课的便携包纳入管理）、Cloud（连接云端）

模型目录的规矩先记一条：桌面版各实例默认共享模型库，共享文件夹在 Desktop Settings → Storage 里配置。目录详解与多安装共享模型看模型放哪里。

你应该看到：点卡片后实例进入运行状态，ComfyUI 界面在独立窗口打开；实例卡片的 ⋮ 菜单里有 Stop，点了之后应用还在、实例停了。

我能启动、停止一个实例，并且知道 New Instance 在哪

第 4 步：手动安装 ComfyUI：git clone 加 pip（macOS 与 Linux）

为什么：想完全掌控环境、或在没有图形界面的 Linux 服务器上跑（桌面版 FAQ 明确说不支持 headless / 服务器模式），就走官方四步：建虚拟环境 → 克隆仓库 → 装依赖 → 启动。

Windows 手动安装官方同样支持，但有个前置条件：先装 Microsoft Visual C++ Redistributable。不过 Windows 用户已经有便携包和桌面版，一般不必走这条。

💡 还有个官方命令行工具 comfy-cli

官方文档同时提供 comfy-cli：pip install comfy-cli，然后 comfy install——用命令行装 ComfyUI 并代管依赖。本课以官方文档主推的 conda + git 流程为准，comfy-cli 留给喜欢命令行的你自行探索。

方式 A：macOS（Apple Silicon）手动安装

前提：装好 Git 和 Miniconda（官方用它创建独立 Python 环境）。

bash

# 1. 创建并进入虚拟环境（避免污染系统 Python）
conda create -n comfyenv
conda activate comfyenv

# 2. 克隆 ComfyUI 官方仓库
git clone https://github.com/Comfy-Org/ComfyUI.git

# 3. 装 PyTorch nightly（官方指定 Mac 走 nightly 版）
conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly

# 4. 装 ComfyUI 依赖并启动
cd ComfyUI
pip install -r requirements.txt
python main.py

你应该看到：终端最后输出 To see the GUI go to: http://127.0.0.1:8188，浏览器打开这个地址就是节点界面。想确认 Apple Silicon 的 GPU 加速（MPS）生效，再跑一行官方验证命令：

bash

python -c "import torch; print(torch.backends.mps.is_available())"

输出 True 即 Metal 加速可用。官方说明：Mac 上 ComfyUI 用的是 PyTorch 的 MPS（Metal Performance Shaders）后端，不用 Apple 的 MLX。

方式 B：Linux 手动安装（按显卡选 PyTorch）

第 1、2、4 步与 macOS 完全相同（conda 建环境、克隆仓库、装依赖启动），只有第 3 步要换成你显卡对应的 PyTorch：

bash

# NVIDIA（CUDA 13.0 稳定版）
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# AMD（ROCm 7.2 稳定版）
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# Intel Arc（XPU 后端；官方提醒：不要装 CUDA 版 wheel）
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

官方也提供 nightly 版 PyTorch（可能有性能改进，但官方自己标注「风险更高」），新手用上面的稳定版即可。然后：

bash

cd ComfyUI
pip install -r requirements.txt
python main.py

你应该看到：同样以 To see the GUI go to: http://127.0.0.1:8188 收尾，浏览器打开即节点界面。手动启动的 ComfyUI 按 Ctrl+C 或直接关终端窗口停止（官方 FAQ 原话）。

💡 国内用户：pip 换清华镜像

官方文档给出的方案：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple。git clone 慢或失败时，官方文档提到大陆用户可能需要配置代理才能稳定访问 GitHub 仓库。

终端出现 To see the GUI go to: http://127.0.0.1:8188，浏览器能打开节点界面

第 5 步：升级与换路线

为什么：ComfyUI 迭代很快，安装是一次性的，升级是长期的。

各路线升级方法对照（全部出自官方文档）：

路线	升级方法
Comfy Desktop 应用	自动检查更新，关不掉（启动后不久查一次，之后每 10 分钟一次）。标题栏出现 Desktop Update Ready 按钮时点它即可重启并安装；也可在 Desktop Settings → Updates 里手动 Check for updates
桌面版里的 ComfyUI 实例	与应用更新是两回事：用实例的 Update 标签，选 Stable 或 Latest on GitHub 通道
Linux `.deb` 安装的桌面版	应用内更新不适用——用通用下载链接重新下载，再 `sudo apt install ./*.deb`
手动安装	`cd <安装路径>/ComfyUI` 后 `git pull`，再 `pip install -r requirements.txt`。⚠️ 先确认虚拟环境已激活，否则依赖会装进系统 Python

换路线：便携包用户不必推倒重来——桌面版 New Instance → Add Existing Instance 官方支持把已有的便携包或 git clone 纳入管理；模型还能用 extra_model_paths.yaml 在多个安装之间共享，做法见模型放哪里。

你应该看到（以桌面版自动更新为例）：标题栏先显示 Downloading update…，就绪后变成 Desktop Update Ready，点它重启即装完——这正是官方描述的默认自动更新流程。

我知道自己的路线该怎么升级了

检查点 ✅

Comfy Desktop 能启动，仪表盘上出现了我的第一个实例
首次设置的每个选项我都看懂了；中文镜像开了或我知道去哪改
（手动路线）终端出现过 To see the GUI go to: http://127.0.0.1:8188，浏览器能打开节点界面
我知道自己的路线怎么升级：桌面版自动更新、实例 Update 标签、手动 git pull
我能说出自己适合四条路线中的哪条，以及装过之后怎么换

踩坑提醒

❌ macOS 首次打开 Comfy Desktop 弹安全警告，应用起不来

首次启动弹安全警告，是官方文档写明的正常现象，不是装坏了。解法：系统设置 → 隐私与安全性 → 仍要打开（Open Anyway）。还是起不来的话，官方 FAQ 建议去下载页确认拿到的是最新版本。

❌ Linux：AppImage 或 .deb 装完，应用打不开

两个官方列出的原因：缺 FUSE 2（AppImage 需要，sudo apt install libfuse2）；发行版拦截了 Electron 沙箱（Ubuntu 24.04+ 的 AppArmor 限制非特权用户命名空间），此时加 --no-sandbox 重试——注意官方警告：这个参数会禁用每个进程的 Electron 沙箱，只在沙箱启动失败时用。

❌ 手动安装没激活虚拟环境就 pip install

症状：依赖装进了系统 Python，跟其他软件打架；下次升级 pip install -r requirements.txt 还会装错地方。官方警告原话大意：装依赖前必须确认当前 Python 环境是 ComfyUI 虚拟环境。正确顺序：

bash

conda activate comfyenv   # 先激活
pip install -r requirements.txt   # 再装依赖

❌ 手动安装启动报 "Torch not compiled with CUDA enabled"

官方 README 的排错项：先把 torch 卸干净，再用对应显卡的命令重装。

bash

pip uninstall torch
# NVIDIA 示例：重装 cu130 稳定版
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

进阶技巧（可选）

🔧 桌面版自动建快照（Snapshots）：官方文档说明，快照在关键事件自动创建——每次启动 / 重启、更新前后、恢复后；内容是 ComfyUI 版本、自定义节点版本与全部 pip 包（不含模型、输入输出文件）。在实例的 Snapshots 标签可以浏览、恢复、导出、分享。更新失败时先手动建快照再重试，是官方给的建议。

🔧 Windows 桌面版更新后反复自动退出：官方确认 1.0.46 及更早版本有个 bug——更新下载没完成时，应用闪一下更新界面就自己关掉，而且每次启动都这样、来不及自修复。解法：手动下载最新 Windows 安装器（https://dl.todesktop.com/241130tqe9q3y/windows 或下载页）直接安装，不用先卸载旧版；实例、模型、设置都会保留。1.0.47 起已修复。

🔧 想彻底卸载桌面版：卸载应用只删启动器本体，实例、共享模型、设置和日志都留在磁盘上。官方文档列了各平台的残留目录：Windows 在 %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Installs、%APPDATA%\Comfy Desktop 等；macOS 在 ~/ComfyUI-Installs、~/Library/Application Support/Comfy Desktop 等；Linux 在 ~/.config/comfyui-desktop-2 等。要彻底清理，按官方对应平台页面逐个删。

🔧 没有「ComfyUI Docker 官方镜像」这回事：官方 FAQ 明确不提供官方 Docker 镜像；Docker Hub 上的社区镜像非官方维护、官方不支持，风险自负。服务器部署请走手动安装路线。

本课小结

✅ ComfyUI 桌面版（Comfy Desktop）你已经会装会用了：下载安装器 → 全屏首次设置（Cloud / Local、三个勾选框、中文镜像）→ 仪表盘上启动实例。

✅ macOS（Apple Silicon）与 Linux 用户你有两条路：桌面版（.dmg 拖进 Applications / .deb / AppImage），或 git clone + pip 手动安装——官方四步：conda 建环境、克隆仓库、按显卡装 PyTorch、python main.py。

✅ 升级路线你分清了：桌面版自动查更新（关不掉）、实例走 Update 标签、手动安装 git pull；便携包可以后期用 Add Existing Instance 纳入桌面版管理，不用推倒重来。

命令 / 地址	作用
`https://comfy.org/download`	Comfy Desktop 官方下载页（自动识别平台）
`https://dl.todesktop.com/241130tqe9q3y`	Linux 通用下载链接（.deb / AppImage）
`git clone https://github.com/Comfy-Org/ComfyUI.git`	手动安装：克隆 ComfyUI 源码
`conda create -n comfyenv` / `conda activate comfyenv`	创建 / 激活虚拟环境
`pip install -r requirements.txt`	安装 ComfyUI 依赖
`python main.py`	启动 ComfyUI（手动路线）
`git pull`	升级 ComfyUI 源码（手动路线）

下一课预告

装完不等于一帆风顺：装不上怎么办：安装与启动排错。

你会学到：

ComfyUI 启动失败、黑窗口一闪而过的排查顺序
127.0.0.1:8188 打不开、界面黑屏怎么办
显卡驱动相关的启动报错怎么处理
桌面版起不来时，日志文件去哪里找

已经顺利跑起来的同学，可以直接去模型放哪里放第一个模型，早点出图；出图全流程看第一次生图。

备用安装：Comfy Desktop、macOS 与 Linux 手动安装 ​

学完你能做什么 ​

你现在的困境 ​

什么时候用这一招 ​

🎒 开始前的准备 ​

系统要求：桌面版与手动安装速查 ​

核心思路 ​

跟我做 ​

第 1 步：下载并安装 Comfy Desktop（ComfyUI 桌面版） ​

方式 A：Windows（.exe 安装器） ​

方式 B：macOS（.dmg，Apple Silicon） ​

方式 C：Linux（.deb 或 AppImage） ​

第 2 步：走完首次设置：云端还是本地、中文镜像 ​

第 3 步：启动实例，认识 Comfy Desktop 的日常操作 ​

第 4 步：手动安装 ComfyUI：git clone 加 pip（macOS 与 Linux） ​

方式 A：macOS（Apple Silicon）手动安装 ​

方式 B：Linux 手动安装（按显卡选 PyTorch） ​

第 5 步：升级与换路线 ​

检查点 ✅ ​

踩坑提醒 ​

❌ macOS 首次打开 Comfy Desktop 弹安全警告，应用起不来 ​

❌ Linux：AppImage 或 .deb 装完，应用打不开 ​

❌ 手动安装没激活虚拟环境就 pip install ​

❌ 手动安装启动报 "Torch not compiled with CUDA enabled" ​

进阶技巧（可选） ​

本课小结 ​

下一课预告 ​

备用安装：Comfy Desktop、macOS 与 Linux 手动安装

学完你能做什么

你现在的困境

什么时候用这一招

🎒 开始前的准备

系统要求：桌面版与手动安装速查

核心思路

跟我做

第 1 步：下载并安装 Comfy Desktop（ComfyUI 桌面版）

方式 A：Windows（.exe 安装器）

方式 B：macOS（.dmg，Apple Silicon）

方式 C：Linux（.deb 或 AppImage）

第 2 步：走完首次设置：云端还是本地、中文镜像

第 3 步：启动实例，认识 Comfy Desktop 的日常操作

第 4 步：手动安装 ComfyUI：git clone 加 pip（macOS 与 Linux）

方式 A：macOS（Apple Silicon）手动安装

方式 B：Linux 手动安装（按显卡选 PyTorch）

第 5 步：升级与换路线

检查点 ✅

踩坑提醒

❌ macOS 首次打开 Comfy Desktop 弹安全警告，应用起不来

❌ Linux：AppImage 或 .deb 装完，应用打不开

❌ 手动安装没激活虚拟环境就 pip install

❌ 手动安装启动报 "Torch not compiled with CUDA enabled"

进阶技巧（可选）

本课小结

下一课预告