ComfyUI Docker 镜像部署指南

一、项目简介

ComfyUI 是一款基于节点工作流的 Stable Diffusion 图形界面，支持通过可视化方式组合复杂的图像生成流程。

ComfyUI-BOOT 基于官方 ComfyUI 构建，内置：

Python 运行环境
PyTorch（按 CUDA / 架构区分）
ComfyUI 本体
启动与下载脚本

用于简化 ComfyUI 的部署与启动流程。

二、运行前准备

1. 系统与硬件要求

操作系统：Linux（推荐 Ubuntu 20.04+）
Docker：已安装并可正常运行（建议使用 Docker 20.10+ 以支持 --gpus 参数）
GPU（可选）：NVIDIA GPU（是否可用取决于 PyTorch 对该架构的支持）

注意：
CUDA 版本的可用性 由 PyTorch 官方预编译包决定，而非 NVIDIA 驱动或 CUDA Toolkit 本身。
即使系统未安装 CUDA Toolkit，也不影响使用对应 CUDA 标签的镜像。

2. 安装 Docker 环境

使用以下一键脚本快速部署 Docker 及相关组件（包含 Docker Engine、Docker Compose 等）：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

脚本执行完成后，通过以下命令验证 Docker 是否安装成功：

docker --version docker compose version

若输出 Docker 版本信息（如 Docker version 26.1.4, build 5650f9b），则说明安装成功。

3. 配置 Docker 服务

启动 Docker 服务并设置开机自启：

sudo systemctl enable --now docker

对于 NVIDIA GPU 用户，需安装 NVIDIA Container Toolkit 以支持 GPU 资源调度：

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit sudo systemctl restart docker

如需使用 NVIDIA GPU，请确保：

nvidia-smi

可正常输出显卡信息。

三、镜像准备

拉取 ComfyUI-BOOT 镜像

使用以下命令通过轩辕镜像访问支持域名拉取推荐版本的 ComfyUI-BOOT 镜像：

docker pull xxx.xuanyuan.run/yanwk/comfyui-boot:cu128-slim

说明：cu128-slim 为推荐标签，包含 CUDA 12.8 支持，适合新手使用。如需其他版本，可访问 ComfyUI-BOOT 镜像标签列表查看所有可用标签。

拉取完成后，通过以下命令验证镜像是否成功下载：

docker images | grep comfyui-boot

若输出类似以下内容，则说明镜像拉取成功：

xxx.xuanyuan.run/yanwk/comfyui-boot cu128-slim abc12345 2 weeks ago 15.2GB

四、快速开始（NVIDIA GPU）

1. 创建本地目录

该目录结构 与官方 README 保持一致：

mkdir -p storage storage-models/models storage-models/hf-hub storage-models/torch-hub storage-user/input storage-user/output storage-user/workflows

2. 启动容器

docker run -it --rm --name comfyui --gpus all -p 8188:8188 -v "$(pwd)"/storage:/root -v "$(pwd)"/storage-models/models:/root/ComfyUI/models -v "$(pwd)"/storage-models/hf-hub:/root/.cache/huggingface/hub -v "$(pwd)"/storage-models/torch-hub:/root/.cache/torch/hub -v "$(pwd)"/storage-user/input:/root/ComfyUI/input -v "$(pwd)"/storage-user/output:/root/ComfyUI/output -v "$(pwd)"/storage-user/workflows:/root/ComfyUI/user/default/workflows xxx.xuanyuan.run/yanwk/comfyui-boot:cu128-slim