安装与 IT

本页面向负责管理工作室工作站的人员。播放器可从网站的下载页面免费下载，无需账户，页面上附有每个文件的 SHA-256 指纹。

Windows

• 系统：Windows 10 或 11，64 位；支持 OpenGL 3.0 或更高版本的显卡（4K 和 EXR 推荐使用 NVIDIA）。

• 安装程序：BernardReview-<version>-win64.exe，由管理员运行。它安装到 C:\Program Files\Bernard Review，程序为 bin\BernardReview.exe，并创建 Bernard Review 开始菜单项。

• 静默安装（部署工具、脚本）：/S 不显示窗口直接安装；/D= 选择文件夹，必须放在最后，不加引号，即使路径含空格也一样：

  start /wait BernardReview-<version>-win64.exe /S /D=C:\Program Files\Bernard Review
  echo %ERRORLEVEL%

  退出码说明发生了什么：

  代码	含义	应对措施
  0	已安装	无需处理
  3	播放器（或其文件夹中的任何程序，包括串流配套程序）正从安装文件夹中运行：安装程序立即停止，没有写入任何内容	关闭播放器后再次运行安装

  从其他文件夹运行的播放器不会阻止安装。安装程序绝不会自己关闭播放器：尚未保存的审阅会丢失。在 PowerShell 中，(Start-Process .\BernardReview-<version>-win64.exe -ArgumentList '/S' -Wait -PassThru).ExitCode 可读出该代码。

  静默安装会不经询问地卸载旧的 BernardPlayer。 当发现最早期的 BernardPlayer 版本（文件夹 C:\Program Files\BernardPlayer <version>）时，交互式安装会先询问是否卸载它们；/S 会替您回答“是”，并静默运行它们的卸载程序。在这样的工作站上部署前，请知悉这一点，或事先自行移除。/NOASSOC 安装时不写入任何文件关联，无论组件页面原本会选择什么（适用于自行决定哪些文件由播放器打开的流水线）。

• 防火墙：安装程序为该程序添加入站规则 Bernard Review (LAN sessions)，仅适用于 Domain 和 Private 配置文件，绝不适用于 Public（如果附带串流配套程序，还会添加 Bernard Review (stream companion)）。卸载时会删除这些规则。

• SmartScreen：安装程序尚未经过代码签名，因此 Windows 可能显示“未知发布者”。请先核对指纹：

  Get-FileHash -Algorithm SHA256 .\BernardReview-<version>-win64.exe

  然后点击 More info 和 Run anyway。

• 应用程序控制（AppLocker、WDAC）：该程序未签名；可使用按路径或按哈希的规则，而哈希规则必须随每个版本更新。

Linux

适用于兼容 RHEL 8、9 和 10 的系统（Rocky Linux、AlmaLinux、Red Hat Enterprise Linux），x86-64 处理器。

• RPM 软件包，供工作站的所有用户使用（需要管理员权限）：

  sudo dnf install ./bernard-review-<version>-Linux.rpm

  命令为 bernard-review。

• 自解压归档，安装在您的主目录中，无需管理员权限：

  mkdir -p ~/bernard-review
  sh ./bernard-review-<version>-Linux.sh --prefix=$HOME/bernard-review --exclude-subdir
  ~/bernard-review/bin/bernard-review

• 适用于 Ubuntu 的 DEB 软件包：即将推出，待在 Ubuntu 上测试之后。

• 对话框：文件选择器来自桌面环境（zenity、kdialog 或 qarma）；软件包推荐安装 zenity。如果一个也没安装，播放器会在启动时以及需要对话框时提示：sudo dnf install zenity。

• 相机 RAW（RED、ARRI、Blackmagic RAW）：目前仅限 Windows；Linux 和 macOS 即将推出。

macOS：即将推出。

网络

播放器的播放、标注、导出以及工作室网络上的会话都可以完全离线工作：无需互联网连接。

来宾不需要任何入站端口：它的所有连接都是出站的。“仅本机”会话只在环回上监听。

在 Linux 上开放端口 9000。 软件包附带了相关定义，但默认不启用：

# firewalld (Rocky Linux, AlmaLinux, RHEL)
sudo firewall-cmd --permanent --zone=<zone> --add-service=bernard-review
sudo firewall-cmd --reload
# ufw (Ubuntu)
sudo ufw allow from <subnet> to any port 9000 proto tcp

请把 <zone> 替换为内部网络所在的区域，把 <subnet> 替换为工作室的子网。如果 Windows 防火墙由组策略（GPO）管理并忽略本地规则，请在策略中添加规则：TCP 9000 入站，针对该程序，Domain 和 Private 配置文件。

