Sunshine 游戏串流搭建教程:5 步把 PC 画面投到电视大屏
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
游戏主机摆在书房,你却想窝在客厅沙发上用电视玩。Sunshine 是一个开源游戏串流主机端,装在 PC 上,配合 Moonlight 客户端,能把画面、声音和手柄输入低延迟送到电视、手机或平板。主机装好它,跟着本文的流程走,大屏就能直接开玩。
先用 30 秒搞懂它怎么工作
Sunshine 扮演主机端的"发射端":它跑在游戏 PC 上,负责截取屏幕画面、用显卡硬件编码,并接收客户端回传的手柄与鼠标动作。Moonlight 则是客户端的"接收端":负责把串流解码播放出来,把你的按键和触控再送回主机。
一句话数据流:
游戏画面 → 硬件编码(NVENC / QuickSync / VAAPI)→ 网络传输 → Moonlight 解码播放
所以你只需在 PC 上装 Sunshine,在电视或手机上装 Moonlight,配对成功后两端就打通了。
环境要求:一张表对完
| 项目 | 最低 | 建议 |
|---|---|---|
| 显卡 | 任意显卡(无硬件编码器时 CPU 软编码兜底,画质帧率打折) | 带 NVENC、QuickSync、VAAPI 之一的 N 卡、U 卡、A 卡 |
| 网络 | 主机与客户端同一局域网,千兆带宽 | 主机走有线,客户端连 5GHz WiFi |
| 系统 | Windows 11+、Ubuntu 22.04+、Debian 13+、macOS 14.2+、FreeBSD,内存 4GB 以上 | 各系统用较新版本 |
| 端口 | 防火墙放行串流端口 47989 | 同时放行 47990(Web 控制台)及串流端口族 |
| 客户端设备 | 任意已装 Moonlight 客户端的设备 | 电视、手机、平板、PC 均可 |
安装:三大系统的最短路径
Windows:MSI 安装包
下载什么:到最新版发布页取Sunshine-Windows-AMD64-installer.msi,ARM64 设备选对应的 ARM64 安装包。
怎么装:双击运行向导,可选项只勾你真正需要的,出现防火墙弹窗时点允许。
怎么判断装好了:系统托盘出现 Sunshine 图标,说明后台服务已在运行。
Ubuntu / Debian:一条命令装 deb
下载什么:发布页上与你系统匹配的 deb 包,例如sunshine-ubuntu-24.04-amd64.deb。
怎么装:
sudo apt install ./sunshine-ubuntu-24.04-amd64.deb # 包名换成你实际下载的文件再启用并启动用户服务:
systemctl --user --now enable app-dev.lizardbyte.app.Sunshine # 开机自启并立即启动怎么判断装好了:终端无报错,systemctl --user status查询状态显示active (running)。
⚠️ AppImage 和 Flatpak 不支持 KMS 捕获,想用 KMS 截取屏幕就优先装发行版专属的 deb/rpm 包。Arch 按官方说明添加 pacman 仓库后用 pacman 安装 sunshine,Alpine 等其他发行版可参考 入门文档 里的第三方包部分。
macOS:DMG 或 Homebrew
下载什么:对应架构的 DMG;或直接用 Homebrew 源安装。
怎么装:把Sunshine.app拖进「应用程序」文件夹即可。Homebrew 用户执行:
brew tap LizardByte/homebrew && brew install sunshine # 官方标注为实验性来源怎么判断装好了:菜单栏出现 Sunshine 图标,且浏览器能打开 Web 页面(下一步带你验证)。
⚠️ macOS 版属于实验性支持,手柄暂不可用;首次启动要授予屏幕录制与麦克风权限,别急着把它当主力串流机。
首次配对:5 步接通 Moonlight
第 1 步:打开 Web 控制台
浏览器访问https://localhost:47990,在其他设备上访问就把 localhost 换成主机的局域网 IP。提示证书不受信任是自签名证书的正常表现,直接继续访问。
预期现象:浏览器到达 "Welcome to Sunshine" 页面。
第 2 步:设置控制台凭据
首次访问会让你设置用户名和密码,这是进入 Web 控制台的唯一入口,记牢它们;忘记了可以从命令行重置。
预期现象:输入密码后能进入管理页,顶部出现 Home、PIN、Applications 等导航。
第 3 步:添加串流目标
在 Applications 页点 Add New 新建条目:建一个 "Desktop" 项就是串整个桌面,填游戏可执行文件路径则只串那款游戏。
预期现象:新条目出现在应用列表里。
第 4 步:Moonlight 发现主机并完成 PIN 配对
在客户端打开 Moonlight(电视、手机、平板各平台都有版本),它应自动发现局域网内的 Sunshine;发现不了就在"添加主机"页手动填主机 IP。Moonlight 索要 PIN 时,回到 Web 页面先登录,在顶栏 PIN 输入框填入 PIN 并给设备起个名字。
预期现象:Web 页面出现配对成功提示,Moonlight 里能看到这台设备。
Featured Apps 页收录了各平台官方 Moonlight 客户端,找不到的话可以直接去那里取。
第 5 步:验证第一帧
在 Moonlight 里选中第 3 步建好的目标,开始串流。
预期现象:✅ 画面到达客户端,声音同步播放——两端彻底打通了。
按场景挑参数
跑通只是起点,只动你所在场景对应的参数就够了:
| 场景 | 参数方向 | 调整方式 |
|---|---|---|
| 有线低延迟 | 帧率锁 60fps,码率按带宽余量上调 | Web 控制台搜索框定位参数名,逐项小步试 |
| 远程访问 | 开启 UPnP 自动端口转发 | Network 分组把upnp设为 enabled;不支持就在路由器手动转发 47989 起的端口族 |
| 移动设备 | 用画质换稳定帧率 | 5GHz WiFi 靠近路由器,分辨率与码率各降一档 |
- 有线:N 卡可开 Fast Sync、A 卡可开 Enhanced Sync,各省约一帧延迟
- 远程:跨网络延迟天然更高,休闲游戏更合适,竞技留在局域网
- 移动:触控布局在 Moonlight 端按游戏调整,主机侧不用动
全部参数说明见 配置参数。
高频问答
卡住了先打开 Web 页面的 Troubleshooting 标签逐条看警告和错误;Linux 与 macOS 的日志目录在~/.config/sunshine/。
问:浏览器提示站点不安全,是不是出问题了?
不是。自签名证书的正常表现,点"继续访问"即可。
问:Moonlight 发现不了主机怎么办?
多半是防火墙拦了端口,放行 47989 和 47990,或给 Sunshine 加一条例外。
问:PIN 配对反复失败?
先登录 Web 页面,再回顶栏 PIN 输入框填 PIN、给设备命名,顺序不能反。
问:串流卡帧、花屏?
带宽或信号问题:降码率、降分辨率,或改走有线、换 5GHz WiFi。
问:硬件编码器检测不到?
显卡驱动过旧,更新到最新版后重启 Sunshine。
问:Linux 用户服务起不来?
服务没启用,执行安装一节里的systemctl --user --now enable那条命令即可。
写在最后
整个流程一句话收束:主机装好 Sunshine、建控制台凭据、加串流目标、用 PIN 接通 Moonlight,之后都是调优。想继续深挖,看这四份文档:
- 入门文档:各平台安装细节与应用列表写法
- 配置参数:每个参数的作用与默认值
- 性能调优:NVIDIA / AMD 的系统级延迟优化
- 故障排查:KMS 黑屏、手柄不响应等进阶问题
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考