3步轻松部署！ComfyUI容器化实战：从零开始的AI绘图工具Docker部署教程

ComfyUI-Docker是一个专注于AI绘图工具ComfyUI的容器化部署方案，通过Docker技术将ComfyUI及其依赖项打包成可移植容器，让新手也能轻松实现稳定扩散（Stable Diffusion）节点式GUI的快速部署。本文将详细介绍如何通过简单三步完成ComfyUI的Docker化部署，让你高效开启AI创作之旅。

一、环境准备清单：部署前的必要检查

在开始部署ComfyUI-Docker前，请确保你的系统满足以下基础要求：

• Docker环境：已安装Docker Engine（推荐版本20.10+），可通过docker --version命令验证安装状态
• 硬件支持：若需启用GPU加速（推荐），需确保已安装匹配的NVIDIA驱动和CUDA工具包
• 网络环境：稳定的互联网连接（用于拉取Docker镜像和依赖文件）

二、容器化部署实战：3步完成ComfyUI启动

1. 获取项目代码

打开终端，执行以下命令克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Docker
cd ComfyUI-Docker

2. 选择合适的镜像版本

项目提供多种镜像标签适配不同环境，主要分为以下几类：

• CUDA系列：如cu124-slim（轻量版）、cu128-megapak（完整功能版）
• CPU版：位于cpu/目录，适合无GPU环境
• ROCM版：如rocm7/目录下镜像，支持AMD显卡加速

3. 启动容器服务

以主流的cu124-slim镜像为例，执行以下命令启动容器：

docker run -it --rm --name comfyui \
--gpus all \
-p 8188:8188 \
-v "$(pwd)"/storage:/root/storage \
-e CLI_ARGS="" \
yanwk/comfyui-boot:cu124-slim

关键参数说明：

• --gpus all：启用所有GPU资源（仅NVIDIA显卡需要）
• -p 8188:8188：映射Web界面端口
• -v：挂载本地存储目录，保存生成的图片和模型文件

三、访问与使用：开启AI绘图之旅

容器启动成功后，打开浏览器访问 http://localhost:8188 即可进入ComfyUI的节点式编辑界面。系统默认提供基础工作流模板，你可以：

1. 通过左侧节点面板添加组件
2. 连接节点构建图像生成流程
3. 点击队列按钮开始渲染

项目配置文件位于各版本目录下的docker-compose.yml，可根据需要调整端口映射、环境变量等参数。启动脚本位于对应版本的runner-scripts/entrypoint.sh，高级用户可通过修改脚本实现自定义启动流程。

四、常见问题解决

• 镜像拉取缓慢：可尝试更换Docker镜像源或使用项目中的国内优化版本（如cu124-cn/目录下镜像）
• GPU不识别：检查nvidia-docker是否正确安装，或使用--gpus device=0指定具体GPU
• 存储空间不足：通过-v参数挂载更大容量的本地目录

通过Docker容器化部署ComfyUI，不仅简化了环境配置过程，还确保了跨平台运行的一致性。无论是AI绘图爱好者还是开发者，都能通过这个项目快速搭建专业的稳定扩散工作环境，开启你的创意之旅。