Olares

简体中文

English

简体中文

English

Appearance

使用 Steam Headless 串流你的游戏 ​

想在 Olares 上畅享游戏乐趣吗？没有问题。通过 Steam Headless 应用，Olares 轻松变身强大的游戏串流服务器。现在你可以通过 Moonlight，在任何兼容设备上畅玩你喜欢的 Steam 游戏。

本教程将带你完成在 Olares 上安装 Steam Headless、配置 Steam 客户端、配对串流服务，以及连接 Moonlight 客户端开始游玩的完整流程。

目标 ​

通过本教程，你将学习：

  • 在 Olares 设备上安装并设置 Steam Headless。
  • 配置 Sunshine 串流服务。
  • 通过 Moonlight 完成设备配对，在本地或远程串流游戏。

准备工作 ​

开始前，请确保以下条件已满足：

  • Olares 运行在配备 NVIDIA GPU 的机器上。
  • 串流设备已安装 Moonlight 客户端。访问 Moonlight 官网 下载并安装相应版本。
  • 拥有一个有效的 Steam 账号以访问你的游戏。
  • 如果计划在家庭网络之外进行串流，在客户端设备（桌面或移动端）上启用 LarePass 专用网络。

TIP

仅在本地串流无需启用 LarePass 专用网络。

安装并配置 Steam Headless ​

从 Olares 市场安装 Steam Headless，并在 Steam 客户端内完成初始设置。

安装 Steam Headless ​

  1. 打开应用市场，搜索 “Steam”。

  2. 点击获取，然后点击安装。 安装 Steam Headless

  3. 系统会弹出提示，要求你配置环境变量。这些变量将作为 Sunshine Web UI 的登录凭据：

    • SUNSHINE_USER：设置 Sunshine 访问用户名。
    • SUNSHINE_PASS：设置相应的密码。

      记住你的登录凭据

      这是你登录 Sunshine 的初始凭据。稍后访问 Sunshine 控制台时会用到它们。

  4. 等待安装完成。

完成 Steam 初始设置 ​

登录 Steam 完成设置并访问你的游戏库。

  1. 安装完成后，打开 Steam Headless 并点击 Connect。 连接到 Steam

  2. Steam 客户端将自动安装并更新。此过程可能需要几分钟。 安装 Steam更新 Steam

  3. 安装完成后会出现 Steam 登录界面。使用你的 Steam 账户登录。 登录 Steam

安装失败请重试

如果由于网络问题导致 Steam 安装或更新失败，请在 Steam Headless 控制台左上角的菜单，导航至 Applications > Internet > Steam 重新启动安装。

Steam 准备就绪后，你可以通过 Sunshine 连接 Moonlight 进行串流。

将 Sunshine 与 Moonlight 配对 ​

Steam Headless 集成了开源串流服务器 Sunshine。要串流游戏，你需要先把它与你的 Moonlight 客户端配对。

访问 Sunshine 控制台 ​

首先打开 Sunshine Web UI，为配对做好准备。具体地址取决于你的网络环境。

Sunshine 必须使用 HTTPS

打开 Sunshine Web UI 时必须添加 https://。即使使用局域网 IP 或 .local 域名，也不要使用 http://。

  1. 根据网络环境选择一种方式打开 Sunshine Web UI：

    • Overlay 网关（局域网内推荐）

      Overlay 网关使用条件

      仅当 Olares 运行在使用有线网络连接的原生 Linux 主机上时，才可使用此方式。如果当前环境不满足要求，请改用下方的 .local 方式。

      如果无法开启系统级服务，需联系超级管理员。详情可参阅管理应用的 Overlay 网关。

      Overlay 网关会为 Steam Headless 分配一个局域网 IP，使视频、音频和控制数据可通过局域网直接传输，无需经过 .local 域名解析、内部代理和集群网络转发。

      a. 打开设置 > 网络 > Overlay 网关。

      b. 确认系统级服务已开启，然后为 Steam Headless 开启Overlay 网关。

      c. 等待 Steam Headless 恢复为运行中。分配给应用的局域网地址会显示在应用下方。

      查看 Steam Headless 的 Overlay 网关地址

      d. 复制 Sunshine Web UI 地址，在前面添加 https://，然后通过浏览器打开。例如：

      plain
      https://192.168.50.117:47990

    • 同一网络（.local 域名）

      复制当前 Steam Headless 浏览器标签页的 URL，将主机名改为 .local 格式并添加端口 47990，然后通过浏览器打开。以下两种本地主机名格式均可：

      plain
      https://139ebc4f0.<your Olares ID>.olares.local:47990
https://139ebc4f0-<your Olares ID>-olares.local:47990

      Windows 用户可通过 LarePass 桌面端导入 Olares hosts，或使用连字符形式的单级主机名。详情请参阅在局域网内访问 Olares 服务。

    • 不同网络（LarePass 专用网络）：先启用 LarePass 专用网络，然后复制 Steam Headless 的 .com URL，添加端口 47990，并通过浏览器打开。例如：

      plain
      https://139ebc4f0.<your Olares ID>.olares.com:47990

  2. 页面打开后，使用之前创建的 SUNSHINE_USER 和 SUNSHINE_PASS 凭据登录。 登录 Sunshine

  3. 点击 PIN 标签页。页面会进入等待配对 PIN 的状态。 Sunshine 上的 PIN

