20 分钟免费跑通第一局：Sunshine 游戏串流服务器 + Moonlight 连接实操
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
把 Sunshine 装到家里那台跑游戏的 PC 上，配 Moonlight 客户端就能把游戏串流到电视、平板和手机上，全程免费，数据只在自己家路由器里流转，不经过任何第三方服务器。这篇文章不按安装步骤平铺，而是按目标拆：先给 20 分钟串通第一局的最短路径，再依次解锁"更稳、更快、能出门"三档体验。
🚀 20 分钟串通第一局：装好、建号、配对三连
这一节走完，电视上应该已经能看到你电脑的画面。
按系统选安装包
- Windows：装官方 MSI 安装包，一路下一步；嫌麻烦就下便携压缩包，解压直接运行。
- Linux：Debian/Ubuntu 装 .deb，Arch 用 AUR 里的 sunshine 条目，Fedora 走 copr 源，想省事直接 Flatpak。
- macOS：下 DMG 拖进应用程序，首次启动弹出辅助功能权限请求时点允许，这是它模拟键盘和手柄的前提。
装完看一眼系统托盘或状态区，有 Sunshine 图标就说明服务端活着。各平台的完整下载入口在安装指南。
在管理页建账户、加一条桌面串流
装完打开浏览器，访问：
https://localhost:47990
地址栏弹出证书警告不用管，点继续访问即可。首次进入会要求建管理员账户，用户名默认是 sunshine，密码自己定，记牢它——忘了只能在命令行重置。登录后进"应用"标签，先加一条最保险的：桌面模式，不用填任何路径，整块桌面直接串出去。
Moonlight 里输入配对码
电视、平板上装好 Moonlight，它会自动扫描局域网找到你这台主机。主机屏幕会显示一段配对码，照着输进客户端，点连接，画面就到了。
🛡️ 串流发飘、掉帧？先别动编码器，查这三处网络
卡顿九成出在链路，按这个顺序拧紧：
带宽参考值：1080p 60 帧大约吃 20~30 Mbps。带宽不够时降分辨率，别硬拉码率。
⚡ 按显卡型号对号入座，选对编码器
这节解决编码器选哪个，登录管理页在音视频设置里改：
| NVIDIA 独显 | NVENC | 最稳，H.264、H.265 都能用 |
| AMD 显卡 | AMF | 开平衡模式，画质性能折中 |
| Intel 核显 | QuickSync | 核显也能硬编，轻度 3A 够用 |
| 没有硬件编码器 | CPU 软编 | 只建议 720p 及以下 |
选完别急着满意：编码器一报错，八成是显卡驱动太旧，先把驱动更新到近期版本再重启 Sunshine。想深入看硬编实现，可以从 NVENC 源码 读起。
🌐 出门也想玩：UPnP 与多用户配置
想让串流从客厅专属变成全家、出门都能用，改这三处就行。
- 在"高级"页打开 UPnP 自动端口转发，路由器会自动放行端口，你在外网时也能回连家里这台主机。
- 给家庭成员各建一个账户，每人单独设置能看见哪些应用，谁玩什么互不干扰。
- 手机、平板串流时，在客户端里为每个应用挑一个触控布局（摇杆、十字键或方向盘），小屏设备把分辨率压到 900p 左右，帧率更稳。
Moonlight 客户端覆盖 Windows、macOS、Linux、Steam Deck、Android、iPhone/iPad，以及 Android TV、Apple TV，装好后搜到主机名即可配对，不需要额外配置。
🔧 连不上、卡顿？去日志里找答案
排障都从日志开始，位置因平台而异：
- Windows：%ProgramFiles%\\Sunshine\\config\\sunshine.log
- Linux / macOS：~/.config/sunshine/sunshine.log
- Docker 部署：看对应容器的 docker logs 输出
对照这张表先处置，再查细节：
| 47990 管理页打不开 | 防火墙拦了 HTTP | 放行 Sunshine 并开放 47990 端口 |
| 配对成功却没画面 | 串流 UDP 段没通 | 放行 47998 起的一段 UDP 端口 |
| 画面掉帧、延迟抖动 | 无线信号弱或带宽不足 | 改有线、切 5GHz、降码率 |
| 编码器启动失败 | 显卡驱动过旧 | 更新驱动后重启 Sunshine |
更细的平台级问题（Linux 沙盒权限、KMS 抓取、Mesa 硬编被禁）在故障排查手册里逐项写了。每个配置项的默认值和可选项，见配置参考。
把浏览器停在 https://localhost:47990，建好 sunshine 账户，加一条桌面模式——今晚你就能在客厅电视上直接操作自己的电脑。
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
