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
| 你的系统 | 命令 |
|---|---|
| Windows | winget install LizardByte.Sunshine |
| Linux | flatpak install flathub dev.lizardbyte.app.Sunshine |
| macOS | brew 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 编码参考值:
| 分辨率 | 帧率 | 推荐码率 | 适用场景 |
|---|---|---|---|
| 720p | 60fps | 5–10 Mbps | 手机、弱网 |
| 1080p | 60fps | 15–25 Mbps | 标准游戏体验 |
| 1440p | 120fps | 25–50 Mbps | 高刷屏 |
| 4K | 60fps | 50–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),仅供参考