优云智算
控制台
立即注册
0.02元/时

烟火ai

ComfyUI + MiniMax-H3 视频生成开箱即用:文生/首帧/参考生视频 + 图像生成,35 插件 68G 模型全预装,24G 显存起

镜像大小
120 GB
当前版本
v1.0
累计部署
1 次
累计运行
0 h
最近更新
2026-11-16

运行环境

框架版本
PyTorch-2.13.0
CUDA版本
13.2
应用
JupyterLab: 8888
自定义开放端口
8080
支持卡型
3090RTX50系
+6

镜像介绍

这是一个为 MiniMax H3 视频生成准备好的完整 ComfyUI 运行环境。MiniMax H3 的部署门槛主要在环境侧:底模、文本编码器、视频/音频 VAE、十几个专用 LoRA 分散在不同仓库,还要配套能跑动作控制的插件和对应的加速库。本镜像把这些一次性装齐并验证过,实例创建后服务会自动拉起,浏览器打开就能用。

镜像内置 ComfyUI 主程序 + 35 个可用插件 + H3 全套权重,Python 3.12 / PyTorch 2.13 + CUDA 13.2 环境已编译好对应架构,图像模型(FLUX.2、Qwen-Image 2.1、Krea2、MOSS、Z-Image)通过挂载平台共享模型盘自动接入,不额外占镜像体积。

对外访问走镜像内置的 Nginx 网关(Basic 鉴权 + 首次开机自动生成实例专属密码),ComfyUI 本体只监听 127.0.0.1:18188,不会裸奔在公网。镜像内置开机自启动与自愈守护:实例启动后无需任何操作,服务就绪;进程异常退出会自动拉起。

三种使用方式,任选其一:

方式适合谁需要什么
浏览器直连 ComfyUI熟悉 ComfyUI 的用户只需知道网关密码
配合「烟火AI」客户端一键连接不想碰命令行的用户Windows 客户端
只当 GPU 环境用想自己搭工作流的开发者无

功能特性

  • 开机即用:内置 /start.d 自启动入口,实例创建或重启后自动拉起 ComfyUI 与网关,无需执行任何命令
  • H3 全栈就绪:主底模 + 文本编码器 + 视频/音频双 VAE + 14 个专用 LoRA,缺失 0 项,开箱即用
  • 动作与运镜控制:内置 yanhuo_H3_Motion-Context_SelfLift 插件,支持动作连续性修复、运动强度滑块、SelfLift 二次采样与画质提升
  • 多档加速:pika 8 步、DMAD 4 步、lightx2v 4 步、fl2v turbo 4 步等多套加速 LoRA,24G 显存也能跑
  • 音频同步生成:内置 H3 音频 VAE,视频与音轨一次出
  • 图像模型零上传:FLUX.2-klein、Qwen-Image 2.1、Krea2、MOSS、Z-Image 挂载共享盘后自动软链,秒级可用
  • 自适应显卡:启动时读取显存与计算能力,显存不足自动加 --lowvram,并在日志中给出明确告警
  • 带鉴权的网关:8188 主端口 + 80 / 8080 备用,Basic 鉴权 + ?token= 免密(供图片、视频、WebSocket 使用)
  • 自愈守护:进程异常退出后 20 秒探活、自动重启,正在采样的任务不会被误杀

内置模型

随镜像打包(约 68G,不依赖共享盘)

类别内容
视频底模Cobijada H3 Hybrid int8(约 21G)
文本编码器qwen3vl_32b_minimax_h3 int8(约 27G)
加速 LoRApika 8step、DMAD 4step dareties v4、lightx2v turbo 4step、fl2v turbo 4step、DMAD rank39
画质 / 动作 LoRA增强画质 lms v1.0、Motion Repair V2、运动滑块、GunFu、Combat V2、VBVR Pro、Licon VBVR I2V
VAEminimax_h3 video vae int8、minimax_h3 audio vae fp32

上表这些是镜像内实体文件(合计约 68G,共 62 个),不经过共享盘。所以即使创建实例时忘记挂载模型盘,H3 的文生视频 / 首帧驱动链路依然能正常出片;但参考图(ref2va)模式和图像工作流依赖共享盘,见下节。

来自平台共享模型盘(挂载后自动软链,0 字节占用)

