Olares Steam Headless 常见问题排查:apt 软件包持久化与《黑神话:悟空》帧生成修复

原创2026-10-14 20:53:581,349 阅读
文章标签:云原生后端运维

Olares Steam Headless 常见问题排查:apt 软件包持久化与《黑神话:悟空》帧生成修复

Steam Headless 是运行在 Olares 上的无头游戏串流应用,借助 NVIDIA GPU 与 Sunshine 服务,可把 Olares 设备变成随时可远程游玩的游戏主机。本文聚焦社区反馈最集中的两类问题:通过 apt 手动安装的软件包在应用重启后丢失,以及《黑神话:悟空》在 Proton 环境下无法开启帧生成。文章给出完整的排障路径、容器终端操作步骤与修复脚本验证方法,读完即可独立处理这两类故障。

问题背景:Steam Headless 的容器化运行方式

Steam Headless 在 Olares 集群中以容器工作负载(Deployment)的形式运行,其 Pod 位于 steamheadless 命名空间,容器名为 steam-headless。这类排障大多需要在容器内部执行命令,入口统一为 Control Hub:

  1. 打开 Control Hub,进入左侧导航的 Browse,选择 steamheadless 命名空间;
  2. 展开 Deployments > steamheadless,点击进入正在运行的 Pod;
  3. 在 Containers 区域,点击 steam-headless 容器旁边的 Terminal 图标,即可打开容器 Shell。

通过 Control Hub 打开 steam-headless 容器终端

容器 Shell 中执行的命令不会影响宿主机,只作用于该容器,是本文两个排障流程的共同前提。关于 Pod 与容器的更多管理能力(状态查看、日志导出、资源图表等),可参考 管理容器 与 管理工作负载。

问题一:apt 安装的软件包在重启后消失

现象与根因

通过 apt 安装的软件包会写入容器的根文件系统。Steam Headless 在应用**重启(restart)、重新部署(redeploy)或升级(upgrade)**时都会重建该文件系统,因此任何手动 apt 安装的内容都不会保留,表现为"装完能用、一重启就没了"。

需要说明的是,这并非缺陷,而是容器化应用的固有特性:可写层随 Pod 生命周期重建,只有挂载的持久卷(Volumes)才会保留数据。Control Hub 的 Pod 详情页中 Volumes 区域列出的挂载路径与访问模式,正是判断哪些数据能留存的关键依据。

解决方案:优先使用 Flatpak

当目标软件存在 Flatpak 版本时,用 Flatpak 替代 apt。在 Steam Headless 1.0.43 及更高版本中,Flatpak 应用、运行时(runtimes)与用户数据会保存在**持久化应用存储(persistent app storage)**中,因此能跨重启、跨升级保留。

反例对照:游戏本体数据默认存放在 /Cache/olares/steam-headless/c0/.steam/steam/steamapps/common(见 Stream your games with Steam Headless 的 FAQ),位于持久存储中、不会丢失;而 apt 包所在的可写层会被重建。两者形成鲜明对比,也解释了为什么游戏在、系统工具丢。

通过 Flatpak 安装软件包

  1. 打开 Control Hub,进入 Browse > steamheadless;

  2. 展开 Deployments > steamheadless,打开正在运行的 Pod;

  3. 在 Containers 下,点击 steam-headless 旁边的 Terminal 图标;

  4. 在容器 Shell 中执行 Flatpak 安装命令,例如:

    flatpak install <remote> <application-id>
    

    flatpak install 会同时拉取对应的运行时依赖;如需列出可用远端或已安装应用,可配合 flatpak remotes、flatpak list 使用。

安装完成后,应用及其数据写入持久化存储,此后即使 Steam Headless 重启、重新部署或升级,也不再丢失。

问题二:《黑神话:悟空》无法开启帧生成

现象与根因

通过 Proton(Steam 在 Linux 上的 Windows 游戏兼容层)运行《黑神话:悟空》时,游戏的图形设置中可能看不到或无法开启**帧生成(Frame Generation)**选项。从 Steam Headless 最新版的修复脚本输出可以推断,根因在于游戏的 Proton 环境缺少三项关键配置:

  • DirectX 12(Dx12):帧生成依赖 DX12 渲染路径;
  • DLSS(Dlss):帧生成基于 DLSS 3 的帧插值技术,需要显式启用 DLSS 相关设置;
  • 硬件加速 GPU 调度(HwSchMode):需要在 Proton 前缀的 Windows 注册表中写入对应的调度模式。

