ComfyUI-Docker

一条命令拉起 ComfyUI，告别环境配置地狱

ComfyUI-Docker 是一个为 ComfyUI 提供容器化部署方案的开源项目，通过 Dockerfile 和启动脚本帮助用户快速搭建 Stable Diffusion 工作流环境。它解决了 ComfyUI 原生安装依赖复杂、环境配置繁琐、跨平台兼容性差的问题，核心能力包括预构建镜像、GPU 加速支持、自定义节点挂载、多版本切换等。用户只需拉取镜像并运行容器，即可获得开箱即用的 ComfyUI 服务，同时支持通过环境变量灵活配置资源限制和端口映射，适合本地开发、服务器部署以及云端迁移等场景。

开源 free 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1657

维护状态活跃

是否开源是

定价模式 free

项目数据

分类图像生成

开发团队YanWenKun

所属国家

官网地址https://hub.docker.com/r/yanwk/comfyui-boot

GitHubhttps://github.com/YanWenKun/ComfyUI-Docker

定价模式free

价格说明开源项目，提供Docker镜像与启动脚本，可自行部署，完全免费。

访问状态

是否开源是

开源协议NOASSERTION

主要语言Dockerfile

技术栈/模型comfyui,docker,stable-diffusion

GitHub 星标★ 1657

30天Star增速

HF 下载量

上线时间2023-03-17 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：进阶约 20 分钟部署方式：Docker 2 步

环境要求

已安装 Docker 引擎
NVIDIA GPU 与可用驱动
已安装 NVIDIA Container Toolkit（--runtime=nvidia）
磁盘预留足够空间存放模型与缓存

安装与启动步骤

1创建存储目录

在当前目录建立缓存、节点、模型与输入输出目录，用于挂载进容器实现数据持久化。

mkdir -p 
  storage-cache/dot-cache 
  storage-cache/dot-config 
  storage-nodes/dot-local 
  storage-nodes/custom_nodes 
  storage-models/models 
  storage-models/hf-hub 
  storage-models/torch-hub 
  storage-user/input 
  storage-user/output 
  storage-user/user-profile 
  storage-user/user-scripts

2启动容器

以 NVIDIA GPU 运行时启动镜像，映射 8188 端口并挂载全部目录；如权限不足请在命令前加 sudo。

docker run -it --rm 
  --name comfyui-cu130 
  --pull=always 
  --runtime=nvidia 
  --gpus all 
  -p 8188:8188 
  -v "$(pwd)"/storage-cache/dot-cache:/root/.cache 
  -v "$(pwd)"/storage-cache/dot-config:/root/.config 
  -v "$(pwd)"/storage-nodes/dot-local:/root/.local 
  -v "$(pwd)"/storage-nodes/custom_nodes:/root/ComfyUI/custom_nodes 
  -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/user-profile:/root/ComfyUI/user 
  -v "$(pwd)"/storage-user/user-scripts:/root/user-scripts 
  -e CLI_ARGS="" 
  yanwk/comfyui-boot:cu130-slim-v2

关键配置

配置项	必填	说明	示例
`-p 8188:8188`	是	映射 ComfyUI Web 服务端口到宿主机	`8188:8188`
`--gpus all`	是	把宿主机全部 GPU 暴露给容器	`all`
`--runtime=nvidia`	是	指定 NVIDIA 容器运行时以启用 GPU	`nvidia`
`-e CLI_ARGS`	否	传给 ComfyUI 的额外命令行参数
`yanwk/comfyui-boot:cu130-slim-v2`	是	镜像标签，CUDA 13.0 精简版	`cu130-slim-v2`

如何确认成功

容器日志无报错，浏览器访问 http://localhost:8188 能打开 ComfyUI 界面。

常见问题

Q：提示找不到 nvidia runtime 怎么办？

A：说明未安装 NVIDIA Container Toolkit，需先在宿主机安装该工具包，安装后重启 Docker 服务再执行启动命令。

Q：模型文件放哪里？

A：放进当前目录的 storage-models/models，它挂载到容器内 /root/ComfyUI/models，重启容器后模型仍在。

Q：端口被占用如何更换？

A：修改 -p 参数左边宿主机端口即可，例如 -p 8288:8188，容器内保持 8188 不变。

Q：自定义节点怎么持久化？

A：把节点放到 storage-nodes/custom_nodes，该目录挂载到容器内 ComfyUI/custom_nodes。

注意事项

首次运行 --pull=always 会拉取较大镜像，请保证网络与磁盘空间充足。
命令使用 --rm 参数，容器停止后会被删除，数据全靠挂载目录保留。
支持 CUDA 版本有限，需按 README 的 CUDA Compatibility 选择匹配的镜像标签。

核心亮点

预构建镜像，免去手动安装 Python 依赖和 CUDA 环境
支持 GPU 直通和自定义节点持久化挂载，开发调试高效
提供多版本标签，可快速切换 ComfyUI 版本或回滚

不足之处

镜像体积较大，首次拉取耗时较长
文档/社区待观察

适用场景

本地快速搭建 ComfyUI 开发环境
服务器或云主机部署 ComfyUI 服务供团队使用
需要隔离依赖或进行版本测试的 CI/CD 流程

替代项目

comfyui-windows-portable、ComfyUI-Manager、stable-diffusion-webui-docker

项目介绍

ComfyUI-Docker 是基础设施领域的开源项目，由 YanWenKun 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,657）位列前 30%，在基础设施分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,615 增加到 1,657，净增 42。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。提供Docker镜像与启动脚本，可自行部署，完全免费。

它主要面向的使用场景是：本地快速搭建ComfyUI开发环境。同类可对比的替代方案包括 comfyui-windows-portable、ComfyUI-Manager、stable-diffusion-webui-docker。

上一篇：tt-metal

下一篇：AI-Horde