Sunshine 5分钟安装教程:把 PC 变成低延迟游戏串流主机
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
主力机在书房,你却想在客厅电视或卧室平板上打 3A 大作。Sunshine 是一款开源的自托管游戏串流主机:装在你自己的电脑上,由 GPU 负责编码,再通过局域网把画面串流给任何装了 Moonlight 客户端的设备,手柄一接就能玩。
🧭 Sunshine 是什么,适合谁
它是游戏串流方案的服务器端,核心价值有三点:局域网低延迟(串流数据不出内网)、GPU 硬件编码(NVIDIA、AMD、Intel 各有对应编码器,软件编码兜底)、开源自托管(谁可以访问由你决定,不经过第三方云)。
硬件门槛不高:4GB 内存、i3 或 Ryzen 3 起步就能跑,显卡越好 4K 串得越顺。
⏱️ Sunshine 5分钟安装教程:从下载到第一次串流
第一步:安装主机端。Windows 用官方 MSI 安装包,服务和防火墙规则自动配好;Linux 用 deb/rpm 包一行命令或 Flatpak;macOS 拖拽 DMG 或走 Homebrew。
# Ubuntu / Debian sudo apt update && sudo apt install sunshine # 或通用 Flatpak flatpak install --user flathub dev.lizardbyte.app.Sunshine第二步:启动服务。Windows 安装包默认注册为常驻服务;Linux 执行systemctl --user enable --now app-dev.lizardbyte.app.Sunshine即可登录自启。
第三步:登录 Web 界面。浏览器打开localhost:47990(提示“不安全”是因为自签名证书,忽略即可),创建用户名和密码——这是你唯一需要记住的凭据。
第四步:添加第一个应用。系统自带桌面(Desktop)和 Steam 大屏模式(steam://open/bigpicture);自定义游戏只需填可执行文件路径、工作目录和启动参数。
第五步:配对客户端。Moonlight 里添加这台主机,它会索要 PIN,把 Sunshine “PIN”页显示的 PIN 填进去确认即可。
第六步:开始串流。在 Moonlight 选任意应用点开,几秒内游戏画面就会出现。
怕麻烦?默认配置就能直接串,90% 的微调都在 Web 界面的 Configuration 页完成。
🎥 三个最值得先知道的能力
硬件编码:按你的显卡自动选最合适的编码器
Sunshine 按 GPU 选型:NVIDIA 走 NVENC,AMD 在 Windows 用 AMF、Linux 用 Vulkan Video/VAAPI,Intel 在 Windows 用 QuickSync、Linux 用 VAAPI,任何平台都有软件编码兜底。编码压力全在 GPU 的专用编码器上,CPU 几乎不占,这就是低延迟的来源。默认自动选择,多显卡系统到 Configuration 页指定编码器和抓取哪块屏幕即可。
| 显卡 | Windows | Linux |
|---|---|---|
| NVIDIA | NVENC | NVENC / VAAPI |
| AMD | AMF | Vulkan Video / VAAPI |
| Intel | QuickSync | VAAPI |
| 任意平台 | 软件编码(CPU) | 软件编码(CPU) |
macOS 用 Video Toolbox(官方标注实验性)。4K60 想稳,NVIDIA 建议 GTX 1080/RTX 20 系及以上、AMD VCE 3.1+、Intel HD 510 及以上。
虚拟手柄:让游戏里“长”出对应型号的手柄
Sunshine 能在主机侧虚拟出 Xbox 360/One/Series、DualShock 4/DualSense、Switch Pro(Linux 与 Windows,macOS 暂不支持),游戏直接识别成对应型号,客户端什么都不用装。Windows 上依赖 ViGEmBus 或更完整的 Virtual HID Driver;Linux 走 uinput,开箱即用。
各系统都有对路的抓取方式
Windows 用 DXGI 桌面复制或 Windows.Graphics.Capture,Linux 有 KMS/DRM、X11、Wayland、XDG Portal 可选,macOS 用 ScreenCaptureKit。默认自动挑选,绝大多数桌面环境开箱不黑屏;遇到黑屏或闪烁,到 Configuration 页换抓取方式再重启服务。
🛋️ 两个真实场景
目标:手机或平板在卧室玩,不必跑回书房。做法:主机和客户端接同一个 5GHz WiFi,Moonlight 里选 1080p60,任意蓝牙手柄配对。效果:延迟在几帧量级、接近本地,20Mbps 以上的网络画面稳定不卡。
目标:把旧电脑变成专用串流主机。做法:旧 PC 装 Sunshine,用核显开 VAAPI 硬件编码,跑 1080p60 足够,设为服务开机自启。效果:主力机解放出来干活,旧电脑成了 7×24 小时的“私人游戏云”,成本比买一台新设备低得多。
🩹 Sunshine 怎么配置网络与编码参数,另答 3 个高频问题
关键设置就这 4 项:
- 码率:1080p60 给 20~30Mbps,4K60 给 50~100Mbps,别超过网络实际承受值
- 分辨率与帧率:1080p60 是安全线;4K60 建议两端 CAT5e 以上有线
- 编码器:默认硬件编码,出现色带或崩溃再切软件编码对比
- 显示同步:开 NVIDIA Fast Sync 或 AMD Enhanced Sync,各能省约一帧延迟
高频问题直接给答案:
- 客户端找不到 Sunshine 主机:查主机防火墙,确认 Web 界面的 47990 及串流端口已放行。
- 画面卡顿、丢包严重:先两端跑
iperf3测网络稳定性,或直接改有线;丢包与编码器报错可在 Web 界面 Troubleshooting 日志页逐条看。 - 忘了 Web 界面密码:停掉服务,执行
sunshine --creds newuser newpass重置。
📚 客户端生态与延伸资源
Moonlight 客户端覆盖 Windows、macOS、Linux、Android、iOS 和各类电视盒子;Web 界面的 Featured Apps 页还列了官方与社区推荐的客户端和工具。
文档看 快速上手、故障排查、配置参考。源码上,核心逻辑在src/,平台相关代码在src/platform/,NVIDIA 编码器实现在src/nvenc/;想编译或二次开发,参考构建文档。
🎬 写在最后
- 硬件编码是默认项,低延迟不用额外折腾
- 串流数据全部留在局域网,不注册账号、不经过第三方服务器
- 配置、配对、日志都在 Web 界面一个页面里完成
想试试?取回源码自己构建,或直接下载官方二进制:
git clone https://gitcode.com/GitHub_Trending/su/Sunshine下次想窝在沙发上玩游戏时,答案就在你的局域网里——打开那个 47990 页面就行。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考