企业官网建设流程全解析

Sunshine 游戏串流主机 6 步上手指南：从安装到 Moonlight 串出画面

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

Sunshine 是一个自托管的游戏串流主机：装上它，家用 PC 就能把画面和声音实时传给 Moonlight 客户端，在电视、平板或手机上玩电脑里的游戏。数据只在你自己的局域网里走，不经过第三方服务器，也没有订阅费。下面按你实际会遇到的顺序讲：先装好，再串出第一帧画面，最后处理卡顿和连不上。

📋 装 Sunshine 前要先确认哪三件事？

花两分钟查清硬件、系统、网络，能省掉后面大半返工。

• 显卡：优先选带硬件编码器的——NVIDIA 对应 NVENC，AMD 对应 AMF，Intel 核显对应 QuickSync。编码器（把屏幕压缩成视频流的部件）走硬件时延迟低、CPU 占用小；没有硬编也能用 CPU 软编码，但建议把分辨率压到 720p 左右。
• 系统：Windows、主流 Linux 发行版、macOS 都支持。装之前把显卡驱动更新到较新版本，多数编码器怪问题出在旧驱动上。
• 网络：主机和接收设备在同一局域网。主机建议千兆有线，接收端走无线就确认连的是 5GHz 频段。

📦 三个平台各自下哪个安装包？

每个平台走一条最短路径即可，装完在托盘或系统里看到 Sunshine 图标就是跑起来了。

具体包名、下载入口和卸载命令都在 安装指南里，Linux 各发行版（Debian/Ubuntu、Arch、Fedora、Alpine）分节列了命令。

🌐 装完第一步：打开哪个页面、账号怎么建？

浏览器访问本地管理入口：

https://localhost:47990

浏览器弹"不安全网站"的自签名证书警告属正常现象，直接继续访问。首次进入要创建用户名和密码——官方文档专门提醒：这一步建完务必记牢，因为忘记后只能用命令行重置。下面是首次启动后的欢迎页，配置、主题、添加应用都从这里出发：

万一密码丢了，在主机终端执行一条命令即可重置（把尖括号换成你的新值）：

sunshine --creds <新用户名> <新密码>

🎮 第一个应用怎么加，客户端怎么配对？

进入"应用"标签页，加一个串流项。最省事的是内置的Desktop（桌面）应用：它不启动任何程序，直接串出整个桌面，适合先跑通全流程。进阶是添加自定义程序：填可执行文件路径、启动参数、工作目录，再配图标和显示名称。下面的应用管理页就是添加串流游戏的入口：

主机端就绪后，在电视、平板或手机上打开 Moonlight 客户端。它会自动扫描局域网里的 Sunshine，弹出配对请求时：

1. 回到 Web 管理页，点顶部导航栏的PIN；
2. 输入显示的配对码，给设备起个名字，确认；
3. 回到 Moonlight 选一个应用，点连接。

桌面、Steam Deck、Android、iOS、Android TV 等各平台客户端的下载入口，管理页的Featured Apps标签里都列好了，不用自己找：

一个实用组合：PC 留在书房跑游戏，客厅电视当接收端，局域网里手柄延迟基本无感。

⚙️ 编码器怎么选最稳？

编码器决定画质和延迟的上限，Web 配置页只会在当前平台支持时才显示对应选项。按显卡对号入座：

不知道找哪个选项？配置页顶部有搜索框，直接输 "encoder" 定位：

📶 怎么让画面不卡？

网络侧做三件事：主机端千兆有线，接收端尽量有线、无线固定 5GHz；带宽不够时降分辨率优先于降码率；1080p 60 帧在 20~30 Mbps 带宽下通常流畅，具体随你的链路调整。

拿不准就先测。官方推荐用 iperf3 压测主机到接收端这条链路：主机执行iperf3 -s，接收端执行iperf3 -c <主机IP> -t 60 -u -R -b 50M，看输出里的丢包与抖动——目标是丢包低于 5%、抖动低于 1ms，这两项不达标，调编码器没用。

🔍 连不上或画面卡，先查哪里？

先看日志，路径如下：

Web 页的Troubleshooting标签把日志里的警告和错误做成可逐条展开的列表，对着提示找线索最快：

再按现象对处置：

两个顺手的快捷键，都和 Moonlight 一致：Ctrl+Alt+Shift+F1/F12切换串流用的显示器，Ctrl+Alt+Shift+N隐藏或显示鼠标光标。另外在高级设置里开启UPnP后，路由器会自动放行串流端口，外出经公网回连家里就通了。

📚 调成自己的样子，再去哪深入？

Web 页支持深色 / 浅色 / 跟随系统三种主题，夜间串流切深色更护眼，右上角下拉框一键切换：

继续深入按这份相对路径索引翻：

• docs/getting_started.md：各平台安装、首次配置、快捷键与 HDR 说明
• docs/configuration.md：每个配置项的默认值、取值范围和示例
• docs/troubleshooting.md：Linux 沙盒权限、KMS 抓取、Mesa 硬编被禁用等平台级问题
• src/nvenc/：NVENC 硬件编码实现源码，想读硬编逻辑从这里开始

现在就打开浏览器访问https://localhost:47990，把 Desktop 应用串给手边的 Moonlight 客户端——第一帧画面出来，这台串流主机就算真正跑通了。

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