☰
Sunshine 游戏串流搭建教程:5 步把 PC 画面投到电视大屏
2026/10/2 7:55:45 网站建设 项目流程

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),仅供参考

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

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

立即咨询