TRELLIS 2 ComfyUI：完整安装与工作流指南（2026）

环境要求

硬件要求

软件要求

• Python 3.10 或 3.11
• PyTorch 2.1+ 配合 CUDA 12.1+
• ComfyUI（最新版本）
• Git 用于克隆仓库
• NVIDIA 驱动 525+

安装步骤

TRELLIS 2 有两个主要的 ComfyUI 自定义节点。本指南同时介绍两种方案。

方案 A：PozzettiAndrea/ComfyUI-TRELLIS（推荐）

这是维护最活跃的节点，定期更新。

步骤 1：安装 ComfyUI（如果尚未安装）

步骤 2：安装 TRELLIS 2 自定义节点

步骤 3：下载模型权重

从 HuggingFace 下载 TRELLIS 2 模型权重并放置到正确目录：

也可以手动从 HuggingFace TRELLIS.2-4B 下载并解压到 ComfyUI/models/trellis/。

步骤 4：验证安装

在浏览器打开 http://localhost:8188，在节点浏览器中搜索 "TRELLIS"，应该能看到相关节点。

方案 B：Microsoft 官方集成

Microsoft 在 TRELLIS.2 仓库 中提供了参考集成：

Windows 特殊说明

Windows 用户可能需要额外的设置步骤：

1. 安装 Visual Studio Build Tools，选择"使用 C++ 的桌面开发"
2. 如果使用便携版 ComfyUI，使用内嵌 Python：

   python_embeded\python.exe -m pip install torch==2.8.0 torchvision==0.23.0 torchaudio==2.8.0 --index-url https://download.pytorch.org/whl/cu121

3. 某些依赖可能需要从源码编译——确保 cuda.dll 在系统 PATH 中

安装问题排查

基础工作流：图片转 3D

以下是最简单的 ComfyUI 工作流，将图片转换为 3D 模型。

所需节点

1. Load Image — 输入图片
2. TRELLIS Image to 3D — 核心生成节点
3. TRELLIS Export — 导出为 GLB/OBJ
4. Save Image（可选）— 预览结果

操作步骤

1. 添加 Load Image 节点 — 右键画布 → Add Node → image → Load Image
2. 添加 TRELLIS Image to 3D — 右键 → Add Node → TRELLIS → Image to 3D
3. 添加 TRELLIS Export — 右键 → Add Node → TRELLIS → Export
4. 连接节点：
   • Load Image → IMAGE 输出 → TRELLIS Image to 3D → image 输入
   • TRELLIS Image to 3D → MESH 输出 → TRELLIS Export → mesh 输入
5. 配置导出节点：
   • 格式：GLB（推荐用于网页/游戏引擎）
   • 分辨率：512 快速预览，1024 标准质量，1536 生产级
6. 点击 Queue Prompt 运行

输出质量设置

进阶工作流：文本转 3D 带纹理

通过文本提示词生成带完整 PBR 材质的 3D 模型：

1. CLIP Text Encode — 输入文本提示词（如"一把金色剑柄的中世纪长剑"）
2. TRELLIS Text to 3D — 从文字描述生成 3D
3. TRELLIS Texture Bake — 应用 PBR 材质（基础色、粗糙度、金属度）
4. TRELLIS Export — 导出带嵌入纹理的模型

关键参数

低显存模式

如果你的显卡显存为 8GB 或更少，启用低显存模式避免内存溢出：

配置方法

在 TRELLIS 节点设置中：

• 将 分辨率 设为 512
• 勾选 Low VRAM Mode
• 将 Batch Size 设为 1
• 如不需要可关闭 纹理烘焙

性能参考（RTX 3060 8GB）

导出格式

TRELLIS 2 通过 ComfyUI 支持多种导出格式：

游戏开发推荐 GLB——体积小、兼容性广、PBR 纹理打包在单文件中。

推荐社区工作流

ComfyUI 社区分享了多个可用的生产级工作流：

• RunComfy Trellis 2 高级工作流 — 图片转结构化体素网格，含 UV 展开和 GLB 导出
• Patreon 一键工作流 — 自动下载模型并配置依赖（仅 Windows）
• 多视角管线 — 结合多个相机角度生成更高质量的输出

导入工作流 JSON 的方法：

1. 将 .json 文件拖拽到 ComfyUI 画布上
2. 或点击 Load → 选择工作流文件
3. 调整输入图片和参数
4. 点击 Queue Prompt 运行

常见问题与解决方案

"TRELLIS 节点输出为空"

通常是模型权重目录不正确。检查：

"生成速度极慢"

• 用 nvidia-smi 检查 GPU 利用率——如果很低，模型可能在 CPU 上运行
• 确认 CUDA 正确安装：python -c "import torch; print(torch.cuda.is_available())"
• 关闭其他占用 GPU 的应用

"输出网格有瑕疵"

• 使用更高分辨率的输入图片（512x512+）
• 确保主体居中且背景干净
• 尝试提高 形状质量 参数
• 对于复杂拓扑（开放表面、薄结构），使用 1024³ 或更高分辨率

相关资源

• TRELLIS 2 下载指南 — 所有模型权重和依赖的直链
• ComfyUI 工作流教程 — 带可下载 JSON 的详细步骤
• 如何安装 TRELLIS 2 — 独立安装指南
• 如何使用 TRELLIS 2 — 通用使用指南

常见问题

AMD 显卡能运行 TRELLIS 2 ComfyUI 吗？

不官方支持。TRELLIS 2 需要 CUDA。AMD 用户可以尝试基于 ROCm 的 PyTorch，但兼容性有限。推荐使用在线版本。

需要多少显存？

最低 8GB（低显存模式下使用 512³）。推荐 16GB+ 用于 1024³ 及更高分辨率。

TRELLIS 2 能和其他 ComfyUI 节点配合使用吗？

可以。你可以将 TRELLIS 2 与 Stable Diffusion XL、ControlNet 或任何图像生成节点串联。先生成图片，再送入 TRELLIS 进行 3D 转换。

TRELLIS 2 免费吗？

是的。TRELLIS 2 基于微软的开源协议发布，本地使用完全免费。HuggingFace 上的模型权重也免费下载。