Team Render 故障排查指南

Team Render 是 Cinema 4D 内置的分布式渲染系统。它可以将一个渲染任务拆分到网络中的多台电脑同时处理，从而比本地渲染完成得更快。
在 Team Render 的环境里，每台参与的机器都会扮演两种角色之一：主机（负责分配任务）或 客户端（负责实际渲染）。Cinema 4D 本身既可以作为主机，也可以作为客户端。
独立的 Team Render Server（TRS） 应用始终作为主机，并提供专用的任务队列以及基于网页的控制面板；而独立的 Team Render Client 应用则始终作为客户端。无论哪种主机方式，它们都使用相同的底层连接机制，因此本指南中的故障排查步骤对两种方式都适用，除非特别说明差异。

当 Team Render 出现问题时，症状可能比较让人摸不着头脑：客户端会从机器列表中消失、任务卡在队列里不动、渲染输出的颜色偏差、或者客户端控制台根本打不开。本指南会介绍我们在技术支持中最常遇到的问题、产生原因以及解决方法。

如果你是第一次设置 Team Render，而且连最初的连接步骤都还没成功，请先参考我们的 《如何设置 Team Render》 指南，再回来查看本指南解决剩下的异常。

故障排查前：预检步骤

大多数 Team Render 的问题通常源于以下四类原因。在深入具体故障之前，先逐项检查这个清单。

1. 版本一致
   主机和客户端必须运行同一版本的 Cinema 4D。版本不一致是导致 Team Render 出现问题的常见原因。可在每台机器的 帮助 > 关于 中确认版本号。
   如果使用 Redshift，同样需要版本一致，否则会出现“内存不足”的错误。
2. 插件
   场景中使用的任何第三方插件，都必须安装在每一台客户端机器上。
3. 网络可达性
   无线网络可以使用，但建议优先选择有线连接。主机和客户端必须处于同一物理网络或可互相路由的网络。基于 Bonjour 的自动发现功能不能跨 VLAN，也无法穿过大多数 VPN 桥接。
4. 防火墙和杀毒软件
   Cinema 4D、Team Render Server、Team Render Client 以及 Bonjour 都需要在防火墙中允许双向通信。
   默认情况下，Team Render 使用以下端口：
   • Cinema 4D：5400
   • Team Render Client：5401
   • Team Render Server：5402
     自动发现功能还需要开放 UDP 端口 5353（Bonjour）以及 UDP 端口 1900（SSDP）。部分第三方安全软件还需要额外手动添加 Team Render 流量的允许规则。

务必先检查控制台窗口
无论是 Team Render Server 还是 Team Render Client，在运行时都会实时显示警告和错误信息。
如果连接中断、渲染失败、插件加载不到、验证被拒绝，原因很可能在控制台窗口中就能看到。
在处理下面的具体问题之前，先查看两边的控制台窗口，也许答案已经在那里。

专业提示：备份你的 Team Render 机器列表
无论你使用 Team Render Server 还是 Cinema 4D 作为主机，都养成一个习惯：
每次有重要变更（新增客户端、更改机器名称、令牌更新）后，都在 Machine > Save Machines... 导出机器列表为 .txt 文件。
该列表保存在主机应用的偏好设置文件夹里，一旦偏好设置被重置、损坏或删除，列表也会随之消失。
有备份 .txt 文件的话，可以通过 Machine > Load Machines... 秒级恢复，而不用手动重新添加。
 

常见问题及解决方法

Team Render Client 或 Team Render Server 无法启动

症状：启动 Team Render Client 或 Team Render Server 时，启动界面只闪一下，应用未打开。再次尝试启动没有反应，或者虽然能启动，但每次重启都会立即出现问题。

检查步骤：

1. 是否已在后台运行
   应用很可能已经在后台运行。
   • Windows：打开任务管理器，在“进程”中查找 Team Render Client.exe 或 Team Render Server.exe。结束进程后再尝试启动。
   • macOS：打开活动监视器，搜索“Team Render”。结束进程后再尝试启动。
2. 重置/删除偏好设置
   如果进程没在运行，但应用仍无法启动（或者启动后立即出现问题），可能是偏好设置文件损坏，重置或删除偏好设置通常可以解决。
   根据你的应用类型，选择下面对应的步骤进行重置。

重置/删除 Team Render Client 偏好设置

1. 关闭 Team Render Client（如仍在后台运行，请按照步骤 1 结束进程）。
2. 打开 Maxon 主文件夹：
   • Windows：Users\USERNAME\AppData\Roaming\Maxon
   • macOS：Users/USERNAME/Library/Preferences/Maxon
   • 快捷方式：打开 Cinema 4D，选择 编辑 > 偏好设置 > 打开偏好设置文件夹，然后向上返回一级，即可看到所有同级文件夹。
3. 找到并删除 Team Render Client 文件夹，名称类似 Maxon Cinema 4D 202*_********_c（其中 _c 表示 Client，* 是安装时随机生成的字符）。
4. 重新启动 Team Render Client，它会自动生成新的偏好设置文件夹。

重置/删除 Team Render Server 偏好设置

注意：删除 Team Render Server 的偏好设置会清空机器列表。如果之前用 Machine > Save Machines... 导出过 .txt 备份，可以在重置后导入并恢复；如果没有备份，需要手动重新添加客户端。

