Sunshine 免费游戏串流指南：30 分钟让 PC 游戏出现在每一块屏幕上

Sunshine 免费游戏串流指南：30 分钟让 PC 游戏出现在每一块屏幕上

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

Sunshine 是一款开源免费的自托管游戏串流服务器，专为 Moonlight 客户端设计，能把电脑里的游戏以极低延迟串流到电视、平板、手机等任何设备上。它支持 Windows、Linux、macOS 与 FreeBSD，自动调用 NVIDIA NVENC、AMD AMF 和 Intel QuickSync 硬件编码，让你彻底告别云游戏订阅费，同时牢牢守住自己的游戏库与隐私。

先讲一个你大概率经历过的场景。你的游戏 PC 性能强劲，却只能待在书房的桌面上。周末想瘫在客厅用大电视玩 3A 大作？出差路上想在平板上继续昨天的进度？把主机搬来搬去不现实，云游戏服务要么游戏库受限，要么每月一笔订阅。Sunshine 就是为这个场景而生的：游戏依然在你的电脑里运行，Sunshine 负责把画面编码、通过网络送出，任意设备上的 Moonlight 客户端负责解码显示——性能不打折，数据不出家门。

如果你也想让家里每一块屏幕都能玩 PC 游戏，这篇文章会带你走完一条完整路径：先搞懂串流原理，再 30 分钟跑通第一次串流，遇到卡顿黑屏能自己定位修复，最后把它调教成称手的家庭游戏平台。

一、先看懂原理：Sunshine 到底替你做了什么

串流听起来很玄，本质只有两步：编码与解码。Sunshine 运行在你的游戏 PC 上，抓取画面后用显卡的专用编码器压缩成视频流；Moonlight 客户端在电视或手机上接收并解码播放，同时把你的手柄、键盘操作传回主机。整个过程你的游戏文件、存档、进度都留在本地，传输的只是一帧帧画面数据。

这也是"自托管"最打动人的地方。和云游戏对比一下，差异非常直观：

Sunshine 的另一个聪明之处在于硬件编码。如今的显卡都内置了视频编码器，Sunshine 会按你的硬件自动选择最合适的方案：NVIDIA 走 NVENC，AMD 走 AMF，Intel 走 QuickSync，实在没有独显还能退回 CPU 软编码。编码器模块在源码的 src/nvenc/ 目录，各平台的采集实现则在 src/platform/ 下，感兴趣可以慢慢研究，普通用户只需知道：这套机制保证了不同硬件上都能拿到可用的画质与延迟。

到这里，你应该已经能回答"为什么要用它"。接下来动手。

二、30 分钟落地：从安装到第一次串流成功

第一步：按你的系统挑一种安装方式

每种系统都有最顺手的安装路径，任选其一即可：

# Windows（推荐，一条命令搞定） winget install LizardByte.Sunshine # Linux（Flatpak 方式，兼容主流发行版） flatpak install flathub dev.lizardbyte.app.Sunshine # macOS（Homebrew 方式） brew install sunshine # Docker（想跑在 NAS 或容器环境） docker pull lizardbyte/sunshine # 想自己编译最新版（克隆官方仓库后按 docs/building.md 构建） git clone https://gitcode.com/GitHub_Trending/su/Sunshine

安装完成后启动服务。到这一步，Sunshine 已经在后台跑起来了，你需要做的只是设置访问凭证。

第二步：打开 Web 界面，设置访问密码

在浏览器访问https://localhost:47990（首次访问会有自签名证书提示，确认继续即可），你会看到欢迎界面：

界面上默认用户名是sunshine，你需要设置并确认一个密码。强烈建议用密码管理器生成一个足够强的新密码——这个密码保护的是你整台电脑的画面访问权，别偷懒。

设置完成后点击登录，你就进入了 Sunshine 的主控面板。到这里，"服务端"这半边已经就绪。

第三步：用 Moonlight 完成配对，发起第一次串流

