Ubuntu 上安装 ComfyUI（NVIDIA GPU / Conda / CUDA 12.1）

这份教程适用于UbuntuNVIDIA 显卡使用 Conda 管理环境使用 PyTorch CUDA 12.1从源码启动 ComfyUI一、准备条件开始前请确认已安装Anaconda或Miniconda电脑已正确安装NVIDIA 驱动终端里执行nvidia-smi能看到显卡信息系统可以正常访问 GitHub二、安装步骤1. 创建 Python 3.11 的 Conda 环境先创建一个专门给 ComfyUI 使用的环境conda create -n comfyenv python3.11 -y conda activate comfyenv2. 安装 MKL 兼容版本为了避免部分 PyTorch 环境出现库冲突先安装一个兼容版本的 MKLconda install -c conda-forge mkl2024.0.0 -y3. 安装 PyTorchCUDA 12.1 版本安装带 CUDA 12.1 支持的 PyTorch、torchvision 和 torchaudiopip install torch2.5.1 torchvision0.20.1 torchaudio2.5.1 --index-url https://download.pytorch.org/whl/cu1214. 克隆 ComfyUI 项目从 GitHub 下载 ComfyUI 源码git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI5. 安装 ComfyUI 依赖进入项目目录后安装依赖包pip install -r requirements.txt6. 启动 ComfyUI执行下面命令启动python main.py --listen 0.0.0.0 --port 8188启动成功后终端通常会显示本地访问地址例如http://127.0.0.1:8188然后在浏览器中打开这个地址即可使用 ComfyUI。三、安装完成后的检查可以先验证 PyTorch 是否正确识别 GPUpython -c import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())正常情况下应看到类似输出2.5.1cu121 12.1 True这表示PyTorch 安装成功CUDA 12.1 版本正确GPU 可用四、完整命令汇总下面是一套可直接执行的完整命令conda create -n comfyenv python3.11 -y conda activate comfyenv conda install -c conda-forge mkl2024.0.0 -y pip install torch2.5.1 torchvision0.20.1 torchaudio2.5.1 --index-url https://download.pytorch.org/whl/cu121 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI pip install -r requirements.txt python main.py五、常见问题1.torch.cuda.is_available()显示False说明当前 PyTorch 没有正确使用 GPU。常见原因有安装成了 CPU 版 PyTorchNVIDIA 驱动异常CUDA 对应版本不匹配建议先检查nvidia-smi如果能正常看到显卡再检查 PyTorchpython -c import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())2. 启动时报iJIT_NotifyEvent错误这类问题通常和 PyTorch 运行库、MKL 版本冲突有关。本教程中通过conda install -c conda-forge mkl2024.0.0 -y以及使用干净的 Python 3.11 环境通常可以解决。3. 端口被占用如果默认端口8188被占用可以kill掉这个占用的进程kill -9 $(lsof -t -i:8188)4. 自定义节点导致启动失败如果安装过自定义节点可能会引起冲突。可以先禁用所有自定义节点测试python main.py --disable-all-custom-nodes六、总结推荐安装流程如下创建干净的 Python 3.11 环境安装mkl2024.0.0安装torch 2.5.1 cu121克隆 ComfyUI安装 requirements启动python main.py这样配置后通常可以稳定在 Ubuntu NVIDIA GPU 环境下运行 ComfyUI。