1. 关闭 Team Render Server（如仍在后台运行，请按照步骤 1 结束进程）。
2. 打开 Maxon 主文件夹：
   • Windows：Users\USERNAME\AppData\Roaming\Maxon
   • macOS：Users/USERNAME/Library/Preferences/Maxon
   • 快捷方式：打开 Cinema 4D，选择 编辑 > 偏好设置 > 打开偏好设置文件夹，然后向上返回一级。
3. 找到并删除 Team Render Server 文件夹，名称类似 Maxon Cinema 4D 202*_********_s（其中 _s 表示 Server）。
4. 重新启动 Team Render Server，它会自动生成新的偏好设置文件夹。
5. 如果有备份，打开 Machine > Load Machines...，选择之前保存的 .txt 文件恢复机器列表；若无备份，需在 Machine > Add Machine... 手动添加每个客户端。

不要删错文件夹！
Maxon 主文件夹里包含其他应用的偏好设置，每个应用都有不同的后缀：

• （无后缀）= Cinema 4D 主程序
• _c = Team Render Client
• _s = Team Render Server
• _w = Cineware
• _x = Command Line
• _p = c4dpy

Team Render 无法连接

症状：主机上的 Cinema 4D 无法连接到工作机上的 Team Render Client，验证失败、客户端不变绿、连接立刻断开，或者完全无反应。

MacOS 15（Sequoia）及以后版本常见原因：本地网络授权（Local Network）权限在重启、系统更新或状态变化后可能无法持续应用，对连接造成影响。

解决方法：

方法 1（macOS 15 及以后）——切换本地网络权限

1. 在失败连接的 macOS 机器上打开 系统设置 > 隐私与安全性 > 本地网络。
2. 找到对应的 Team Render 应用（Cinema 4D、Team Render Server、Team Render Client）并关闭再重新开启权限开关。
3. 退出并重新启动该应用，连接应恢复正常。

方法 2——快速角色交换

• 让当前主机运行 Team Render Client，工作机运行 Cinema 4D互相验证一次，再恢复原角色，很多情况下可重新连接成功。

方法 3——使用 Team Render Server 角色交换

• 让工作机运行 Team Render Server，主机运行 Team Render Client进行验证，再恢复原角色，并用 TRS 验证一次。最后换回 Cinema 4D 主机角色，客户端应能立即显示并连接。

客户端不出现在机器列表中

• 确认主机与客户端在同一物理网络（可无线+有线混合，同子网即可）。
• 确保 Announce Service via Bonjour 和 Announce Service to Local Network 在所有机器上都开启。
• Windows 客户端检查是否安装 Bonjour（可通过 iTunes 或 Apple 提供的 Bonjour Print Services 安装）。
• 检查防火墙端口：UDP 5353（Bonjour）和 UDP 1900（SSDP）需双向开放。
• 如果自动发现仍无法工作，可切换到手动添加客户端（参考 关闭自动发现并手动连接）。

关闭自动发现并手动连接客户端

• 在每台机器的 Team Render 偏好设置中关闭 Bonjour 和本地网络服务广播，记录每个客户端的安全令牌（Security Token）。
• 在主机的机器列表中点击 Add Machine，按 IP:端口 或 主机名:端口 格式手动添加（端口：Cinema 4D 用 5400，TR Client 用 5401）。
• 建议给每个客户端分配固定 IP 或使用可靠的主机名解析，避免 DHCP 导致记录失效。

连接显示灰色或提示版本不一致

• 确认客户端与主机的 Cinema 4D 构建 ID 完全一致。如果不一致，请安装相同版本（包括 Redshift）。

客户端显示“No Answer”或无响应

• 检查客户端控制台日志，查看是否有拒绝验证、令牌不匹配、连接被阻断等错误信息。
• 确认防火墙未拦截 C4D 和 TR Client。
• 核对安全令牌一致性。
• 检查 IP 是否因 DHCP 改变而失效，必要时改为主机名连接。

多客户端安装，但服务器只显示一个

• 如果客户端是通过克隆磁盘镜像安装，则它们有相同的 Client ID，需要删除 Team Render Client 偏好设置文件夹（_c 后缀）以生成新的 ID，并重新验证。

客户端频繁消失或显示 Unknown Error

• 原因通常是 DHCP 分配的 IP 变动导致记录失效。
• 修复方法是更新 IP 或改为使用主机名连接，并在路由器上设定 DHCP 保留。

服务器重命名或移动安装文件夹后无法连接

• 原因是服务器身份与安装路径绑定。
• 解决方法是删除所有客户端条目，重置连接后重新添加并验证。

客户端已连接但不渲染帧

• 检查控制台日志是否有插件缺失、资源不可访问、许可证不足或模拟未烘焙的提示。
• 需要确保插件版本一致、许可证覆盖所有客户端、资源路径可访问，并在提交任务前烘焙非确定性模拟。

渲染输出颜色不正确

• Cinema 4D 新版 OCIO 与 TR Server 存在交互问题。
• 临时解决方案是切换项目到旧版 sRGB 线性色彩空间，由 Redshift 管理色彩，这样 TR Server 生成的颜色才正确。

Redshift 灯光在 Team Render 与本地渲染结果不同

• 原因是全局光照（GI）在不同机器上单独计算，硬件差异会导致采样不同。
• 解决方案是在单机上烘焙好 GI 缓存，并让所有客户端读取同一缓存。
• 完整解说请参考：
  为何Redshift 的照明在团队渲染器中与在我的主机器中不同？（缓存 Redshift 全局照明相关）.