最新版 Steam Headless 已内置修复脚本 fix-wukong-frame-gen.sh,负责在游戏的 Proton 环境中一次性完成上述配置。

修复步骤

  1. 打开应用市场(Market),将 Steam Headless 更新到商店提供的最新版本;

  2. 在 Steam 游戏库中选择《黑神话:悟空》,等待下载或文件验证完成,确认页面显示 Play;

  3. 点击 Play,等待游戏进入主菜单,然后完全退出游戏(修复脚本要求游戏不在运行状态);

  4. 打开 Control Hub,进入 Browse > steamheadless;

  5. 展开 Deployments > steamheadless,打开正在运行的 Pod;

  6. 在 Containers 下,点击 steam-headless 旁边的 Terminal 图标;

  7. 确认修复脚本已安装:

    command -v fix-wukong-frame-gen.sh
    

    预期返回:

    /usr/bin/fix-wukong-frame-gen.sh
    

    若该命令无任何输出,说明脚本未安装。请返回应用市场,确认 Steam Headless 已更新到最新版本后再继续。

  8. 执行修复脚本:

    /usr/bin/fix-wukong-frame-gen.sh
    
  9. 确认输出包含以下三条信息,缺一不可:

    [OK] GameUserSettings.ini: Dx12=1, Dlss=1
    [OK] Wrote registry HwSchMode=2 into system.reg
    [OK] Done. Launch Black Myth: Wukong and enable Frame Generation in the graphics menu.
    

    它们分别代表:游戏用户配置 GameUserSettings.ini 中已写入 Dx12=1、Dlss=1;Proton 前缀的注册表文件 system.reg 中已写入 HwSchMode=2(硬件加速 GPU 调度);脚本执行完成。

  10. 启动游戏,进入图形设置,手动开启帧生成。

注意事项与使用边界

  • 重装或更新游戏后需重跑脚本:游戏更新可能覆盖配置文件或重建 Proton 前缀,导致修复失效,此时重新执行 /usr/bin/fix-wukong-frame-gen.sh 即可;
  • 游戏运行中脚本会拒绝执行:如果脚本提示游戏正在运行,请完全退出游戏后重试;
  • 不要依赖 -dx12 Steam 启动选项:Steam 客户端可能清除该启动参数,无法保证 DX12 路径稳定生效,因此应以脚本配置为准;
  • 脚本输出仅代表配置写入成功:帧生成的实际可用性还取决于显卡型号、驱动以及游戏内图形设置,最终以游戏菜单中的选项状态为准。

延伸:其他高频 Steam 串流问题

除上述两类问题外,若串流过程中出现延迟、卡顿、断连或输入延迟,可参考 Slow or delayed Steam streaming 按优先级逐项排查,常见诱因包括:

  • nginx 重启:串流期间安装、卸载或更新应用会中断会话(Olares 1.12.4 用户建议升级到 1.12.5+);
  • 网络连接:优先使用有线 Ethernet,避免 Wi-Fi 抖动;
  • GPU 占用与功耗:在 Settings > GPU 中将 GPU 模式设为 App exclusive 并绑定 Steam Headless;Olares One 用户可将 Power mode 切换为 Performance mode;
  • Proton 兼容性:在游戏 Properties > Compatibility 中强制指定其他 Proton 版本;
  • 资源限制:通过 Control Hub 的 Details 查看实际 CPU/内存占用,若接近 YAML 中 limits 的 cpu(毫核,1000 m = 1 核)与 memory(如 64Gi)上限,可酌情调大。

小结

  • apt 包写入容器根文件系统,重启/重部署/升级后丢失;Steam Headless 1.0.43+ 已将 Flatpak 应用与数据纳入持久化应用存储,装额外软件优先走 Flatpak;
  • 《黑神话:悟空》帧生成不可用,源于 Proton 环境缺少 DX12、DLSS 与硬件加速 GPU 调度配置,更新到最新版 Steam Headless 并执行 fix-wukong-frame-gen.sh 即可修复,重装/更新游戏后需重跑;
  • 两类问题的操作入口一致:Control Hub → Browse → steamheadless → Deployments → steamheadless → Pod → steam-headless 容器终端。
登录后查看全文
Terminus