
mmartial/comfyui-nvidia-docker本文档内容基于 GitHub 仓库 mmartial/ComfyUI-Nvidia-Docker 的手动构建镜像。仓库中包含 Dockerfile 和项目 README.md,可直接查看完整配置细节。
通过以下命令可快速启动容器:
bashdocker run --rm -it --runtime nvidia --gpus all -v `pwd`/run:/comfy/mnt -v `pwd`/basedir:/basedir -e WANTED_UID=`id -u` -e WANTED_GID=`id -g` -e BASE_DIRECTORY=/basedir -e SECURITY_LEVEL=normal -p 127.0.0.1:8188:8188 --name comfyui-nvidia mmartial/comfyui-nvidia-docker:latest
注意:命令中的挂载目录(-v)和环境变量(-e)配置细节,需参考仓库的 "Running the container" 章节,根据实际需求调整。
basedir/models 文件夹。basedir/output 文件夹。镜像的 latest 标签会随版本更新(如 Ubuntu 系统或 CUDA 版本升级),可能导致已安装的 custom_nodes 出现 "Import Failed" 错误。此时需通过 ComfyUI-Manager 的 "Try Fix" 功能修复节点,该操作通常在每次 latest 标签对应 Ubuntu+CUDA 版本变更时执行一次。
为避免因 latest 标签自动更新系统/驱动版本带来的问题,建议手动指定具体镜像标签。各标签信息如下:
| 标签 | 别名 | 备注 |
|---|---|---|
| ubuntu22_cuda12.3.2-latest | - | - |
| ubuntu22_cuda12.4.1-latest | - | - |
| ubuntu24_cuda12.5.1-latest | - | latest 标签截至 20250320 版本 |
| ubuntu24_cuda12.6.3-latest | latest | 20250413 版本起的 latest 标签,推荐 GTX 10xx 硬件使用 |
| ubuntu24_cuda12.8-latest | - | Blackwell 硬件(含 RTX 50xx)的最低需求版本(详见仓库 "Blackwell support" 章节) |
| ubuntu24_cuda12.9-latest | - | - |
| ubuntu24_cuda13.0-latest | - | - |
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务