Sunshine+Moonlight自托管游戏串流搭建与调优指南

1. 为什么我要折腾自托管游戏串流

家里有台带独显的台式机，平时下班回来却懒得坐在书桌前，更想窝在沙发上用平板或者电视盒子打游戏。商业串流方案要么限制分辨率，要么对网络环境要求苛刻，延迟忽高忽低，玩动作游戏基本没法忍。后来我把目光转向了Sunshine + Moonlight这套组合——Sunshine 跑在游戏主机端负责采集和编码，Moonlight 跑在客户端负责解码和显示，两端都是开源项目，完全自托管，数据不出局域网，画质和延迟都能自己调。

这套方案解决的核心问题就一个：把高性能主机的游戏画面，低延迟地投送到另一台设备上。适合谁呢？适合手里有闲置显卡、喜欢折腾、对延迟敏感、又不想被商业方案绑定的玩家。你不需要是运维工程师，但得愿意花半小时跟着步骤走一遍。我前后搭过三套环境，踩过的坑基本都集中在编码器选择、网络配置和自启动这几个环节，这篇就把完整流程和避坑经验一次讲清楚。

2. 搭建前的整体设计与选型思路

2.1 为什么是 Sunshine 而不是其他方案

市面上串流方案不少，但自托管这个方向上，Sunshine 是目前社区活跃度最高、更新最勤的一个。它本质是一个游戏串流服务端，负责抓取桌面或指定游戏的画面，用显卡硬件编码器压成视频流，再通过局域网推给客户端。相比一些老牌方案，Sunshine 的优势在于跨平台支持好，Windows、Linux 都能跑，而且对 AMD、Intel、NVIDIA 三家显卡的硬件编码支持都比较完整。

选它的另一个原因是配置全部走 Web 界面，浏览器打开https://本机IP:47990就能改参数，不用去翻配置文件。对于我这种经常换编码器、调码率的人来说，图形界面省了大量时间。Moonlight 这边则是客户端，几乎覆盖了所有能装 App 的设备：Windows、macOS、Linux、Android、iOS，甚至树莓派和部分电视盒子都有对应版本。

2.2 硬件与网络的前置判断

在动手之前，先确认三件事，否则后面大概率白忙活。

第一，主机端必须有独立显卡或支持硬件编码的核显。软件编码（比如 x264）虽然能跑，但延迟和 CPU 占用会让你怀疑人生。NVIDIA 用 NVENC，AMD 用 AMF，Intel 用 QuickSync，这三家都有专门的编码单元，编码工作从 CPU 卸载到显卡，延迟能压到个位数毫秒。

第二，网络必须是有线优先。主机端强烈建议插网线，客户端如果条件允许也走有线。Wi-Fi 不是不能用，但 5GHz 频段是底线，2.4GHz 基本没戏。我实测过，主机有线、客户端 Wi-Fi 6 的情况下，1080p 60帧的串流延迟在 15ms 左右，完全可玩；但如果主机也走 Wi-Fi，延迟会飙到 40ms 以上，射击游戏直接放弃。

第三，确认客户端设备的解码能力。Moonlight 客户端需要硬件解码，老设备可能只支持 H.264，新设备普遍支持 HEVC 甚至 AV1。这个信息决定了你在 Sunshine 里该选哪种编码格式。

2.3 整体架构一句话说清

主机端装 Sunshine，负责采集和编码；客户端装 Moonlight，负责解码和显示；两者通过局域网连接，Sunshine 把视频流和音频流推给 Moonlight，Moonlight 把键鼠手柄输入回传给 Sunshine。整个链路不经过任何外部服务器，纯局域网通信。

3. 主机端 Sunshine 安装与核心配置

3.1 Windows 下的安装与首次启动

Windows 是最省事的平台。去 Sunshine 的官方发布页下载.exe安装包，双击一路下一步即可。安装完成后它会自动注册为系统服务并启动，托盘区会出现一个图标。右键图标可以看到几个选项，其中Open Web UI就是配置入口。

首次打开 Web 界面会提示设置用户名和密码，这个凭据是给 Web 管理界面和 Moonlight 配对用的，务必记牢。设置完成后进入主界面，左侧是导航栏，右侧是当前状态。默认端口是 47989（HTTP）和 47990（HTTPS），如果这两个端口被占用，安装时会报错，需要提前排查。

注意：Windows 防火墙可能会拦截 Sunshine 的入站连接。安装程序一般会自动添加规则，但如果 Moonlight 搜不到主机，第一件事就是去防火墙里确认 Sunshine 的规则是否存在且已启用。

3.2 Linux 下的安装与依赖处理

Linux 这边稍微麻烦一点，但也不复杂。以 Ubuntu 为例，官方提供了.deb包，下载后sudo dpkg -i安装即可。如果提示依赖缺失，跑一遍sudo apt install -f自动补齐。安装完成后 Sunshine 同样会注册为服务，用systemctl status sunshine可以查看运行状态。

