ComfyPilotComfyPilot
文档 / 安装 / 手动安装 ComfyUI（Windows、macOS、Linux）

手动安装 ComfyUI（Windows、macOS、Linux）

在 Windows、macOS 或 Linux 上手动安装 ComfyUI：创建虚拟环境、克隆仓库、安装 GPU 依赖并启动应用。

安装 manual_install 更新于 2026-11-12

查看官方原文

手动安装 ComfyUI（Windows、macOS、Linux）

在 Windows、macOS 或 Linux 上手动安装 ComfyUI：创建虚拟环境、克隆仓库、安装 GPU 依赖并启动应用。

对于 ComfyUI 的安装， 主要分为几个步骤

  1. 创建一个虚拟环境(避免污染系统级 Python 环境)
  2. 克隆 ComfyUI 代码仓库
  3. 安装依赖
  4. 启动 ComfyUI

你也可以参考 ComfyUI CLI 来安装 ComfyUI, 它是一个命令行工具，可以方便地安装 ComfyUI 并管理其依赖。

（可选）创建虚拟环境

[!TIP] 独立的虚拟环境是必要的，因为 ComfyUI 的依赖可能会与系统上的其他依赖冲突，也可以避免对系统级 Python 环境的污染。

Install Miniconda. 这将帮助您安装 ComfyUI 所需的正确版本的 Python 和其他库。

使用 Conda 创建一个环境。

conda create -n comfyenv
conda activate comfyenv

克隆代码仓库

你需要保证你的系统上已经安装了 Git, 首先你需要打开终端（命令行）,然后克隆代码仓库。

[tab] Windows > [!WARNING] > > 如果你还没有安装 Microsoft Visual C++ Redistributable，请在这里安装
[tab] Linux 打开终端应用程序。
[tab] MacOS 打开终端应用程序。
git clone https://github.com/Comfy-Org/ComfyUI.git

安装GPU 及 ComfyUI 依赖

1. 安装 GPU 依赖

安装 GPU 依赖

[accordion] Nvidia `` pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 ` 或者，您可以安装 PyTorch 的 nightly 版本。 > [accordion] 安装 Nightly 版本 > > > [!WARNING] > > > > 安装 Nightly 版本（可能存在一定风险） > > ` > pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu132 > ``
[accordion] AMD Linux 上安装 ROCm 7.2 版本的 PyTorch： `` pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2 ` 或者，您可以安装 PyTorch 的 nightly 版本（ROCm 7.2）。 > [accordion] 安装 Nightly 版本 > > > [!WARNING] > > > > 安装 Nightly 版本（可能存在一定风险） > > ` > pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.2 > ` Windows 上请使用 AMD 的[多架构 PyTorch 软件包](https://rocm.docs.amd.com/projects/ai-ecosystem/en/latest/frameworks/pytorch/install.html)（ROCm 10.0）。device-* 附加项会自动安装对应 GPU 的内核和匹配的 ROCm 运行时，无需单独安装 HIP SDK。请使用 Windows 11、最新的 [AMD 显卡驱动](https://www.amd.com/en/support/download/drivers.html)和 64 位 Python 3.13。 下面的安装命令使用 device-all 安装所有受支持 GPU 的内核。如需减少下载体积和磁盘占用，可以选择将 **两处** device-all 替换为您 GPU 对应的目标： | GPU | 设备附加项 | | - | - | | RX 9070 / XT、Radeon AI PRO R9700 | device-gfx1201 | | RX 9060 / XT | device-gfx1200 | | RX 7900 XT / XTX | device-gfx1100 | | RX 7700 XT / 7800 XT | device-gfx1101 | | RX 7600 / XT | device-gfx1102 | | Ryzen AI Max / Max+（Strix Halo） | device-gfx1151 | > [!NOTE] > > 此表仅列出部分示例。表中未列出的 GPU 仍可能受支持：支持的架构包括 RDNA 2、RDNA 3、RDNA 3.5 和 RDNA 4。保留 device-all 可安装所有受支持目标的内核。其他型号请参阅 AMD 的 [GPU 目标表](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#gfx-target-lookup-table)和 [ROCm 兼容性矩阵](https://rocm.docs.amd.com/en/docs-10.0.0/compatibility/compatibility-matrix.html)。 ` pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ "torch[device-all]==2.13.0+rocm10.0.0" "torchvision[device-all]==0.28.0+rocm10.0.0" "torchaudio==2.11.0.2+rocm10.0.0" ``
[accordion] Mac ARM Silicon ``bash theme={null} conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly ``
[accordion] Intel Intel Arc GPU（Arc A 系列、Arc B 系列以及配备 Arc 显卡的 Core Ultra 处理器）可通过 PyTorch 原生 XPU 后端使用。Intel GPU 使用 XPU，而不是 CUDA。 `` pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu `` 请确保已安装并更新 Intel GPU 驱动程序。不要安装 CUDA wheel。如果 ComfyUI 仍无法检测到 GPU，请参阅 Intel GPU 故障排除。

2. 安装 ComfyUI 依赖

cd ComfyUI
pip install -r requirements.txt

3. 启动 ComfyUI

启动 ComfyUI

cd ComfyUI
python main.py

运行 python main.py --help 查看内置帮助，或参阅启动参数参考获取完整命令行选项列表。

如需高级服务器配置（自定义端口、局域网访问、VRAM 模式等），请参阅启动参数参考。

如何更新 ComfyUI

1. 拉取最新代码

使用命令行进入 ComfyUI 的安装路径，然后拉取最新代码。

cd <安装路径>/ComfyUI
git pull

2. 安装依赖

