本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

本文档内容基于 GitHub 仓库 mmartial/ComfyUI-Nvidia-Docker 的手动构建镜像。仓库中包含 Dockerfile 和项目 README.md,可直接查看完整配置细节。
通过以下命令可快速启动容器:
docker 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 | - | - |
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429