在手机、平板或另一台电脑上安装对应平台的 Moonlight 客户端（各平台客户端都能在 Sunshine 的"精选应用"页找到下载入口）。让客户端与 Sunshine 主机连在同一个局域网，然后：

1. 打开 Moonlight，它会自动发现局域网内的 Sunshine 主机；
2. 如果没自动发现，手动添加主机 IP 也能连上；
3. 点击主机图标，屏幕会出现 4 位 PIN 码；
4. 把 PIN 填进 Sunshine 的 Web 界面完成配对；
5. 回到 Moonlight，选择"桌面"或已配置的应用，点击开始串流。

验证产出：画面在客户端上流畅出现，手柄按键和鼠标移动无感延迟，就说明整条链路已经打通。到这里，你已经成功把书房里的 PC 游戏搬到了另一块屏幕上——整个过程不需要注册任何账号，也没有一分钱订阅费。

三、翻车现场：串流最常见的 5 类问题，一次解决

第一次串流顺利不代表永远顺利。根据社区里高频出现的问题，我帮你把"翻车现场"按症状归类，并给出对应的排查路径。

问题 1：客户端找不到 Sunshine 主机

先别怀疑网络，按顺序排查：确认 Sunshine 服务正在运行；确认两台设备在同一局域网；检查系统防火墙是否放行了 47990 等端口；最后重启路由器让 mDNS 广播恢复正常。如果自动发现始终失败，在 Moonlight 里手动添加主机 IP是绕开发现机制最稳的办法。

问题 2：画面卡顿、掉帧

卡顿 90% 出在"码率超出网络承载能力"或"编码器不堪重负"。优先做两件事：在 Sunshine 的配置里适当降低码率或分辨率；确认用的是硬件编码而非 CPU 软编码（显卡驱动过旧时容易退化）。同时关掉下载、在线视频等抢带宽的应用，再试一次。无线用户请参考下一节的网络优化建议。

问题 3：黑屏或花屏

黑屏通常和分辨率匹配有关——客户端请求的分辨率与主机显示器原生分辨率不一致，或 HDR 在某一端未正确开启。先尝试把串流分辨率设成显示器的原生分辨率；HDR 串流需要主机端和客户端同时启用，缺一不可。多显示器用户还要确认串流捕捉的是正确的那块屏幕。

问题 4：串流没有声音

声音问题多数出在音频输出设备选择上。确认 Sunshine 配置里音频设备指向了正确声卡，而不是某个已断开的虚拟设备；如果主机的音频被其他应用独占，也可能导致静音。

问题 5：以上都试过还是不行——去看日志

Sunshine 最有价值也最容易被忽略的能力，是它详尽的运行日志：

日志页面会直接给出错误线索，比如"Could not open codec"这类编码器加载失败提示，配合 GPU 型号、分辨率等上下文，能帮你少走大量弯路。各平台日志位置如下：

完整排查思路还可以参考项目自带的 docs/troubleshooting.md，里面按症状整理了更细的解决步骤。

四、从"能玩"到"玩得爽"：编码、码率与网络调优

串流跑通只是及格线，想要稳定的高画质体验，重点调三件事：编码器、码率、网络。

编码器：让显卡干它最擅长的事

Sunshine 会优先使用硬件编码，但你有权手动干预。原则很简单：NVIDIA 显卡优先 NVENC，AMD 优先 AMF，Intel 核显优先 QuickSync。如果遇到编码器异常，或者你更在意画质而不是极致延迟，可以切换到软件编码兜底。这些选项都能在 Web 界面的配置页里找到，用搜索框输入关键词即可快速定位：

码率与分辨率：匹配你的屏幕和网络

码率不是越高越好，而是"刚好喂饱你的网络"。给出一个经过大量用户验证的参考区间：

经验法则：先跑低一档确认流畅，再逐级往上加码率，直到画面出现卡顿的临界点再回调 20%，就是属于你的最佳值。

