sombi/comfyui
sombi
为RunPod平台设计的ComfyUI镜像，预安装自定义包，便于快速部署和运行AI工作流。
3 次收藏下载次数: 0状态：社区镜像维护者：sombi仓库类型：镜像最近更新：3 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ComfyUI-Docker-RP 镜像文档
一、镜像概述和主要用途
ComfyUI-Docker-RP 是一个预安装自定义组件包的 Docker 镜像，专为 RunPod 环境设计，旨在简化 ComfyUI 的部署流程。ComfyUI 是一款灵活的节点式 AI 图像生成工具，支持 Stable Diffusion 等模型的自定义工作流设计。本镜像通过预集成常用插件、模型及配置，使开发者和创作者可直接在 RunPod 平台快速启动 ComfyUI，无需手动处理环境依赖和组件安装。
二、核心功能和特性
2.1 预安装组件
- 集成 ComfyUI 核心框架及官方推荐插件（如 ComfyUI-Manager、ComfyUI-Impact-Pack 等）
- 预装常用 Stable Diffusion 模型（基础模型、LoRA、VAE 等，具体以镜像内置清单为准）
- 包含节点扩展库（如 ControlNet、IP-Adapter、风格迁移相关节点）
2.2 RunPod 环境适配
- 优化容器启动流程，适配 RunPod 容器生命周期管理
- 支持 RunPod 动态资源分配（CPU/内存/GPU），自动识别 GPU 型号并启用加速
- 兼容 RunPod 持久化存储（可挂载外部模型/工作流文件）
2.3 部署简化
- 零手动配置启动：镜像内置默认工作流，启动后直接访问 Web 界面即可使用
- 依赖自动管理：预解决 Python 依赖冲突，确保插件间兼容性
- 日志标准化：输出结构化日志，便于调试和问题定位
三、使用场景和适用范围
3.1 目标用户
- AI 创作者：无需配置环境，直接通过节点编辑器设计图像生成工作流
- 开发者：基于预配置环境快速扩展自定义节点或集成新模型
- 研究人员：在 RunPod 弹性算力环境中测试不同模型组合及参数
3.2 典型场景
- 快速部署 ComfyUI 进行 Stable Diffusion 图像生成、风格迁移、图生图等任务
- 基于 RunPod 高 GPU 算力运行大模型（如 SDXL）的复杂工作流
- 团队协作：通过持久化存储共享自定义模型和工作流配置
四、使用方法和配置说明
4.1 前置条件
- 已注册 RunPod 账号并创建包含 GPU 的 Pod（推荐 NVIDIA GPU，显存 ≥ 8GB）
- 本地或 RunPod 环境已安装 Docker（若手动部署）或直接使用 RunPod 容器服务
4.2 快速部署示例
4.2.1 Docker Run 命令（本地或 RunPod 手动部署）
bashdocker run -d \ --name comfyui-rp \ --gpus all \ -p 8188:8188 \ # ComfyUI 默认 Web 端口 -v /path/to/local/models:/app/ComfyUI/models \ # 挂载本地模型目录（可选） -v /path/to/workflows:/app/ComfyUI/workflows \ # 挂载自定义工作流（可选） somb1/comfyui-docker-rp:latest
4.2.2 RunPod 模板部署
在 RunPod 控制台选择 "Custom Container"，输入镜像地址 somb1/comfyui-docker-rp:latest，配置如下：
- 端口映射：
8188:8188 - 存储卷（可选）：挂载 RunPod 持久化存储至
/app/ComfyUI/models或/app/ComfyUI/outputs - 环境变量：按需添加（见 4.3 节）
4.3 配置参数与环境变量
4.3.1 核心参数
| 参数/环境变量 | 说明 | 默认值 |
|---|---|---|
--gpus | GPU 设备分配（Docker 参数） | all（使用所有 GPU） |
-p 8188:8188 | Web 端口映射 | 8188 |
MODEL_PATH | 自定义模型目录（环境变量） | /app/ComfyUI/models |
OUTPUT_DIR | 生成图像输出目录（环境变量） | /app/ComfyUI/outputs |
LOG_LEVEL | 日志级别（环境变量） | INFO |
4.3.2 持久化存储配置
通过 -v 挂载卷实现数据持久化（推荐在 RunPod 中使用）：
bash# 示例：挂载 RunPod 持久化存储至模型和输出目录 -v /runpod/storage/models:/app/ComfyUI/models \ -v /runpod/storage/outputs:/app/ComfyUI/outputs
4.4 访问与使用
- 容器启动后，通过
http://<Pod-IP>:8188访问 ComfyUI Web 界面（RunPod 可通过 "Connect" 按钮获取访问链接） - 预加载的工作流位于
/app/ComfyUI/workflows目录，可直接在界面中加载使用 - 生成的图像默认保存至
OUTPUT_DIR（可通过卷挂载持久化）
五、注意事项
- GPU 兼容性：需确保 RunPod Pod 配置的 GPU 支持 CUDA 11.7+（镜像依赖 CUDA 运行时）
- 模型大小：预安装模型可能占用较大存储空间，建议通过持久化卷挂载外部模型以节省容器空间
- 插件更新：如需更新内置插件，可通过 ComfyUI-Manager 插件在 Web 界面中操作，或重建容器时指定新版本镜像
如需获取完整插件清单、默认工作流示例及高级配置，可参考 https://github.com/somb1/ComfyUI-Docker-RP%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull sombi/comfyui:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"