Linux 下有几个额外的依赖需要注意。硬件编码需要对应的驱动和库：NVIDIA 需要装好官方驱动和libnvidia-encode，AMD 需要mesa-va-drivers和mesa-vdpau-drivers，Intel 需要intel-media-va-driver。这些库如果缺失，Sunshine 的 Web 界面里编码器列表会是空的，或者选了之后启动串流直接报错。

还有一个容易被忽略的点：Linux 下采集桌面需要 X11 或 Wayland 的权限。如果你用的是 Wayland 会话，Sunshine 可能无法直接抓屏，需要切换到 X11 或者配置额外的采集模块。我个人的做法是直接用 X11 会话，省去一堆麻烦。

3.3 编码器的选择逻辑与参数计算

进入 Web 界面后，最重要的配置项就是Encoder。列表里会列出当前系统可用的所有硬件编码器，比如nvenc、amf、quicksync等。选哪个取决于你的显卡品牌，这个没什么好纠结的。

真正需要动脑子的是码率和分辨率的搭配。码率太低画面糊，太高网络扛不住。我的经验公式是：1080p 60帧用 20-30 Mbps，1440p 60帧用 40-50 Mbps，4K 60帧用 80-100 Mbps。这个范围是基于局域网千兆环境得出的，如果你走 Wi-Fi，建议在基础上打七折。

还有一个参数叫Video Format，也就是编码格式。H.264 兼容性最好，几乎所有客户端都支持；HEVC 压缩效率更高，同码率下画质更好，但老设备可能解不了；AV1 是最新的，压缩效率最高，但目前支持 AV1 解码的客户端还不多。我的建议是：先试 HEVC，如果客户端黑屏或卡顿，再退回 H.264。

3.4 音频与输入设备的配置

音频方面，Sunshine 默认会采集系统输出，Moonlight 端直接播放。如果遇到没声音的情况，去 Web 界面的Audio选项卡确认输出设备选对了。Linux 下如果用 PulseAudio 或 PipeWire，可能需要手动指定 sink。

输入设备这块，Sunshine 支持键鼠和手柄的透传。手柄推荐用 Xbox 系列，兼容性最好，插上就能识别。PS 手柄也能用，但部分游戏可能需要额外映射。Moonlight 客户端那边会自动把本地输入回传，基本不需要额外配置。

4. 客户端 Moonlight 连接与画质调优

4.1 各平台客户端的安装要点

Moonlight 的客户端覆盖很广，但各平台安装方式不同。Windows 和 macOS 直接去官网下载安装包；Android 在应用商店搜 Moonlight 即可；iOS 需要外区账号，这里不展开；Linux 下可以用 Flatpak 或者 AppImage。

有一个热词提到了moonlight qt 原生客户端编译安装，这说的是 Moonlight 的 Qt 版本，适合想在 Linux 上自己编译、追求最新特性的用户。编译流程大致是：克隆仓库、装好 Qt 开发环境和依赖、cmake配置、make编译。这条路适合有编译经验的人，普通用户直接用现成的 Flatpak 包就够了，省时省力。

4.2 配对流程与常见卡点

主机端 Sunshine 跑起来之后，打开 Moonlight 客户端，它会自动搜索局域网内的主机。如果搜不到，可以手动添加 IP。点击主机图标后会弹出一个四位数的配对码，把这个码输入到 Sunshine 的 Web 界面PIN页面，配对就完成了。

这里最常见的卡点是搜不到主机。排查顺序是：先确认两台设备在同一网段；再确认主机防火墙没拦；然后确认 Sunshine 服务在运行；最后检查路由器有没有开启 AP 隔离（这个功能会阻止局域网设备互访，必须关掉）。

另一个卡点是配对码输入后没反应。这种情况多半是 Web 界面用的 HTTPS 证书不被浏览器信任，换个浏览器或者手动信任证书就能解决。

4.3 画质与延迟的平衡调法

Moonlight 客户端里可以覆盖主机端的部分设置，比如分辨率、帧率、码率。我的调优思路是先保延迟，再提画质。

具体操作：先把分辨率设成 1080p、帧率 60、码率 20 Mbps，跑一局游戏感受延迟。如果延迟稳定在 20ms 以内，再逐步提高码率到 30、40，观察画面是否更清晰、延迟是否仍然稳定。如果提高码率后延迟飙升，说明网络带宽或路由器处理能力到了瓶颈，这时候要么降码率，要么改走有线。

还有一个选项叫Frame Pacing，开启后能减少画面撕裂和抖动，但会略微增加延迟。动作游戏建议关掉，RPG 或策略游戏可以开启。

提示：Moonlight 的Stats覆盖层（默认快捷键 Ctrl+Alt+Shift+S）可以实时显示延迟、码率、丢帧数，调参时一定要开着看数据，别凭感觉。

5. 自启动、远程维护与进阶玩法