网络：有线优先，无线讲策略

串流对网络的敏感度远超普通视频。结论先行：主机端务必用有线网，客户端能上有线也上有线；必须用无线时，选 5GHz 或 WiFi 6 频段，离路由器近一点，并在路由器上开启 QoS 优先保障串流流量。另外，Sunshine 支持 UPnP 自动端口转发（配置页里有开关），能让网关自动放行串流所需端口，省去手动配置的麻烦，也避免"局域网能连、换网络就连不上"的经典坑。

如果打算在外网远程串流，需要在路由器上手动转发相应端口范围，并配合强密码使用——这部分属于进阶玩法，建议先吃透局域网场景再尝试。

五、把 Sunshine 玩出花样：应用库、精选工具与进阶玩法

串流稳定之后，Sunshine 真正的价值才开始显现——它不止是"把桌面推出去"，而是一个可定制的家庭游戏平台。

应用管理：让每个游戏有自己的启动方式

在"Applications"页面，你可以把桌面串流、Steam 大屏模式、独立游戏、模拟器分别配置成独立的应用入口，每个都可以设置独立的启动命令：

常见的配置思路：整机串流用"桌面"应用，方便随意切换游戏；主打手柄客厅体验就加一个 Steam 大屏模式入口（启动命令指向 Steam 的 Big Picture 协议）；想直连某个游戏，则直接把它的可执行文件路径配成独立应用。配置后重启客户端即可看到新应用列表。

精选应用：官方帮你挑好的客户端全家桶

"Featured Apps"页面是 Sunshine 团队整理的工具集市，覆盖了几乎所有平台的 Moonlight 客户端和配套工具：

电视用户关注 Moonlight Embedded 类方案，移动党装 Moonlight Android，PC 用户直接下载桌面版，各取所需，下载入口和官方说明都在这一页，不用自己去网上乱找。

进阶玩法：多显示器、手柄与性能监控

• 多显示器：Sunshine 支持指定串流捕捉哪块屏幕，多屏用户可以把游戏固定在副屏、把串流输出到主屏，互不干扰；
• 手柄映射：Xbox、PlayStation、Switch Pro 等主流手柄都能识别，Linux 下走虚拟手柄方案，Windows 下配合 ViGEm 驱动即可即插即用；
• 性能监控：串流中可实时查看编码延迟、网络延迟、丢包率和帧率波动，这些指标能直接回答"卡顿到底是网络还是编码的锅"。

深度配置项的完整说明在 docs/configuration.md，性能调优方法论在 docs/performance_tuning.md，都是官方维护的，遇到具体参数直接去查。

六、避坑清单：新手最容易踩的 5 个坑

最后把新手期最高频的失误集中列出来，对照检查，能帮你省下大量排查时间：

1. 弱密码 + 默认用户名裸奔：串流意味着你的画面可以被任何人看到，务必设置高强度密码；
2. 只看 WiFi 信号不看稳定性：信号满格但丢包严重一样卡，优先有线，无线至少用 5GHz；
3. 码率、分辨率盲目拉满：拉满必然卡顿，先低后高逐级找平衡点；
4. 忽略防火墙与端口：连不上先查 47990 端口放行，别急着怀疑主机坏了；
5. 凭感觉排查，不看日志：Sunshine 的日志已经把错误原因写得明明白白，先读日志再动手。

下一步，就现在

回到开头那个场景：书房里的游戏 PC，客厅的电视，出差路上的平板。装好 Sunshine、配上 Moonlight、调好码率——三者之间就不再隔着"想玩但够不着"，而是随时可以无缝切换的一块块屏幕。整个过程免费、自托管、数据全在你自己手里。

现在就可以做三件事：打开https://localhost:47990设置你的访问密码；在设备上装好 Moonlight 完成配对；然后挑一款游戏，把它从书房"搬到"客厅试试。30 分钟后，你收获的不只是一个串流服务，而是一套属于自己的家庭云游戏平台。

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine