ComfyUI + MiniMax-H3 视频生成开箱即用:文生/首帧/参考生视频 + 图像生成,35 插件 68G 模型全预装,24G 显存起
这是一个为 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 与网关,无需执行任何命令yanhuo_H3_Motion-Context_SelfLift 插件,支持动作连续性修复、运动强度滑块、SelfLift 二次采样与画质提升--lowvram,并在日志中给出明确告警8188 主端口 + 80 / 8080 备用,Basic 鉴权 + ?token= 免密(供图片、视频、WebSocket 使用)随镜像打包(约 68G,不依赖共享盘)
| 类别 | 内容 |
|---|---|
| 视频底模 | Cobijada H3 Hybrid int8(约 21G) |
| 文本编码器 | qwen3vl_32b_minimax_h3 int8(约 27G) |
| 加速 LoRA | pika 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 |
| VAE | minimax_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 |
其他配置要求
--lowvram 依赖内存换页,内存过小容易失败)立即部署,等待实例状态变为 运行中在控制台选择本镜像创建 GPU 实例,显卡按上表选 24G 及以上,系统盘 100G,勾选共享模型盘。
实例创建后服务会自动拉起,无需登录、无需执行命令。首次启动流程:
等待共享模型盘挂载 → 等待 GPU 就绪 → 拉起 ComfyUI → 装配 Nginx 网关 → 校验模型与节点
通常 1–2 分钟(实测 24–60 秒)。判断方式有两种:
http://<公网IP>:8188,能弹出登录框即已就绪;cat /root/logs/autostart.log
# ... gateway_ready=1 waited=24s
首次调用图像模型 / ref2va 会慢一次,属正常。 这两组模型走共享盘软链,第一次要从网络存储冷读 10–40G 进页缓存, 可能要几十秒到几分钟,之后走缓存就正常了。H3 的文生 / 首帧链路读的是镜像内实体权重,不受影响。
兜底:若超过 5 分钟仍打不开,手动执行一次即可(幂等,不会重启正在跑的任务):
bash /root/yanhuo-up.sh
输出 就绪:GPU=... 节点=2792 耗时=...ms 模型盘=/model 表示服务可用。
从控制台点「烟火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 网关。
如果不想在浏览器里操作,可以用配套的 Windows 客户端:
ssh -p 23 root@1.2.3.4)和实例密码客户端会自动登录实例、执行启动脚本、取回网关地址与凭据,并把实例登记为一个云后端。勾选「记住密码」后,实例重启可自动重连。
服务会随实例自动拉起,同样等待 1–2 分钟即可,不需要重新连接或重新配置。已生成的网关密码与令牌会保留在实例磁盘上,之前保存的访问方式继续有效。
只有一种情况需要手动介入:实例被「重置系统盘 / 更换镜像」后,密码会重新生成,需要重新 cat /root/.yanhuo/pass。
# 修改网关密码(改完在客户端点「重连」即可取到新密码)
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/ |
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:可以商用 / 二次分发这个镜像吗? 镜像内模型版权归各自作者所有,请遵守对应模型的许可协议(部分模型仅限非商业使用)。插件遵循各自开源协议。本镜像不提供任何模型授权,也不得将镜像内的模型权重单独提取、二次分发或用于商业转售。