MiniMax H3 的 ComfyUI 工作流已經(jīng)公開真正容易卡住的通常不是提示詞而是環(huán)境、模型目錄、端口和顯存。本文以一套預(yù)配置云端鏡像為例整理一條可重復(fù)的驗(yàn)收路徑先確認(rèn) GPU 和 PyTorch再確認(rèn)模型文件最后啟動(dòng)服務(wù)和排查 OOM。1. 環(huán)境與目標(biāo)使用的鏡像頁面https://suanjiayun.com/mirror/6a7ed4efa207ada5e3465db6截至 2026 年 8 月 15 日頁面標(biāo)注如下項(xiàng)目配置鏡像ComfyUI-v0.33.1-全能版-MiniMaxH3加速Ubuntu22.04.3 LTSCUDA12.8Python3.12鏡像大小37.28GB推薦顯存24GB推薦 GPURTX 4090自動(dòng)啟動(dòng)支持24GB 是鏡像頁面給出的推薦配置不代表所有時(shí)長(zhǎng)、分辨率和參考輸入都經(jīng)過驗(yàn)證。本文最終要驗(yàn)收五件事系統(tǒng)識(shí)別到 GPUPyTorch 能使用 CUDAMiniMax H3 所需模型文件在正確目錄ComfyUI 正在監(jiān)聽 8080 端口瀏覽器可以訪問并能提交基礎(chǔ)工作流。不要跳著查。按層排查出問題時(shí)比較容易知道是哪一塊。2. MiniMax H3 工作流由哪些模型組成ComfyUI 官方模板當(dāng)前引用了四類模型文件ComfyUI/ └── models/ ├── diffusion_models/ │ └── minimax_h3_fl2va_pruned_int8_convrot.safetensors ├── text_encoders/ │ └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors └── vae/ ├── minimax_h3_video_vae_fp16.safetensors └── minimax_h3_audio_vae_fp32.safetensors幾個(gè)文件的職責(zé)不同diffusion_modelsH3 的主擴(kuò)散模型text_encoders理解提示詞和多模態(tài)上下文的文本編碼器video_vae視頻潛空間的編碼與解碼audio_vae音頻潛空間的編碼與解碼。這不是傳統(tǒng)的“一個(gè) checkpoint 全包”結(jié)構(gòu)。工作流能打開不代表模型一定齊模型文件存在也不代表放在了 ComfyUI 能識(shí)別的目錄。3. 創(chuàng)建實(shí)例后先做只讀檢查進(jìn)入 WebSSH先不要升級(jí) CUDA、PyTorch 或 ComfyUI。記錄系統(tǒng)信息cat/etc/os-releasepython--versionconda info--envs查看磁盤空間df-h查看當(dāng)前目錄pwd預(yù)配置鏡像出問題以后最怕沒有原始環(huán)境記錄。至少先把上面幾條命令的結(jié)果留一下后面如果升級(jí)依賴失敗還知道原來是什么狀態(tài)。4. 驗(yàn)收 GPU 和 PyTorch先檢查 NVIDIA 驅(qū)動(dòng)層nvidia-smi重點(diǎn)看四項(xiàng)GPU 型號(hào)是否符合創(chuàng)建實(shí)例時(shí)的選擇顯存總量是否正常是否已有 Python 進(jìn)程占用顯存驅(qū)動(dòng)是否正常返回而不是command not found或通信失敗。然后進(jìn)入鏡像環(huán)境conda activate comfyenv執(zhí)行 PyTorch 檢查python -PY import torch print(torch_version:, torch.__version__) print(torch_cuda_version:, torch.version.cuda) print(cuda_available:, torch.cuda.is_available()) print(device_count:, torch.cuda.device_count()) if torch.cuda.is_available(): print(device_name:, torch.cuda.get_device_name(0)) free_bytes, total_bytes torch.cuda.mem_get_info(0) print(free_vram_gb:, round(free_bytes / 1024**3, 2)) print(total_vram_gb:, round(total_bytes / 1024**3, 2)) PY最低驗(yàn)收條件cuda_available: True device_count: 1 device_name: 實(shí)際 GPU 型號(hào)如果nvidia-smi正常但torch.cuda.is_available()為False優(yōu)先檢查當(dāng)前是不是comfyenvpython和pip是否來自同一環(huán)境PyTorch 是否為 CUDA 版本最近有沒有手動(dòng)升級(jí)過 PyTorch?？梢岳^續(xù)執(zhí)行whichpythonpython-mpip--version兩條路徑應(yīng)該落在同一個(gè) Conda 環(huán)境中。5. 核對(duì)模型文件和目錄進(jìn)入 ComfyUI 目錄cd~/ComfyUI2/dev/null||cdComfyUI分別檢查三個(gè)目錄ls-lhmodels/diffusion_models/ls-lhmodels/text_encoders/ls-lhmodels/vae/也可以一次查找 H3 相關(guān)文件findmodels-typef\(\-nameminimax_h3*.safetensors-o\-nameqwen3vl_32b_minimax_h3*.safetensors\\)-printf%p\n預(yù)期至少能找到models/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors models/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors models/vae/minimax_h3_video_vae_fp16.safetensors models/vae/minimax_h3_audio_vae_fp32.safetensors如果文件存在但工作流下拉框仍然找不到按順序處理檢查文件是否多套了一層目錄檢查文件名大小寫檢查下載文件是否為異常的小文件重啟 ComfyUI讓它重新掃描模型目錄。可以查看四個(gè)文件實(shí)際占用du-h\models/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors\models/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors\models/vae/minimax_h3_video_vae_fp16.safetensors\models/vae/minimax_h3_audio_vae_fp32.safetensors不要只看文件名。下載中斷后留下的同名小文件也會(huì)讓工作流加載失敗。6. 使用鏡像腳本管理 ComfyUI鏡像提供了統(tǒng)一的控制腳本。查看幫助./sj-run.sh-h啟動(dòng)./sj-run.sh-s停止./sj-run.sh-t重啟./sj-run.sh-r如果鏡像已經(jīng)自動(dòng)啟動(dòng)不要連續(xù)執(zhí)行多次啟動(dòng)命令。先查進(jìn)程ps-ef|grep[p]ython.*main.py再查端口ss-lntp|grep:8080如果能看到 Python 進(jìn)程和 8080 監(jiān)聽說明服務(wù)端已經(jīng)起來。此時(shí)瀏覽器打不開多半要查平臺(tái)端口映射而不是繼續(xù)折騰 Python 環(huán)境。7. 手動(dòng)啟動(dòng)與本機(jī)連通性檢查鏡像腳本啟動(dòng)失敗時(shí)可以先停掉已有進(jìn)程再手動(dòng)運(yùn)行./sj-run.sh-tconda activate comfyenvcd~/ComfyUI2/dev/null||cdComfyUI python main.py--listen0.0.0.0--port8080--enable-cors-header這個(gè)終端先別關(guān)直接看最后幾十行輸出。另開一個(gè) WebSSH 終端測(cè)試本機(jī)訪問curl-I--max-time5http://127.0.0.1:8080/判斷方法本機(jī)能訪問、外部打不開檢查平臺(tái)端口暴露和外部地址本機(jī)也打不開、沒有端口監(jiān)聽ComfyUI 沒有正常啟動(dòng)端口存在但頁面異常查看啟動(dòng)終端的 Python 報(bào)錯(cuò)和前端資源錯(cuò)誤。--listen 0.0.0.0會(huì)讓服務(wù)監(jiān)聽所有網(wǎng)卡--enable-cors-header會(huì)放寬跨域訪問。拿到的公網(wǎng)地址不要隨便發(fā)到公開群里尤其是工作流里包含私有素材時(shí)。8. 導(dǎo)入工作流后的第一輪參數(shù)MiniMax H3 官方模板說明中原生畫布以 768 像素短邊為主寬高需要是 32 的倍數(shù)示例上限為 768×1344。視頻按 24fps 處理時(shí)長(zhǎng)還會(huì)被換算成滿足模型幀塊規(guī)則的長(zhǎng)度。首次運(yùn)行建議按這個(gè)順序保留模板默認(rèn)模型文件先跑較短時(shí)長(zhǎng)先用較低分辨率不同時(shí)掛多個(gè)輔助模型第一次只驗(yàn)證一個(gè)輸入路徑成功后再增加首尾幀、參考圖或參考視頻。這里不直接給“24GB 必須使用某組固定參數(shù)”因?yàn)椴煌姹镜墓?jié)點(diǎn)、模型量化和工作流結(jié)構(gòu)會(huì)改變峰值顯存。沒有實(shí)際運(yùn)行記錄時(shí)寫死一個(gè)萬能參數(shù)反而容易誤導(dǎo)。9. 運(yùn)行時(shí)記錄顯存峰值提交任務(wù)前先開一個(gè)監(jiān)控終端nvidia-smi --query-gputimestamp,name,memory.used,memory.free,utilization.gpu\--formatcsv-l1觀察這些階段模型加載前文本編碼器加載后采樣開始時(shí)VAE 解碼時(shí)任務(wù)結(jié)束后。如果想把結(jié)果留檔nvidia-smi --query-gputimestamp,name,memory.used,memory.free,utilization.gpu\--formatcsv-l1|teeh3-gpu-monitor.csv任務(wù)完成后按CtrlC停止。這份 CSV 比“4090 大概能跑”有用得多。后面調(diào)整分辨率、時(shí)長(zhǎng)或參考輸入時(shí)可以直接對(duì)比峰值顯存有沒有變化。10. OOM 怎么排查常見錯(cuò)誤包括CUDA out of memory或者進(jìn)程直接被系統(tǒng)終止。先執(zhí)行nvidia-smi確認(rèn)是否有其他進(jìn)程占用顯存。然后按這個(gè)順序減負(fù)降低輸出分辨率縮短視頻時(shí)長(zhǎng)減少參考輸入關(guān)閉同時(shí)加載的其他模型重新啟動(dòng) ComfyUI釋放殘留顯存仍然不夠再考慮更大顯存的 GPU。不要一看到 OOM 就重裝 CUDA。OOM 首先是資源問題不是安裝問題。如果任務(wù)結(jié)束后顯存長(zhǎng)期不釋放可以重啟服務(wù)./sj-run.sh-r再用nvidia-smi確認(rèn)占用是否回落。11. 缺節(jié)點(diǎn)、版本沖突怎么處理工作流出現(xiàn)紅色節(jié)點(diǎn)時(shí)先記錄缺失節(jié)點(diǎn)的準(zhǔn)確名稱不要直接把所有組件升級(jí)到最新版。建議保存當(dāng)前環(huán)境conda activate comfyenv python-mpip freezerequirements-before-change.txt記錄當(dāng)前 ComfyUI 提交cd~/ComfyUI2/dev/null||cdComfyUIgitrev-parse HEAD然后只處理缺失項(xiàng)。預(yù)配置鏡像里ComfyUI、PyTorch、自定義節(jié)點(diǎn)和前端往往已經(jīng)形成一套可運(yùn)行組合。一次升級(jí)四五個(gè)組件最后即使修好了也不知道到底是哪一步起作用如果壞了同樣不知道該回退誰。12. 頁面打不開時(shí)的排障表現(xiàn)象優(yōu)先檢查常見原因nvidia-smi失敗GPU/驅(qū)動(dòng)層實(shí)例異常或驅(qū)動(dòng)不可用PyTorch 返回 CUDA FalseConda/PyTorch 層環(huán)境選錯(cuò)、CPU 版 PyTorch、依賴被覆蓋模型下拉框?yàn)榭瘴募游募笔?、目錄錯(cuò)誤、未重啟掃描8080 無監(jiān)聽ComfyUI 進(jìn)程層啟動(dòng)報(bào)錯(cuò)、進(jìn)程退出、端口被改本機(jī)能訪問公網(wǎng)不能平臺(tái)網(wǎng)絡(luò)層端口未暴露、外部 URL 不正確運(yùn)行中 OOM工作流資源層分辨率、時(shí)長(zhǎng)、參考輸入或其他進(jìn)程占用過高生成后磁盤爆滿存儲(chǔ)層視頻輸出、緩存和模型持續(xù)增長(zhǎng)這張表基本就是整篇文章最重要的部分。13. 數(shù)據(jù)保存和關(guān)機(jī)邊界視頻模型的磁盤增長(zhǎng)很快除了模型文件還有輸入素材、預(yù)覽緩存和最終視頻。建議至少定期檢查du-sh~/ComfyUI/models2/dev/nulldu-sh~/ComfyUI/input2/dev/nulldu-sh~/ComfyUI/output2/dev/null同時(shí)注意關(guān)機(jī)停止的是 GPU 實(shí)例計(jì)算擴(kuò)容數(shù)據(jù)盤不一定隨之停止計(jì)費(fèi)。實(shí)例釋放、數(shù)據(jù)盤保留和自動(dòng)釋放周期也應(yīng)以平臺(tái)最新幫助文檔為準(zhǔn)。重要內(nèi)容建議單獨(dú)保存工作流 JSON使用過的提示詞自定義節(jié)點(diǎn)清單requirements-before-change.txt模型文件名與來源生成結(jié)果顯存監(jiān)控 CSV。有這些東西換實(shí)例以后才有可能快速恢復(fù)。只保存一張工作流截圖基本沒用。14. 最小驗(yàn)收清單完成下面這些再開始調(diào)正式任務(wù)nvidia-smi能識(shí)別正確 GPUtorch.cuda.is_available()返回True四類 H3 模型文件可以找到ComfyUI 進(jìn)程存在8080 端口正在監(jiān)聽瀏覽器可以進(jìn)入頁面基礎(chǔ)工作流可以提交音頻和視頻結(jié)果可以保存已記錄一次顯存峰值工作流與重要結(jié)果已經(jīng)備份。FAQRTX 4090 的 24GB 顯存能跑 MiniMax H3 嗎該鏡像推薦 24GB 顯存和 RTX 4090適合作為基礎(chǔ)工作流的起點(diǎn)。具體能否完成某組參數(shù)要看分辨率、時(shí)長(zhǎng)、參考輸入和工作流中同時(shí)加載的模型。官方說支持 2K本地工作流為什么從 768 短邊開始2K 是 MiniMax 公布的模型能力上限ComfyUI 官方模板對(duì)本地工作流的原生畫布、尺寸倍數(shù)和時(shí)長(zhǎng)換算有單獨(dú)說明。模型上限不能直接當(dāng)作 24GB 顯卡的默認(rèn)參數(shù)。頁面打不開是否需要重裝 ComfyUI先查進(jìn)程、8080 端口和平臺(tái)端口映射。很多頁面打不開的問題發(fā)生在網(wǎng)絡(luò)暴露層重裝 ComfyUI 不會(huì)解決。模型文件都在為什么工作流還是找不到重點(diǎn)檢查目錄、文件名、文件完整性以及 ComfyUI 是否重新掃描。模型放在models根目錄而不是對(duì)應(yīng)子目錄也可能無法識(shí)別。是否應(yīng)該馬上升級(jí)到最新版 ComfyUI能運(yùn)行時(shí)不建議盲目升級(jí)。先保存當(dāng)前依賴和 Git 提交再針對(duì)具體缺失節(jié)點(diǎn)或兼容問題做最小修改。參考資料MiniMax H3 官方介紹https://minimaxi.com/blog/minimax-h3ComfyUI 官方 MiniMax H3 工作流https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_minimax_h3_t2v.json算家云 MiniMax H3 鏡像https://suanjiayun.com/mirror/6a7ed4efa207ada5e3465db6