
Sunshine 游戏串流从安装到把画面投上电视只需 5 步【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想在自己买的电视或平板上玩 PC 游戏Sunshine 游戏串流是目前最主流的自托管方案游戏跑在你自己的 PC 上画面由显卡实时编码后经局域网发出另一端的 Moonlight 客户端只负责解码和播放数据全程不出家庭网络。本文按检查 → 安装 → 配对 → 调优 → 排障的顺序带你走一遍读完后你可以串出第一场游戏。动手前先自查这两件事第一件你的显卡能不能硬件编码。串流的画面必须被实时压成视频流这个活如果丢给 CPU游戏帧率会先崩。Sunshine 用的是显卡自带的硬件编码器NVENC 就是 NVIDIA 显卡内置的编码引擎各平台支持情况大致如下显卡WindowsLinux备注NVIDIANVENCNVENC / VAAPI串流首选AMDAMFVAAPI4K 建议 VCE 3.1 以上IntelQuickSyncVAAPI集显可用Apple 芯片VideoToolbox—macOS 版为实验性手柄暂不支持无独显软件编码软件编码全平台兜底吃 CPU完整的支持矩阵在 README.md 的 Feature Compatibility 部分拿不准就查那张表。第二件网络够不够稳。官方文档反复强调实时串流最关键的指标不是带宽而是稳定性——延迟低、波动小、几乎不丢包。官方最低建议是主机和客户端都走 5GHz 的 802.11ac Wi-Fi想上 4K 则两端都要 Cat5e 以上有线。内存 4GB、i3 或 Ryzen 3 级别的 CPU 就够用了门槛不高。安装走最短路径别急着编译源码Sunshine 每个平台都提供现成安装包除非你是开发者否则没必要从源码编译构建文档见 docs/building.md。Windows从 release 页下载 MSI 安装器如Sunshine-Windows-AMD64-installer.msi运行向导即可。官方特别提醒安装器里的可选项要一项项看清楚别默认全勾。Linux优先用发行版对应的包——Ubuntu/Debian 下 debFedora/OpenSUSE 下 rpm 或 copr 源Arch 有现成包。注意官方对 AppImage 和 Flatpak 两个通用包都有警告它们不支持 KMS 屏幕捕获发行版有专包就别用它们用 Flatpak 的话装完还要再跑一次additional-install.sh同步 udev 规则。macOS下载对应架构的 DMG拖进 Applications。目前是实验性版本手柄不工作。Docker官方态度是不推荐大多数用户使用容器里拿不到完整的显卡和输入设备访问新手别从这里开始。以 Ubuntu 24.04 为例安装并让 Sunshine 开机自启只需两行sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb systemctl --user --now enable app-dev.lizardbyte.app.Sunshine第一行安装发行版专包换成你的发行版和版本第二行启用 systemd 用户服务让 Sunshine 以后在后台常驻——这是 Linux 上让它开机就在的标准做法。第一次配对浏览器里设密码电视上输 PINSunshine 装好后所有配置都在 Web 界面里完成地址是https://localhost:47990在本机浏览器打开浏览器报不安全是正常的因为证书是自签的。第一次进入会要求你创建用户名和密码务必记牢忘了后面有恢复办法。接下来在 Moonlight 客户端上操作它会自动发现局域网里的 Sunshine 主机发现不了就手动填主机 IP 添加。客户端请求连接时会让你输入一个 PIN——切回 Web 界面点顶栏的 PIN 一栏把客户端上显示的 PIN 输进去再给这台设备起个名字配对就完成了。然后在 Applications 标签里添加要串流的应用几个新手最容易踩的坑默认自带一个Desktop应用它不启动任何程序只串桌面适合先验证整条链路是否通。Steam 这类常驻程序要以detached分离方式添加否则流会随着进程退出而断开。应用的准备命令prep command有一条失败该应用就不会启动添加前先确认路径没写错。Windows 上客户端的手柄要工作需要另装 Virtual HID 驱动装完建议重启一次电脑。觉得卡或画质差先动这三个参数连上之后觉得画面糊或操作粘手不要盲目重启按顺序查这三个地方。参数一码率。串流画质基本由码率决定参考区间是 720p 约 10-15 Mbps、1080p 约 20-30 Mbps、4K 约 50-100 Mbps。网络撑不起你设的码率时Sunshine 会丢包、画面发虚。Web 配置里的max_bitrate可以限制上限避免客户端把码率拉得过高。参数二编码器。配置页的 encoders 项决定用哪个编码器。一个实用的判断技巧临时切到软件编码试一把——软件编码能串通而硬件编码不行问题就在驱动或编码器本身而不是 Sunshine 配置。参数三网络稳定性。官方文档给了一个标准测试方法主机上起服务客户端上打流量# 主机执行 iperf3 -s # 客户端执行50Mbps、60 秒、UDP iperf3 -c 主机IP -t 60 -u -R -b 50M看客户端输出的丢包和抖动理想状态是丢包 5% 以下、抖动低于 1ms。另有一个典型场景——主机是 2.5G 有线而客户端只有百兆或 Wi-Fi主机发得比路径消化得快路由器缓冲溢出就大面积丢包。解法是把主机网卡降速或在 Linux 上用tc只限制 Sunshine 的流量新版 Sunshine 已改进网络代码多数情况会缓解。所有配置项都能用配置页顶部的搜索框直接搜到不用一页页翻想深入看的读者视频编码主流程在 src/video.cpp音频捕获在 src/audio.cpp各平台的屏幕捕获和输入实现则分别放在 src/platform/ 下的 linux、windows、macos 目录里。出问题时按这四步走先看日志。Web 界面的 Troubleshooting 标签会直接列出当前有哪些 warning 和 error逐条点开就是官方给的原因说明忘了 Web 界面的密码在主机终端重置即可sunshine --creds 新用户名 新密码这条命令直接改写登录凭据专治进不了配置页。Web 页面打不开先查防火墙Sunshine 的 47990 端口没放行是最常见原因。手感不对鼠标行为怪异时在主机上插一个实体鼠标试试手柄在 Steam 里正常但游戏里失灵去 Steam 的手柄设置里只保留 Generic controller 支持并尽量让 Sunshine 虚拟出来的手柄成为系统里第一个手柄。更多症状对照可以直接翻 docs/troubleshooting.md上面列的每条都是社区实际踩过的坑。跑通之后还有三件事值得做先用CtrlAltShiftF1/F12试试切换串流到不同显示器用CtrlAltShiftN隐藏光标——这组快捷键和 Moonlight 保持一致串多显示器的主机很实用。如果你在 Windows 主机上有一台 HDR 显示器可以直接开 HDR 串流官方正式支持Linux 上仍是实验性且必须用 KMS 捕获。接下来具体可以做的三件事今晚挑一个 1080p 游戏按 20-30 Mbps 码率串一场记录实际流畅度跑一次 iperf3 测试把你家网络的真实丢包水平记下来后面调参才有依据每次出问题把 Troubleshooting 页的日志存一份这比描述症状快十倍。全部配置项的参考文档在 docs/configuration.md用到哪查哪。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考