ComfyUI-Nvidia-Docker 镜像使用说明

来源与基础文件

本文档内容基于 GitHub 仓库 mmartial/ComfyUI-Nvidia-Docker 的手动构建镜像。仓库中包含 Dockerfile 和项目 README.md，可直接查看完整配置细节。

快速运行命令

通过以下命令可快速启动容器：

bash
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" 标签

镜像的 latest 标签会随版本更新（如 Ubuntu 系统或 CUDA 版本升级），可能导致已安装的 custom_nodes 出现 "Import Failed" 错误。此时需通过 ComfyUI-Manager 的 "Try Fix" 功能修复节点，该操作通常在每次 latest 标签对应 Ubuntu+CUDA 版本变更时执行一次。

为避免因 latest 标签自动更新系统/驱动版本带来的问题，建议手动指定具体镜像标签。各标签信息如下：