5.1 Sunshine 开机自启的配置方法

Windows 下 Sunshine 安装时默认就注册了自启服务，一般不需要额外操作。如果发现开机后没启动，去服务管理器里把 Sunshine 服务设为自动即可。

Linux 下用 systemd 管理，sudo systemctl enable sunshine就能设置开机自启。热词里提到的sunshine ubuntu 自启就是这个操作。如果自启失败，用journalctl -u sunshine看日志，多半是权限或依赖问题。

还有一个场景是无头启动，也就是主机不接显示器也要能串流。Windows 下需要装一个虚拟显示器驱动，让系统认为有屏幕接入；Linux 下可以用xserver-xorg-video-dummy配置一个虚拟显示。这个玩法适合把主机塞在角落、完全不接显示器的用户。

5.2 远程管理与状态监控

Sunshine 的 Web 界面本身就是远程管理入口，局域网内任何设备打开浏览器都能访问。我习惯在手机上存一个书签，随时查看当前串流状态、改改参数。

如果需要更细的监控，Sunshine 提供了 API，可以拉取当前会话的码率、延迟、编码器占用等数据。自己写个小脚本定时抓取，配合 Grafana 之类的工具做可视化，就能随时掌握主机负载情况。

5.3 串流之外的扩展用途

这套链路搭好之后，其实不只用来打游戏。热词里有人问自托管写小说用什么，虽然和串流不是一回事，但思路相通——都是把计算和存储放在自己手里。Sunshine 理论上也能串流桌面应用，比如把主机上的写作软件、剪辑软件投到平板上用。不过要注意，非游戏场景下鼠标指针的延迟感知会更明显，体验不如游戏串流那么顺滑。

另外，Moonlight 支持多客户端同时连接，但同一时间只有一个客户端能独占串流。如果想多人同时用，需要主机端有多块显卡或者用虚拟机拆分，这个属于进阶玩法，普通家庭场景用不上。

6. 常见问题排查与避坑经验

6.1 连接类问题速查

6.2 画质与延迟类问题

画面糊、马赛克多，基本是码率不够，往上加就行。但如果加了码率还是糊，可能是编码器本身的问题，换一个编码器试试。延迟高的话，先看是不是走了 Wi-Fi，再看主机端 CPU 和 GPU 占用是不是满了，编码器满载会导致帧生成变慢。

还有一个隐蔽的坑：显示器的刷新率和串流帧率不匹配。比如主机接的是 144Hz 显示器，但串流设的是 60 帧，Sunshine 采集时可能会做额外的帧率转换，增加延迟。解决办法是把主机显示器刷新率也设成 60Hz，或者让 Sunshine 直接采集游戏窗口而不是全屏。

6.3 驱动与兼容性坑

热词里有人问为什么英伟达驱动软件不能 moonlight 了，这个情况我遇到过。多半是驱动更新后 NVENC 的接口变了，或者 Sunshine 版本太老没跟上。解决办法很简单：把 Sunshine 更新到最新版，同时确认 NVIDIA 驱动是较新的版本。如果还是不行，去 Sunshine 的 GitHub issues 里搜一下，通常已经有解决方案。

AMD 这边偶尔会遇到 AMF 编码器初始化失败，重启一下 Sunshine 服务基本能解决。Intel 核显的话，确保intel-media-va-driver装的是最新版，老版本对 HEVC 的支持不完整。

6.4 我踩过的三个真实坑

第一个坑是主机休眠导致串流断开。Windows 默认一段时间无操作就休眠，串流过程中如果主机休眠，画面直接卡死。解决办法是在电源设置里把休眠设为“从不”，或者用脚本在串流期间阻止休眠。

第二个坑是音频采样率不匹配。主机输出是 48kHz，客户端却按 44.1kHz 解码，结果声音变调。去 Sunshine 的音频设置里把采样率固定成 48kHz 就好了。

第三个坑是手柄震动失效。Moonlight 默认不开震动透传，需要去客户端设置里手动开启。开启后如果震动延迟明显，说明网络回传链路有瓶颈，检查一下是不是 Wi-Fi 信号太弱。

7. 我个人在实际操作中的体会

这套方案我从第一次搭到现在，前后换了三台主机、四种客户端设备，最大的感受是：网络质量决定上限，编码器选择决定下限。网络好，4K 60帧都能跑得很稳；网络差，再怎么调参数也是白搭。所以如果你刚开始搭，别急着追求高画质，先把有线网络和基础 1080p 跑通，再一步步往上加。

另外，Sunshine 和 Moonlight 的更新都比较频繁，遇到问题先去官方仓库看最新版本和 issue 列表，很多时候你踩的坑别人已经踩过并且修好了。保持两端版本同步，能省掉大量排查时间。最后分享一个小技巧：把常用的串流参数存成 Moonlight 里的多个配置档，打不同游戏时一键切换，比每次手动调省事得多。