Sunshine 游戏串流配置教程：5分钟起步，把客厅电视变成低延迟游戏终端
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
周六晚上，手柄插在 PC 上，游戏画面却投在客厅电视里——这是 Sunshine 游戏串流 最典型的使用场景。Sunshine 搭配 Moonlight 的分工很明确：Sunshine 作为自托管服务器跑在 Windows / Linux / macOS 主机上，负责画面采集、硬件编码与输入转发；Moonlight 客户端在电视、手机或平板上解码播放。本文按真实使用顺序把下载、配对、编码器选择与排障串成一条路径，可以直接当一份 Sunshine 配置教程 来读。
一条最短路径：下载、配对、第一次开流
起点是拿到代码。无论是想编译源码还是只是看项目结构，第一步都一样：
git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine新手其实不必编译——项目针对 Windows、Linux、macOS 分别发布安装包，装完即可运行；从源码构建更适合要改行为的人。两条路之后的体验完全一致。
第一次启动后，浏览器里会出现一个欢迎页：Sunshine 的一切配置都通过 Web 界面完成，默认地址是 https://localhost:47990（也可以把 localhost 换成本机内网 IP）。浏览器提示不安全属于正常现象，因为证书是自签发的。在欢迎页设置一组用户名和密码，这组凭据之后所有管理操作都会用到，记牢它。
账户建好后，接下来要决定串流什么。Sunshine 把串流对象统一抽象为“应用”：内建的 Desktop 应用没有任何启动命令，只是把整个桌面推出去；其余条目各自指向一个游戏或程序，串流开始时由 Sunshine 负责拉起。前者适合想操作整台机器的场景，后者适合配对完直接进入某个游戏。记住两条规则：启动新应用会终止当前正在运行的那个；应用退出时串流也随之结束。
最后一步是配对：在 Moonlight 客户端里搜索你的主机（搜不到就手动添加），出现 PIN 验证时，到 Web 界面的 PIN 页面输入对应数字并给设备命名。至此整条最短路径走完，可以开始第一次串流。
按显卡选编码器，按网络定比特率
游戏串流低延迟 一半靠编码后端，一半靠带宽，所以这两件事放在一起决定。
串流编码器选择：先认清你的显卡
编码后端决定编码是否占用游戏渲染资源、高帧率下还剩多少余量。按硬件对号入座：
| 你的硬件情况 | 实际调用的编码器 | 这样选的好处 |
|---|---|---|
| NVIDIA GeForce | NVENC | 专用编码芯片，不和渲染抢 GPU 时间，高帧率与 4K 场景最稳 |
| AMD Radeon | AMF（Linux 上走 VAAPI） | 硬件编码引擎，主流游戏下质量接近 NVENC |
| Intel 核显（含 Arc） | Quick Sync | 没有独显时的主力方案 |
| 无任何硬件编码单元 | 软件编码 | 只能做功能验证，CPU 占用高、延迟不可控，不建议日常使用 |
硬件编码的意义在于帧率和分辨率可以往上加，而功耗与延迟仍处在可预期范围；代价是要留意显卡驱动版本，过旧的驱动会让编码后端不可用。
三种音频捕获方案怎么选
音频有三条路线。系统全局捕获把系统默认播放设备的声音整段抓进串流，主机喇叭和客户端听到同一份内容，适合桌面串流；按进程捕获只让某个游戏的声音进串流，通过配合虚拟设备、把指定游戏的输出路由过去实现，IM 提示音之类的杂音不会串进来；虚拟音频设备（对应 virtual_sink 设置）在串流的同时把主机喇叭静音，Steam 附带的 Steam Streaming Speakers 驱动是现成的选项之一。在客厅玩游戏、不想让主机再出声时，选第三种。
局域网与公网的比特率建议
| 网络环境 | 比特率 | 帧率 | 思路 |
|---|---|---|---|
| 局域网（有线或 5GHz Wi-Fi） | 20–50 Mbps | 60 fps | 为高分辨率和高帧率留足余量，优先保画质 |
| 公网 / 跨地域 | 5–15 Mbps | 30–60 fps | 先保不卡再谈清晰度，帧率可以让步 |
两个实用细节：max_bitrate 设置可以对编码比特率设上限（填 0 表示跟随 Moonlight 客户端的请求）；走公网串流时，在网络设置里开启 UPnP，Sunshine 会自动尝试打开所需端口。
什么时候用得上：Steam、手柄、多屏与自定义启动
Steam 游戏库直接进串流列表
主机装有 Steam 时，Sunshine 可以把游戏库直接拉进来当作应用，省去逐个手写启动命令的麻烦，串流到大屏幕界面也能正常工作。这是大多数人的入门姿势。顺带一提，前面提到的 Steam Streaming Speakers 也是从这条路径获得的“主机静音”方案。
手柄没反应时的检查顺序
Sunshine 在主机侧模拟虚拟手柄，客户端的输入会被转成对应设备。按下没反应时按这个顺序排查：
- 确认 Input 设置里控制器处于开启状态；
- 核对模拟手柄类型（Xbox 360 / One、DualShock 4、DualSense 等）与客户端设备匹配；
- 逐个按键实测响应；
- 最后打开震动反馈。
一个例外要提前知道：macOS 主机目前不支持手柄模拟，需要手柄输入时请用 Windows 或 Linux 做主机。
多台显示器接在主机上
主机接了多台显示器时，默认只输出其中一块，而默认串流目标正是内建的 Desktop 应用：
在 Display 设置里可以指定用哪个适配器、串流哪个输出，并设定目标分辨率与刷新率；串流进行中还能用 Ctrl+Alt+Shift+F1～F12 热键切换输出。显式指定的好处是，拔插显示器或系统重新枚举时不会让画面落到意料之外的屏上。
给某个游戏写专属启动参数
应用列表（Web 界面维护，底层是 apps.json）允许为每个应用定义启动命令、工作目录、环境变量，以及游戏启动前执行的 prep-cmd。两条规则要记牢：prep-cmd 执行失败会直接中止启动；应用退出时串流随之结束。“进游戏前切高性能电源模式”“固定某个环境变量”这类需求，都放在这里做。
排障速查：无声、卡顿与资源占用
Sunshine 的排障页面聚合了日志与警告，出问题先看那里。高频问题可以套用“现象 → 最可能原因 → 一步验证”：
现象：画面频繁卡顿，操作发飘。最可能原因：实际带宽低于设定的比特率，或编码退回到了软件路径。一步验证：把比特率或帧率降一档，卡顿时立刻消失就是带宽问题；否则查日志里的编码后端与驱动状态。
现象：主机有声音，客户端无声。最可能原因：音频设备选错，或有其他应用独占了设备。一步验证：确认 Audio 设置里的设备是系统真正的默认输出，并临时关掉可能独占的应用。
现象：串流时 CPU 占用很高。最可能原因：硬件编码单元没生效，编码跑在 CPU 上。一步验证：到 Audio/Video 设置页查看可用编码器，切回显卡硬件编码。
现象：内存占用偏大。最可能原因：缓冲与后台程序吃掉了内存。一步验证：调低分辨率或比特率，再清掉后台程序，观察内存是否回落。
现象：连接后输入没反应（Linux 主机）。最可能原因：运行用户没有虚拟输入设备的权限。一步验证：把该用户加入 input 组，注销后重新登录。
收尾：先跑通，再谈调优
一句话总结：Sunshine 游戏串流 是一个“先跑通、再按显卡选对编码器、最后按网络调参数”的过程，不存在通用最优配置。下一步建议：还没跑起来的，按“最短路径”一节走一遍；已经跑起来的，先到编码器表格确认硬件编码已生效，遇到具体症状再对照排障速查。各项设置的完整说明，可查阅仓库内的 docs/ 目录。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