在 Moonlight 中添加主机 ​

接下来，在 Moonlight 中将 Olares 添加为主机。以下步骤以 macOS 客户端为例。

在同一局域网内，Moonlight 可能会自动发现 Steam Headless。如果没有显示，或需要远程连接，请手动添加：

  1. 在串流设备上打开 Moonlight。

  2. 点击 Add Host（带有加号的电脑图标）。

  3. 根据网络环境输入主机地址。不要添加 http:// 或 https://：

    • Overlay 网关：输入上方截图中 Moonlight HTTP 下显示的地址，包括端口。不要添加协议。例如：

      plain
      192.168.50.117:47989

    • 同一网络（.local 域名）：输入 .local 主机名，不要添加端口。例如：

      plain
      139ebc4f0.<your Olares ID>.olares.local

    • 不同网络（LarePass 专用网络）：输入 .com 主机名，不要添加端口。例如：

      plain
      139ebc4f0.<your Olares ID>.olares.com

  4. 点击 OK。此时会出现一个带锁的主机图标。

  5. 点击该图标。Moonlight 将显示一个 4 位数的配对 PIN。 获取配对 PIN 码

完成配对 ​

  1. 回到浏览器中的 Sunshine PIN 页面。

  2. 输入 Moonlight 显示的 PIN 码，并为你的设备命名。 输入配对 PIN 码

  3. 点击 Send。

  4. 配对成功后，你将看到成功提示，主机图标应显示为已解锁的可用状态。 Host in Moonlight

配对完成后，就可以开始串流了。

串流你的游戏 ​

优化远程串流体验

为获得更好的远程串流效果，建议：

  1. 将客户端设备连接至 5GHz Wi‑Fi 或有线网络。
  2. 确认已启用 LarePass 专用网络。

根据你的网络设置，你可以在局域网或远程网络中，通过 Moonlight 串流游戏。

下面以局域网串流为例：

  1. 在客户端设备上打开 Moonlight。
  2. 选择已解锁的主机，然后点击 Steam 图标。 Moonlight 里的 Steam

此时，Steam 将进入大屏幕模式，你可以开始畅玩游戏了。

常见问题 ​

为什么 Steam 串流会出现卡顿或延迟？ ​

网络状况、GPU 分配、电源设置、Proton 兼容性以及 CPU 或内存限制都可能导致串流卡顿或延迟。

按照排查 Steam 串流卡顿或延迟中的步骤定位并解决问题。

为什么使用 .local 地址无法打开 Sunshine Web UI？ ​

Olares 下大多数服务支持通过 HTTP 协议访问 .local 地址，但 Sunshine Web UI 需使用 HTTPS 以保证本地通信安全。若在 .local 的 URL 中使用 http://，Sunshine 页面将无法加载。

为了能正常访问，在浏览器地址栏中改用 https:// 而非 http://，例如：https://139ebc4f0.<your Olares ID>.olares.local:47990。

为什么游戏不能全屏显示？ ​

这通常与分辨率设置有关。你可以尝试调整分辨率：

  • 在 Moonlight 中：进入 Settings > Basic Settings > Resolution and FPS。 Moonlight 显示
  • 在 Steam 控制台页面：进入 Applications > Settings > Display.
    Steam Headless 显示

如何退出全屏串流？ ​

使用以下快捷键：

  • Windows：Ctrl + Alt + Shift + Q
  • Mac：Control (^) + Option (⌥) + Shift + Q
  • 移动端：Start + Select + L1 + R1

结束游戏后，请退出 Steam 大屏幕模式，释放 Olares 上的系统资源。 退出 Steam 大屏幕模式

下载的游戏存储在哪里？ ​

你可以在 Olares 文件管理器中查看已下载的游戏。默认保存路径为：

/Cache/olares/steam-headless/c0/.steam/steam/steamapps/common

建议不要更改此默认目录。

为什么在 Moonlight 里重新配对主机会报错？ ​

如果你在 Moonlight 里删除 Olares 主机后再次配对，可能会遇到以下错误：

  • The PIN from the PC didn't match. Please try again.
  • Request timed out (Error 4)
  • Connection closed (Error 2)

这通常是因为 Sunshine 服务未响应。

解决此问题，请重启 Olares 上的 Steam Headless，然后重新配对：

  1. 从启动台打开控制面板。
  2. 导航至浏览 > steamheadless > 部署 > steamheadless > 重启。 重启 Steam Headless
  3. 在确认提示框中，输入steamheadless，点击 Confirm。 确认重启
  4. 重启完成后，在 Moonlight 与 Sunshine 重新配对。

如何修改 Sunshine 用户名或密码？ ​

你可以在 Sunshine Web 控制台中直接修改凭据。

  1. 使用本地地址在浏览器中打开 Sunshine，例如：http://139ebc4f0.<your Olares ID>.olares.local:47990。
  2. 使用当前的用户名和密码登录。
  3. 转到 Change Password 标签页。 Change Sunshine password
  4. 输入新密码（如需更改用户名也可输入新用户名），然后点击 Save。