类别内容
H3 参考底模minimax_h3 ref2va pruned bf16(约 37G,可选)
图像模型FLUX.2-klein-9b-fp8、Qwen-Image 2.1 bf16、Krea2 turbo + 2 个 Moody 底模、MOSS Image bf16/int8、Z-Image turbo + VAE
配套编码器4 个 Qwen 文本编码器、Qwen VAE、H3 fp16 VAE

共享盘由平台提供(/model,只读),镜像内只放软链、0 字节占用。创建实例时务必勾选模型盘 / 共享模型库,否则这两组模型缺失:ref2va 参考模式与全部图像工作流会报「缺模型」(H3 文生 / 首帧仍可用)。软链在每次启动时自动重建,无需手工操作。

显存与配置建议

显卡配置结果说明
80G(A800 / A100 / H20)✅ 最好不拆模型,速度最快
48G RTX 40 系、32G RTX 50 系✅ 很好同上
24G(3090 / 4090)✅ 推荐下限镜像在该配置下完成全部验证
16G⚠️ 能跑但慢自动启用 --lowvram,速度约为 24G 的一半
8–12G⚠️ 很可能 OOM自动加 --reserve-vram,不保证成功
V100S(32G) / P40(24G) / 2080❌ 跑不了镜像为 CUDA 13.2 编译,仅含 sm_75/80/86/90/100/120;Volta(sm70)、Pascal(sm61) 会报 no kernel image

其他配置要求

  • 系统盘:≥ 100G(镜像本体约 75G,需留出输出文件与临时目录空间)
  • 内存:≥ 32G,推荐 16 核 96G(--lowvram 依赖内存换页,内存过小容易失败)
  • 模型盘:创建实例时勾选平台共享模型盘

使用教程

0. 部署镜像

  • 选择配置(推荐 RTX 4090 / 24G 显存)
  • 点击 立即部署,等待实例状态变为 运行中

1. 创建实例

在控制台选择本镜像创建 GPU 实例,显卡按上表选 24G 及以上,系统盘 100G,勾选共享模型盘。

2. 等待服务就绪(无需操作)

实例创建后服务会自动拉起,无需登录、无需执行命令。首次启动流程:

等待共享模型盘挂载 → 等待 GPU 就绪 → 拉起 ComfyUI → 装配 Nginx 网关 → 校验模型与节点

通常 1–2 分钟(实测 24–60 秒)。判断方式有两种:

  • 浏览器直接打开 http://<公网IP>:8188,能弹出登录框即已就绪;
  • 或 SSH 登录后查看启动日志:
cat /root/logs/autostart.log
# ... gateway_ready=1 waited=24s

首次调用图像模型 / ref2va 会慢一次,属正常。 这两组模型走共享盘软链,第一次要从网络存储冷读 10–40G 进页缓存, 可能要几十秒到几分钟,之后走缓存就正常了。H3 的文生 / 首帧链路读的是镜像内实体权重,不受影响。

兜底:若超过 5 分钟仍打不开,手动执行一次即可(幂等,不会重启正在跑的任务):

bash /root/yanhuo-up.sh

输出 就绪:GPU=... 节点=2792 耗时=...ms 模型盘=/model 表示服务可用。

3. 打开 ComfyUI

从控制台点「烟火AI」按钮会直接跳到本页,浏览器会弹出「登录以访问此站点」的英文对话框 —— 这是正常的网关鉴权,不是报错。 用户名固定 yanhuo,密码是实例专属网关密码,不是云实例的 SSH 密码(两者是两套凭据,填错会一直 401)。

浏览器访问:

http://<实例公网IP>:8188

弹出登录框时输入网关账号密码。用户名固定为 yanhuo,密码是该实例首次开机时随机生成的:

cat /root/.yanhuo/pass

用 SSH 登录时,密码也会直接打印在登录提示里:

[烟火AI] ComfyUI 已就绪
         用户名 yanhuo
         密码   3f9c1a7e2b8d4c60
         访问   http://<实例公网IP>:8188

8188 打不开时依次试 8080、80(网关同时监听这三个端口,绑不上的会自动跳过):

http://<实例公网IP>:8080
http://<实例公网IP>

三个端口走的是同一个网关、同一套账号密码,随便哪个能通都行。8188 是发布页声明的应用端口, 8080 是自定义开放端口,80 由平台默认放行。

