企业官网建设流程全解析

Sunshine 游戏串流搭建教程：3 个阶段把 PC 画面串到电视大屏

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

游戏主机锁在书房，你却想窝在沙发上用电视打 3A 大作。Sunshine 是一个自托管游戏串流主机端，装在游戏 PC 上，负责截取画面并做硬件编码；它必须搭配 Moonlight 客户端使用，把画面、声音和手柄输入低延迟送到电视、手机或平板上。

30 秒看懂串流链路

Sunshine 相当于主机端的"发射器"：它在游戏 PC 上运行，截屏、编码、接收你回传的按键动作。Moonlight 则是"接收器"：装在电视或手机上，解码播放画面，再把你的按键送回主机。

一条数据流串起整件事：

游戏画面 → 硬件编码（NVENC / QuickSync / VAAPI）→ 网络传输 → Moonlight 解码播放

📌 你总共只需要做 4 件事：装好 Sunshine、设置 Web 控制台、添加串流目标、用 PIN 配对 Moonlight。

搭建前自检清单

⚠️ 最容易踩的坑：防火墙没放行 47989 / 47990，Moonlight 会找不到主机。macOS 首次启动要授予屏幕录制与麦克风权限，弹窗别急着跳过。

分阶段搭建 Sunshine 串流主机

阶段一：安装 Sunshine 到主机

做什么：把 Sunshine 装进游戏 PC，让它在后台常驻运行。

怎么做：按你的系统走对应路径。

Windows：MSI 安装包

• 到最新版发布页下载Sunshine-Windows-AMD64-installer.msi（ARM64 设备选对应包），双击运行向导
• 可选项只勾你真正需要的，出现防火墙弹窗时点允许

怎么确认对了：系统托盘出现 Sunshine 图标，说明后台服务已在运行。

Ubuntu / Debian：一条命令装 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 安装。

macOS：DMG 或 Homebrew

把Sunshine.app拖进"应用程序"文件夹即可；Homebrew 用户执行：

brew tap LizardByte/homebrew && brew install sunshine # 官方标注为实验性来源

怎么确认对了：菜单栏出现 Sunshine 图标，浏览器能打开 Web 页面（下一节验证）。macOS 版属于实验性支持，手柄暂不可用。

阶段二：设置 Web 控制台与串流目标

做什么：首次打开 Web 控制台，设置登录凭据，再建一个串流目标。

怎么做：

1. 浏览器访问https://localhost:47990（其他设备访问就换成主机的局域网 IP）。提示证书不受信任是自签名证书的正常表现，点"继续访问"
2. 首次访问会让你设置用户名和密码，这是进入 Web 控制台的唯一入口，记牢它
3. 进入 Applications 页点 Add New 新建条目：建一个 "Desktop" 项就是串整个桌面，填游戏可执行文件路径则只串那款游戏

怎么确认对了：到达 "Welcome to Sunshine" 页面，新条目出现在应用列表里。

阶段三：配对 Moonlight 并验证第一帧

做什么：让 Moonlight 找到主机，用 PIN 完成配对，跑通第一帧画面。

怎么做：

1. 在客户端设备打开 Moonlight（电视、手机、平板各平台都有版本），它应自动发现局域网内的 Sunshine；发现不了就在"添加主机"页手动填主机 IP
2. Moonlight 索要 PIN 时，先登录 Web 页面，在顶栏 PIN 输入框填入 PIN 并给设备起个名字——顺序不能反
3. 在 Moonlight 里选中阶段二建好的目标，开始串流

怎么确认对了：✅ 画面到达客户端、声音同步播放，两端彻底打通。

验证端到端链路并调优

先对照这份清单确认链路真的通了：

• ✅ 浏览器能打开localhost:47990并成功登录
• ✅ Moonlight 设备列表里出现你的主机
• ✅ PIN 配对后，Web 页面保存了设备名
• ✅ 开始串流后，画面与声音同时出现在客户端
• ❌ 找到主机却连不上 → 回头检查防火墙端口（见排错）

跑通只是起点，只动你所在场景对应的参数就够了：

进阶技巧：

• 有线场景：N 卡可开 Fast Sync、A 卡可开 Enhanced Sync，各省约 1 帧延迟
• 跨网络延迟天然更高，休闲游戏更合适，竞技留在局域网
• 触控操作布局在 Moonlight 端按游戏调整，主机侧不用动

排错与延伸

卡住了先打开 Web 页面的 Troubleshooting 标签，逐条看警告和错误；Linux 与 macOS 的日志目录在~/.config/sunshine/。

问：浏览器提示站点不安全，是不是出问题了？

不是。自签名证书的正常表现，点"继续访问"即可。

问：Moonlight 发现不了主机怎么办？

多半是防火墙拦了端口。放行 47989 和 47990，或给 Sunshine 加一条防火墙例外。

问：PIN 配对反复失败？

先登录 Web 页面，再回顶栏 PIN 输入框填 PIN、给设备命名。顺序不能反。

问：串流卡帧、花屏？

带宽或信号问题。降码率、降分辨率，或改走有线、换 5 GHz WiFi。

问：硬件编码器检测不到？

显卡驱动过旧。更新到最新版驱动后重启 Sunshine 即可。

延伸文档：

• 入门文档：各平台安装细节与应用列表写法
• 配置参数：每个参数的作用与默认值
• 性能调优：NVIDIA / AMD 的系统级延迟优化
• 故障排查：KMS 黑屏、手柄不响应等进阶问题

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