基于nvidia/cuda:12.9.1-cudnn-devel-ubuntu24.04镜像，以build模式生成开发环境（预装python3.12、vscode中文语言包、aria2c下载工具等）。之后生成venv并预装torch 2.8.0+cu129、sageattention 2.2.0等库。预装部分ComfyUI热门插件，并提供基于Gradio的图形化下载工具。

目前转为从镜像启动。如需要每次启动重新构建docker环境可以自行修改 .cnb.yml 文件。

相关项目链接：ComfyUI 在线体验（飞桨AI Studio星河社区）

环境启动后会自动启动ComfyUI。如需关闭，终端中按Ctrl+c。

再次启动ComfyUI，终端输入 qd，回车运行。可添加其他启动参数，如 qd --use-sage-attention，启用sageattention。

注意：--listen、--auto-launch参数已内置，无需额外添加。 pip install -r /workspace/comfyui/custom_nodes/ComfyUI-VideoHelperSuite/requirements.txt --target=/workspace/lib export PYTHONPATH="/workspace/lib:$PYTHONPATH" qd --use-sage-attention

四种打开外链的方法（选一种即可）：

1. 环境启动后会自动解压生成venv并启动ComfyUI，会弹出一个对话框，点打开；
2. 点击右下角弹出的对话框中的在浏览器中打开；
3. 按住Ctrl键点击终端输出内容中的http://0.0.0.0:8188；
4. 在端口下，按住Ctrl键点击外部链接。

首先点击右下角 + 打开第二个终端，在新终端中输入 ui，回车运行，将自动打开下载工具界面。如需关闭，对应终端中按Ctrl+c。

Gradio下载工具界面：

预设下载模块中预置了一些模型的下载链接和存放路径，首先选择一级分类和二级分类，然后选择预设文件列表（可多选），最后点击开始下载或生成终端下载代码。

Aria2c和Wget模块均可自定义下载链接和保存路径，对于多数下载链接可以直接识别文件名，无法识别的需要手工输入。

注意：

1. 在工具内下载是有进度条的，但受网络影响，该进度条的刷新可能有延迟。如果想看完整的下载进度，建议生成终端下载代码后在新的终端内下载;
2. 预设下载模块中的文件链接收集于互联网（如AI Models），不可商用！不可商用！不可商用！

添加文件或文件夹（终端内运行）：

add 文件或文件夹的路径1 文件或文件夹的路径2 文件或文件夹的路径3 ...

例如（可在资源管理器内，右键文件或文件夹，复制路径）：

add /workspace/models .cnb.yml

删除文件或文件夹（终端内运行，谨慎操作！）：

del 文件或文件夹的路径1 文件或文件夹的路径2 文件或文件夹的路径3 ...

终端内运行：update

1. 为了在一定程度上降低仓库的lfs空间占用，这里从cnb-xu/package仓库，以submodule形式引入venv预装包。由于是固定内容的venv，后续自行安装的插件在重启环境后需要重新安装依赖；
2. 为什么不把venv直接做在仓库里：直接提交venv到仓库会导致ComfyUI-Impact-Pack插件无法启动，进而导致ComfyUI进程退出；
3. 预设下载中有的模型尽量不要提交到自己的仓库，需要时现下载。免费空间只有100+100GB，只要提交文件就会占用空间，后续即使删除文件，空间占用不会降低。需要释放仓库空间只能是删除仓库（注意下载备份重要文件！）。