在线会话。 它们通过服务的中继进行，只使用出站连接：

只要出站 TCP 443 能通向这两个名称，一切就都能工作，只是延迟稍高。代理必须允许对这些名称的 443 端口使用 CONNECT，不对它们进行 TLS 检查，并且不在 120 秒内切断空闲连接。要在工作站上检查：

curl -sS https://review.bernardengine.com/api/v1/health

预期的响应中包含 "status":"ok"。

Tracker。 Kitsu、ftrack 和 Flow 通过 HTTPS 访问其站点地址，经由站点的代理或环境的代理（HTTPS_PROXY、NO_PROXY）。证书始终会被验证，依据是系统的证书存储或站点的证书颁发机构文件。

设置和日志的存放位置

其中包含：

• player_debug.log，即日志：只记录真实发生的事件（片段已载入、解码错误等），超过 8 MB 后轮换为 player_debug.log.1；
• crashes\，崩溃报告：Windows 上是 .dmp 小型转储，Linux 上是 .txt 文本报告，命名为 crash-<date>-<time>-<version>，时间为 UTC。只保留最近的五份。日志的最后一行会指出所写入的报告；
• session_config.json（偏好设置、上次的会话）、keymap.json（快捷键）、naming_rules.json（Version Board 的命名规则）、trackers.json（tracker 站点，不含机密信息），以及 color_presets、export_presets、export_recipes 和 tracker-media 文件夹。

要报告问题，Help > Send Log to the Bernard Team... 会确切显示将从这台机器发出的内容（日志；最新的崩溃报告，仅在您勾选时；版本和系统），可附上可选的说明，在您点击 Send 之前不会发送任何内容；发送后会给出一个报告 ID，供您引用。没有网络时，Open Log Folder 可让您通过其他方式发送这些文件。崩溃之后，下次启动时会先询问。Help > About... > Copy System Info 复制一份机器和库的摘要，不含用户名、机器名、路径或地址。

诊断。 在环境中设置 BERNARDPLAYER_VERBOSE=1 会增加详细跟踪（用完后请移除）。BERNARDPLAYER_NO_CRASH_HANDLER=1 让调试器可以捕获崩溃。使用 --self-crash 启动会故意崩溃，用来检查是否会写出报告。

set BERNARDPLAYER_VERBOSE=1
"C:\Program Files\Bernard Review\bin\BernardReview.exe"

机密信息。 tracker 的机密信息存入系统的凭据存储（Windows 凭据管理器、Linux 上的 Secret Service）。账户登录数据在 Windows 上使用 DPAPI 加密。

屏幕共享

如果远程访问工具或屏幕共享（Splashtop、Teams、OBS）在 Windows 上接收全屏播放时画面卡顿，请在共享期间勾选偏好设置中的 Present through DWM (smooth screen sharing)。它默认关闭：它会使本地屏幕出现少量重复帧。

从 BernardPlayer 升级

早期版本中，播放器名为 BernardPlayer。安装程序会替换旧的安装，首次启动时会复制旧的设置文件夹（%APPDATA%\BernardPlayer、~/.config/bernardplayer），但不会改动它。在过渡期内，BernardPlayer.exe 和 bernardplayer 仍可启动播放器：按名称结束该程序的脚本应当同时写上这两个名称。

进一步了解：完整手册的第 12 和 13 部分（播放器中的 Help > User Guide），以及本站的 IT 团队页面。

更新

启动时，播放器会在后台检查是否有适用于您系统的更新版本（除版本号外不发送任何内容）。如果有，横幅会提供 Update（Windows；在 Linux 和 macOS 上是 Download，即下载页面）、What's New（发行说明，在播放器中显示）和 Later。Update 在后台下载安装程序，并将其大小和 SHA-256 与站点公布的值核对（不一致的绝不会运行），然后，一旦播放器处于空闲状态（没有播放、会话、导出或输入），就倒计时 Restarting to install in 10 s（Restart Now、Not Now）：到 0 时播放器关闭，会话得以保留，安装程序静默运行（UAC 仍会请求管理员权限），播放器随后以用户自己的账户重新打开，会话保持离开时的样子。没有点击 Update 就不会发生任何事，在播放、会话或导出期间也绝不会发生（它会等待）。Not Now，或手动关闭：在关闭时安装，播放器不会重新打开。Preferences > General > Updates: Ask / Never 关闭检查；IT 可以用环境变量 BERNARD_NO_UPDATE_CHECK=1、注册表项 HKLM\Software\AArts Lab\Bernard Review\NoUpdateCheck=1（Windows）或包含 {"update_check": false} 的文件 /etc/bernard-review/policy.json（Linux）来强制执行。