客厅变游戏室？如何用树莓派实现 Moonlight 游戏流媒体

在这个项目中，我们将向您展示如何使用 Moonlight 将游戏直接流式传输到您的Raspberry Pi。

Moonlight是您可以使用的最佳自托管游戏流平台之一。它允许您在运行Sunshine的更强大游戏设备和较弱设备（如Raspberry Pi）之间轻松建立低延迟、高清的连接。

这类软件允许您从可能离您的更强大设备太远的屏幕上玩游戏。例如，您可能在房子的二楼有一台游戏电脑，但一楼是客厅电视。您无需在两者之间尝试运行HDMI电缆，而是可以使用Moonlight通过网络进行流式传输。

以实惠的价格将Moonlight连接到电视的一种方法是将其设置在Raspberry Pi上。Raspberry Pi是一种低功耗设备，因此持续运行成本很低，并且有足够的功率来处理流而不会增加额外的延迟。

当然，与所有游戏流软件一样，使用有线以太网连接将获得最佳体验。即使是最好的Wi-Fi网络也可能产生额外的延迟。

虽然本安装和设置Moonlight的指南适用于任何Raspberry Pi，但使用Raspberry Pi 5或更新版本将获得最佳体验。您的设备功能越强大，获得的流媒体体验就越好。

设备

以下是在我们的Raspberry Pi上设置Moonlight时使用的设备列表。树莓派产品可以直接通过文章的尾部的联系方式进行采购。

推荐设备

Raspberry Pi

显示器

Micro SD卡

电源

以太网电缆 或 Wi-Fi

USB鼠标

• USB键盘

可选设备

Raspberry Pi保护壳

HDMI电缆

Xbox手柄

• PlayStation手柄

本教程最后一次测试是在运行最新版本的 Raspberry Pi OS Bookworm Lite 的Raspberry Pi 5 上进行的。

在 Raspberry Pi 上安装和运行 Moonlight

在接下来的部分中，我们将指导您如何将Raspberry Pi变成Moonlight流媒体盒子。

虽然本教程将重点介绍从Raspberry Pi OS Lite开始，但您仍然可以在完整的桌面版本上按照本指南进行操作。但是，请注意，已知存在性能问题。

准备您的 Raspberry Pi

1.您的第一步是确保系统上的所有软件包都是最新的

在终端中运行以下两个命令，即可轻松更新Raspberry Pi上的软件包。

sudo apt updatesudo apt upgrade -y

2.接下来，我们必须使用以下命令安装设置Moonlight所需的两个软件包。第一个软件包“curl”将用于获取并运行设置Moonlight软件包存储库的脚本。

第二个软件包“pulseaudio”将使Moonlight和Raspberry Pi之间的音频正常工作。

sudo apt install curl pulseaudio

3.安装Pulse Audio后，您需要启用其服务，以便在Raspberry Pi开机时自动启动

sudo systemctl --global enable pulseaudio

4.由于我们运行的是Raspberry Pi OS的“lite”版本，下一步将是让系统自动登录到您的用户。如果您使用的是Raspberry Pi OS的桌面版本，请跳过此步骤。

您可以通过在终端中使用以下命令轻松完成此操作。基本上，这会使您的系统立即以当前用户身份启动终端会话。

sudo tee /etc/systemd/system/[e-mail].d/autologin.conf << EOF[Service]ExecStart=ExecStart=-/sbin/agetty --autologin $USER --noclear %I \$TERMEOF

在 Raspberry Pi 上添加和安装 Moonlight

5.现在我们已经准备好了Raspberry Pi，下一步是将Moonlight软件包存储库添加到我们的操作系统中。
最简单的方法是运行Moonlight团队的官方脚本，在终端中输入以下命令。

curl -1sLf 'https://dl.cloudsmith.io/public/moonlight-game-streaming/moonlight-qt/setup.deb.sh' | distro=raspbian codename=$(lsb_release -cs) sudo -E bash

6.添加存储库后，我们只需使用以下命令即可在Raspberry Pi上安装Moonlight。

我们不必担心事先运行“apt update”，因为我们在上一步中运行的脚本已经为我们完成了它。

除非您的互联网连接速度较慢，否则Moonlight的安装过程应该不会花费太长时间即可完成。

sudo apt install moonlight-qt

设置 Moonlight 在 Raspberry Pi 启动时自动运行

7.安装完Moonlight后，让我们继续下一步，即设置游戏流媒体软件在Raspberry Pi启动时自动运行。

我们将通过编辑crontab文件以更轻松的方式实现这一点，使用以下命令。如果提示您选择用于编辑crontab的文本编辑器，我们强烈建议初学者使用Nano。

crontab -e

8.现在，您需要将以下行添加到该文件的底部。这行代码只是告诉Cron管理器在重启时运行“moonlight-qt”命令。

@reboot moonlight-qt

9.完成文件编写后，按CTRL + X、Y，然后按ENTER保存并退出。

10.一切就绪后，通过在终端中运行以下命令重启您的Raspberry Pi。

sudo reboot

11.如果一切正常，Moonlight应该在Raspberry Pi启动时运行。

您还可以考虑连接Xbox或PlayStation手柄以获得更好的体验。如果您已准备好，请继续阅读下一部分，了解如何使用Moonlight将其与Sunshine等游戏流媒体服务配对。

将 Raspberry Pi 上的 Moonlight 与您的流媒体服务器配对

12.现在您已经在Raspberry Pi上安装并运行了Moonlight，您可能希望使用它连接到您的计算机。

如果Moonlight自动检测到安装了Sunshine的流媒体PC，它应该出现在主屏幕上。您只需点击标识符（1.）即可开始配对。

如果您的PC没有出现，您可以点击右上角的小屏幕和加号（+）符号（2.）。这将弹出一个对话框，允许您手动指定服务器的IP地址。

13.选择您希望将Moonlight客户端与之配对的服务器后，您将看到一个PIN码。您需要使用此代码将您的Raspberry Pi与Sunshine流媒体服务器配对。

14.现在，在您尝试将Moonlight配对的设备上，打开Sunshine网页界面并转到“PIN”屏幕。

在此屏幕上，您可以输入显示在Raspberry PiMoonlight客户端上的PIN码（1.），然后为您的设备输入一个名称。

输入PIN码后，点击“发送”（2.）按钮完成配对。

15.回到 Moonlight 的设置，您电脑上的锁定符号现在应该已经消失了。现在点击设备将开始您的设备与 Sunshine 流媒体服务器之间的连接。

16.您现在将看到可以流式传输到您的 Raspberry Pi 的 Moonlight 实例的应用程序列表。如果您愿意，甚至可以流式传输整个桌面。

为了快速访问任何游戏，您可以通过 Sunshine 网页界面添加它们。

结论

希望在这个教程的这一阶段，您已经成功地在 Raspberry Pi 上安装并运行了 Moonlight。Moonlight 是将您的桌面或视频游戏流式传输到 Pi 的最佳解决方案之一。它支持保持高质量流的同时，将延迟降至最低。最重要的是，如您所见，设置此软件相对简单。