使用命令行进入 ComfyUI 的安装路径，然后安装依赖。

[!WARNING] 你需要确保当前的 Python 环境是 ComfyUI 的虚拟环境，否则依赖会安装到系统级 Python 环境，污染系统级 Python 环境。
    pip install -r requirements.txt

添加外部模型路径

如果你想要在 ComfyUI/models 之外管理你的模型文件，可能出于以下原因:

  • 你有多个 ComfyUI 实例，你想要让这些实例共享模型文件，从而减少磁盘占用
  • 你有多个不同的类型的 GUI 程序，如：WebUI, 你想要他们共用模型文件
  • 模型文件无法被识别或读取到

我们提供了通过 extra_model_paths.yaml 配置文件来添加额外模型搜索路径的方法。

不同 ComfyUI 版本配置文件位置

[tab] Portable 及自部署 对于便携版和手动安装的 ComfyUI版本，你可以在 ComfyUI 的根目录下找到 extra_model_paths.yaml.example 的示例文件 `` ComfyUI/extra_model_paths.yaml.example ` 复制并重命名为 extra_model_paths.yaml 来使用, 并保持在 ComfyUI 的根目录下, 路径应该是 ComfyUI/extra_model_paths.yaml` 你也可以在 这里 找到配置示例文件
[tab] Comfy Desktop 如果你使用的是 ComfyUI 桌面应用程序，点击桌面应用顶部的胶囊菜单，打开 存储（Storage） 标签页，在其中添加模型目录。胶囊菜单仅桌面应用内存在，浏览器访问的 Web 版没有此项 Comfy Desktop 胶囊菜单：显示模型目录设置的存储（Storage）标签页 或者通过下面的位置打开： > [tab] Windows > > `` > C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml > ` > [tab] macOS > > ` > ~/Library/Application Support/ComfyUI/extra_models_config.yaml > `` 对应的配置文件不应该被改变

配置示例

比如，你需要额外让 ComfyUI 识别的模型文件位于下面的文件夹:

📁 YOUR_PATH/
  ├── 📁models/
  |   ├── 📁 loras/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 checkpoints/
  |   │   └── xxxxx.safetensors
  |   ├── 📁 vae/
  |   │   └── xxxxx.safetensors
  |   └── 📁 controlnet/
  |       └── xxxxx.safetensors

那么你可以进行如下的配置来让 ComfyUI 识别到你设备上的模型路径

my_custom_config:
    base_path: YOUR_PATH
    loras: models/loras/
    checkpoints: models/checkpoints/
    vae: models/vae/
    controlnet: models/controlnet/

或者使用

my_custom_config:
    base_path: YOUR_PATH/models/
    loras: loras
    checkpoints: checkpoints
    vae: vae
    controlnet: controlnet
[!WARNING] 对于桌面版，请在原有配置路径下新增配置，而不覆盖掉安装过程中自动生成的路径配置，请在修改前备份对应的文件，这样在你配置错误时可以及时恢复

或者你也可以参考默认的 extra\_model\_paths.yaml.example 来配置，保存之后， 需要 重启 ComfyUI 才能生效。

下面是完整的原始的配置配置示例:

#Rename this to extra_model_paths.yaml and ComfyUI will load it


#config for a1111 ui
#all you have to do is change the base_path to where yours is installed
a111:
    base_path: path/to/stable-diffusion-webui/

    checkpoints: models/Stable-diffusion
    configs: models/Stable-diffusion
    vae: models/VAE
    loras: |
         models/Lora
         models/LyCORIS
    upscale_models: |
                  models/ESRGAN
                  models/RealESRGAN
                  models/SwinIR
    embeddings: embeddings
    hypernetworks: models/hypernetworks
    controlnet: models/ControlNet

#config for comfyui
#your base path should be either an existing comfy install or a central folder where you store all of your models, loras, etc.

#comfyui:
#     base_path: path/to/comfyui/
#     # You can use is_default to mark that these folders should be listed first, and used as the default dirs for eg downloads
#     #is_default: true
#     checkpoints: models/checkpoints/
#     clip: models/clip/
#     clip_vision: models/clip_vision/
#     configs: models/configs/
#     controlnet: models/controlnet/
#     diffusion_models: |
#                  models/diffusion_models
#                  models/unet
#     embeddings: models/embeddings/
#     loras: models/loras/
#     upscale_models: models/upscale_models/
#     vae: models/vae/

#other_ui:
#    base_path: path/to/ui
#    checkpoints: models/checkpoints
#    gligen: models/gligen
#    custom_nodes: path/custom_nodes

添加额外自定义节点路径

除了添加外部模型之外，你同样可以添加不在 ComfyUI 默认路径下的自定义节点路径

[!TIP] 请注意，这并不会改变自定义节点的默认安装路径，只是在启动 ComfyUI 时会增加额外的路径搜索，你仍旧需要在对应的环境中完成自定义节点的依赖的安装，来保证其运行环境的完整性。

下面是一个简单的配置示例（Mac 系统），请根据你的实际情况进行修改，并新增到对应的配置文件中，保存后需要 重启 ComfyUI 才能生效:

my_custom_nodes:
  custom_nodes: /Users/your_username/Documents/extra_custom_nodes

常见问题

[!NOTE] Docker： ComfyUI 不提供官方 Docker 镜像。若需在容器中运行 ComfyUI，可以使用 Docker Hub 上社区维护的镜像。这些镜像并非由 Comfy-Org 官方维护，也不受 ComfyUI 团队支持，请自行评估风险后使用。

如何停止/退出 ComfyUI

在运行 ComfyUI 的终端窗口中按 Ctrl+C，或直接关闭终端窗口。