开机后立刻登录却提示 401? 头几分钟密码可能还在被重写,SSH 里再 cat /root/.yanhuo/pass 一次, 用最后输出的值即可(详见常见问题)。

免密直达(把 token 拼进 URL,适合存书签):

http://<实例公网IP>:8188/?token=$(cat /root/.yanhuo/token)

控制台的 JupyterLab 按钮走 8888,可进容器查日志、改代码(token 由平台按实例注入,点按钮即进)。 不要把 ComfyUI 从 8888 启,统一走 8188 网关。

4.(可选)用「烟火AI」客户端一键连接

如果不想在浏览器里操作,可以用配套的 Windows 客户端:

  1. 打开客户端 → 顶栏切到 云端算力
  2. 粘贴平台给出的 SSH 指令(形如 ssh -p 23 root@1.2.3.4)和实例密码
  3. 点 连接云算力

客户端会自动登录实例、执行启动脚本、取回网关地址与凭据,并把实例登记为一个云后端。勾选「记住密码」后,实例重启可自动重连。

5. 实例重启 / 关机再开机

服务会随实例自动拉起,同样等待 1–2 分钟即可,不需要重新连接或重新配置。已生成的网关密码与令牌会保留在实例磁盘上,之前保存的访问方式继续有效。

只有一种情况需要手动介入:实例被「重置系统盘 / 更换镜像」后,密码会重新生成,需要重新 cat /root/.yanhuo/pass。

6. 常用自定义

# 修改网关密码(改完在客户端点「重连」即可取到新密码)
YANHUO_PASS='你的新密码' bash /root/yanhuo-setup-nginx.sh && nginx -s reload

# 查看 ComfyUI 日志
tail -f /root/logs/comfyui.log

# 手动重启 ComfyUI(不会影响 nginx)
bash /root/yanhuo-up.sh

放自己的模型到对应目录即可被 ComfyUI 识别:

类型目录
视频/图像底模/root/ComfyUI/models/diffusion_models/
文本编码器/root/ComfyUI/models/text_encoders/
VAE/root/ComfyUI/models/vae/
LoRA/root/ComfyUI/models/loras/
放大模型/root/ComfyUI/models/upscale_models/

环境验证

GPU 验证

nvidia-smi

框架验证

启动后执行以下检查,四项都通过即环境完好:

① 自启动是否生效

cat /root/logs/autostart.log
ls -l /start.d/

期望看到 gateway_ready=1,且 /start.d/10-yanhuo.sh 为 -rwxr-xr-x。

② 自检(推荐,一条命令看全貌)

bash /root/yanhuo-up.sh --json | python3 -m json.tool

期望输出(节选,数值随机器浮动):

{
  "ok": true,
  "port": 8188,
  "ports": [8188, 80, 8080],
  "user": "yanhuo",
  "comfyui_version": "0.44.0",
  "node_count": 2792,
  "gpu": "NVIDIA GeForce RTX 3090",
  "vram_mb": 24576,
  "compute_cap": "8.6",
  "model_root": "/model",
  "warnings": [],
  "missing_models": []
}

关键看两个字段:"missing_models": [] 表示模型齐全,"node_count" 接近 2792 表示插件全部加载成功。

③ 网关连通性

curl -s -o /dev/null -w '%{http_code}\n' \
  -u "$(cat /root/.yanhuo/user):$(cat /root/.yanhuo/pass)" \
  http://127.0.0.1:8188/system_stats

期望返回 200。返回 401 说明密码不匹配,重新执行 bash /root/yanhuo-setup-nginx.sh 修复。

④ 公网端口

在本地浏览器打开 http://<公网IP>:8188,能看到 ComfyUI 界面即通。连接超时通常是安全组未放行该端口。

检查项通过标准
自启动autostart.log 中 gateway_ready=1,/start.d/10-yanhuo.sh 可执行
服务启动日志出现 就绪:... 节点=2792
模型完整性missing_models 为空数组
插件加载node_count ≈ 2792
网关鉴权curl 返回 200,无凭据返回 401
公网访问浏览器能打开 ComfyUI 界面

常见问题

Q: 如何查看 GPU 是否正常识别?

A: 进入容器后运行 nvidia-smi 查看 GPU 状态。

Q: 如何持久化数据?

