michaelgold/comfy3d

Comfy3D Docker镜像文档

镜像概述

Comfy3D是一个基于ComfyUI的GPU加速容器化环境，专为高级3D工作流设计。该镜像将ComfyUI的可视化工作流能力与容器化技术结合，提供便捷、一致的运行环境，支持各类3D建模、渲染及相关任务的高效执行，简化复杂3D工作流的部署与管理。

核心功能和特性

• GPU加速：利用GPU资源显著提升3D处理性能，支持复杂场景的快速渲染和计算密集型任务
• 容器化部署：通过容器化技术简化环境配置，确保跨平台一致性，降低依赖管理复杂度
• ComfyUI集成：内置ComfyUI及其3D相关插件，支持可视化工作流设计、编辑与执行
• 开箱即用：预配置必要依赖组件，无需手动安装复杂软件栈，可快速启动3D工作流

使用场景和适用范围

• 3D建模与设计：支持复杂3D模型的创建、编辑、优化及细节处理
• 渲染与可视化：实现高质量3D场景渲染、实时预览及结果导出
• 动画制作：辅助3D动画序列的生成、调整、渲染与后期处理
• 研究与开发：为3D相关算法研究、模型训练提供稳定可控的实验环境
• 教育与培训：作为3D技术学习和教学的实践平台，降低环境配置门槛

使用方法和配置说明

基本部署（docker run）

bash
docker run -d --gpus all -p 8080:8080 --name comfy3d [镜像名称]

参数说明：

• --gpus all：启用GPU支持，确保容器可访问主机GPU资源
• -p 8080:8080：端口映射，将容器内ComfyUI服务端口映射到主机8080端口
• --name comfy3d：指定容器名称，便于后续管理操作

环境变量配置

可通过-e参数设置环境变量自定义运行配置：

bash
docker run -d --gpus all -p 8080:8080 \
  -e COMFYUI_PORT=8080 \
  -e MAX_MEMORY=16G \
  -e WORKFLOW_DIR=/app/workflows \
  --name comfy3d [镜像名称]

主要环境变量：

• COMFYUI_PORT：ComfyUI服务端口，默认8080
• MAX_MEMORY：最大内存使用限制（如16G），防止资源过度占用
• WORKFLOW_DIR：工作流文件存储路径，默认/app/workflows

数据持久化配置

为保存工作流文件和输出结果，可挂载本地目录：

bash
docker run -d --gpus all -p 8080:8080 \
  -v /本地工作流路径:/app/workflows \
  -v /本地输出路径:/app/outputs \
  --name comfy3d [镜像名称]

挂载说明：

• /本地工作流路径：本地存放工作流文件的目录，映射到容器内/app/workflows
• /本地输出路径：本地用于保存渲染结果的目录，映射到容器内/app/outputs

访问ComfyUI界面

部署完成后，通过浏览器访问 http://主机IP:8080 即可打开ComfyUI界面，开始创建和执行3D工作流。