☰
Sunshine 游戏串流实战指南:三步把 PC 游戏库接到全家每一块屏幕
2026/10/23 22:56:00 网站建设 项目流程

Sunshine 游戏串流实战指南:三步把 PC 游戏库接到全家每一块屏幕

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

Sunshine 是一款完全免费、开源的游戏串流主机,官方定位是 "Self-hosted game stream host for Moonlight"。它装在你的 PC 上,把正在运行的游戏画面实时编码成视频流推给其他设备,同时把远端设备的键盘、手柄输入回传给主机。

用三个场景说明它替你做什么:

  • 傍晚,书房的 PC 还挂着昨晚的游戏,你想在客厅电视上接着打;
  • 睡前,想在平板上用手柄再刷一把日常;
  • 出差住酒店,想用笔记本打开家里模拟器里的老游戏。

共同点:游戏在书房,屏幕在别处。有了 Sunshine,机器不动,只动画面。🛋️

底层逻辑:Sunshine 凭什么做到低延迟

把 Sunshine 想象成一个"家庭转播台",三个角色分工明确:

  • Sunshine 主机端:负责抓屏(Linux 走 X11/Wayland/KMS,Windows 走 DXGI)、用 GPU 硬件编码器把画面压成 H.264/HEVC 码流、推送到网络,同时附带一个 Web 管理台;
  • Moonlight 客户端:收流、解码、显示,并把键盘、鼠标、手柄输入回传;
  • 手柄虚拟化:客户端的手柄会被"虚拟"成主机系统里的一块手柄设备,Windows 下需要 ViGEmBus 驱动做桥接。

关键在于编码由 GPU 上的专用硬件完成——NVIDIA NVENC、AMD AMF、Intel QuickSync 各管一摊,CPU 几乎不介入,所以延迟低、画质损失小。硬件门槛也不高:4GB 以上内存、i3/Ryzen 3 起步的 CPU、任何带硬件编码的显卡就能跑起来。

从零跑通:Sunshine 安装命令与配对步骤

第一步:一条命令装好 Sunshine

你的系统命令
Windowswinget install LizardByte.Sunshine
Linuxflatpak install flathub dev.lizardbyte.app.Sunshine
macOSbrew install sunshine
Docker(NAS/服务器)docker pull lizardbyte/sunshine

想自己编译定制,克隆官方仓库即可:

git clone https://gitcode.com/GitHub_Trending/su/Sunshine

第二步:给管理台设一把"门锁"

装完在浏览器打开http://localhost:47990。首次进入要求设置用户名和密码——用户名默认sunshine,密码建议12 位以上,字母、数字、符号混搭。这是整个串流系统唯一的门锁,且只显示一次。

第三步:Moonlight 客户端配对

在目标设备装对应客户端(Android、iOS、PC、电视都有),与主机处于同一局域网。Moonlight 会自动发现 Sunshine 主机,把管理台 "PIN" 页面显示的配对码输进去,绑定完成,全程不用手动配端口。

做到这里,客户端点开内置的 "Desktop" 就能看见主机桌面。各系统的详细安装差异见 docs/getting_started.md。

场景化实战:按你想达成的目标来

游戏入口配置:给每款游戏单独建一个快捷方式

默认内置 Desktop 和 Steam Big Picture 两个入口,直接能玩。想让客户端列表更清爽,就到 Applications 页面点 "Add New",填名称和启动命令:

  • Steam 库:steam://open/bigpicture,适合手柄浏览;
  • 独立游戏:直接指向可执行文件,如D:\Games\Hades\Hades.exe;
  • 模拟器:指向 RetroArch 主程序,核心参数写进启动参数里。

小贴士:每个入口能单独配置"退出后回到桌面"的行为,避免串流结束客户端一直黑屏。

多设备连接:一次配置,全屋通用

同一台 Sunshine 可以被多个 Moonlight 客户端分别连接——手机、平板、电视、笔记本各配一次 PIN 就各用各的。布线建议:主机端有线,客户端 5GHz WiFi。同时能连几路取决于显卡编码能力,一般 1–2 路体验最佳。

设置定位:搜索框比翻页快

所有设置项集中在 Configuration 页面,顶部搜索框输关键词直接跳转。比如输 "Upnp" 就跳到自动端口转发开关,改完点 Save 即时生效。

小贴士:右上角 Theme 下拉可以换主题和语言,深色主题在晚上开大屏时更护眼。

画质参数推荐值:码率帧率速查表

编码器不用你选,Sunshine 自动识别 GPU 走 NVENC、AMF 或 QuickSync。你要管住的只有码率、帧率、分辨率三件事,HEVC 编码参考值:

分辨率帧率推荐码率适用场景
720p60fps5–10 Mbps手机、弱网
1080p60fps15–25 Mbps标准游戏体验
1440p120fps25–50 Mbps高刷屏
4K60fps50–100 Mbps大屏 + 有线网络

三条调优硬经验:

  • 有线优先,WiFi 至少 5GHz,避开 2.4GHz 拥塞段;
  • 帧率对齐游戏原生帧率(60/120/144),别让编码器做多余转换;
  • 两端都支持 HDR 时务必把设置对齐,否则画面会发灰。

避坑指南:高频现象、原因与解法

Moonlight 发现不了主机

  • 原因:防火墙拦了 47984–47990 端口段,或两台设备不在同一子网。
  • 解法:放行该端口段,确认两端同网段(比如都是 192.168.1.x);或在管理台 Network 分组里开启 UPnP。

画面卡顿、掉帧严重

  • 原因:带宽不够,或显卡驱动拖后腿。
  • 解法:码率降一档;关掉下载、直播这类占带宽的应用;更新显卡驱动,编码器性能常随驱动提升。

手柄连上了但游戏里没反应

  • 原因:Windows 主机缺 ViGEmBus 虚拟手柄驱动。
  • 解法:在 Troubleshooting 页面一键安装 ViGEmBus,装完重启 Sunshine。

配置改了不生效

  • 原因:改完没点 Save,或该项本来就要求重启服务。
  • 解法:保存后留意界面提示;网络相关项重启一次服务更稳。

日志报 "Encoder not found"

  • 原因:当前 GPU 不支持所选编码器,或驱动过旧。
  • 解法:先核对驱动版本,再把编码器切回硬件实际支持的格式。

管理台的 Logs 页面自带搜索和错误高亮,报错会直接标红,比翻文件快得多;本地日志文件在 Windows 的%ProgramFiles%\Sunshine\config\sunshine.log,Linux/macOS 的~/.config/sunshine/sunshine.log。以上都没解决时,完整排障手册见 docs/troubleshooting.md。

行动清单:今晚就跑起来

  • 用对应系统的一条命令装好 Sunshine
  • 在 localhost:47990 设好 12 位以上强密码
  • 手机或平板装 Moonlight,完成 PIN 配对
  • 给常玩的游戏添单独入口(或先直接串桌面)
  • 按速查表把码率、帧率调到推荐值

PC 留在书房继续渲染,你在沙发、电视、平板上玩——家里的每一块屏幕,都能成为游戏库的窗口。🎮

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询