A: 挂载云盘或将结果下载到本地。 Q:浏览器打不开 8188,一直转圈或连接超时? 端口没放行。平台只放行「制作镜像时申报过的端口 + 22/23/80/443」,未申报的端口会被安全组直接丢弃(表现为超时,而不是拒绝)。可改用 http://<公网IP>(网关同时监听 80 端口),或在控制台安全组放行 8188。

Q:实例开机后还要执行启动命令吗? 不需要。镜像内置开机自启动,实例创建或重启后自动拉起服务,等 1–2 分钟直接访问即可。只有手动停过服务、或系统盘被重置时才需要执行 bash /root/yanhuo-up.sh。

Q:等了几分钟还是打不开,怎么排查?

cat /root/logs/autostart.log     # 看卡在哪一步:model disk / gpu / gateway_ready
cat /root/logs/comfyui.log       # 看 ComfyUI 自身报错
bash /root/yanhuo-up.sh          # 幂等,可直接重跑

autostart.log 里 model disk 缺失 → 实例没挂共享模型盘;gateway_ready=0 → 看 comfyui.log,多数是显存/内存不足。

Q:提示「还有 N 个模型没就位」/ 生成时报缺模型? 创建实例时没挂共享模型盘。共享盘上的文本编码器、ref2va 底模和图像模型都靠软链接入,缺盘就补不上。重建实例并勾选模型盘,或把缺失文件按上文目录手工上传。

Q:连接时提示「不是用本镜像创建的实例」? 实例里找不到 /root/ComfyUI 或 Python 环境,说明用的不是本镜像。请用本镜像重建实例。

Q:生成到一半任务消失 / 报 OOM? 显存或内存不足。24G 是推荐下限;16G 会自动降速,8–12G 不保证成功。另外内存低于 32G 时 --lowvram 缺少换页空间,也容易失败,建议选 16 核 96G 配置。

Q:V100 / P40 / 2080 为什么跑不了? 镜像基于 CUDA 13.2 编译,只包含 sm_75/80/86/90/100/120 的 kernel。Volta(sm70)和 Pascal(sm61)架构不在其中,加载模型时会直接报 no kernel image is available for execution on the device。这是架构限制,无法通过参数绕过。

Q:忘了网关密码怎么办?

cat /root/.yanhuo/pass

想直接换一个:

YANHUO_PASS='新密码' bash /root/yanhuo-setup-nginx.sh && nginx -s reload

Q:密码是照 /root/.yanhuo/pass 填的,还是 401?

开机后的头几分钟,pass 文件可能被重写多次(平台的启动流程会连调几次启动脚本),刚写入的几秒内读到旧值属于正常现象。SSH 里再执行一次 就好:

cat /root/.yanhuo/pass        # 以最后一次输出为准

也可以直接用 SSH 登录横幅里打印的密码。实在不行用免密链接绕开:

http://<公网IP>:8188/?token=$(cat /root/.yanhuo/token)

Q:打开界面后「工作流」列表是空的?

本镜像不预置工作流文件(避免把作者的测试工作流带出来)。推荐用「烟火AI」客户端连接,工作流由客户端下发;用原生 UI 的话,自己搭一个或把 .json 拖进画布即可,模型和插件都是齐的。

Q:启动日志里出现插件 IMPORT FAILED? 镜像已移除三个仅提供 Windows 编译版 nodes.pyd 的插件(TE-Speed-VOSR2 / SeedVR2 / MOSS),正常启动不应再有加载失败。若仍有报错,请贴出完整日志;个别插件缺依赖时可用 pip install 补装后重启。

Q:能直接连 8188 上的 ComfyUI 本体吗? 不能。ComfyUI 只监听 127.0.0.1:18188,公网访问必须经过 Nginx 网关(带鉴权)。网关已完整透传 WebSocket,进度与预览都正常。

Q:可以商用 / 二次分发这个镜像吗? 镜像内模型版权归各自作者所有,请遵守对应模型的许可协议(部分模型仅限非商业使用)。插件遵循各自开源协议。本镜像不提供任何模型授权,也不得将镜像内的模型权重单独提取、二次分发或用于商业转售。

0 个镜像 · 被使用 1 次
版本日志
v1.0最新
2026-11-13
ComfyUI + MiniMax-H3 视频生成开箱即用:文生/首帧/参考生视频 + 图像生成,35 插件 68G 模型全预装,24G 显存起
评分
0.0
暂无评分
我的评分
未评分
烟火ai一键部署 | 优云智算