十分钟跑通第一条本地游戏串流：Sunshine 自托管服务器免费完整教程

十分钟跑通第一条本地游戏串流：Sunshine 自托管服务器免费完整教程

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

卧室的床上想接着打昨天停在研究的主机游戏，可游戏库全在那台不挪窝的电脑上——搬机器太累，云游戏月租又肉疼。Sunshine 就是为这种场景生的：一个开源免费的自托管游戏串流服务器，装在你的主机上，手机、平板、另一台电脑经 Moonlight 客户端连过来，画面走的是自己的局域网，没有订阅、没有流量费。按本文做完，你会拿到一台随时待命的串流主机：开机就能把整个桌面或指定游戏投到手里任何一块屏幕上。

它适合谁

• 🎮把家用主机变串流中心：PC 常年开机放在角落，全家设备连它玩同一套游戏库
• 🏠跨设备接力：白天在书房电脑上打，晚上下班后手机、平板接着玩，进度不中断
• 🛠️给旧设备续命：性能一般的笔记本、平板，借主机的显卡算力跑 3A 大作

以上全场景零费用：Sunshine 客户端服务端都开源免费，Moonlight 客户端同样免费，唯一成本是你自己的局域网。

准备工作：安装清单与系统命令

动手前核对三样东西：

• 一台装游戏的主机（Windows / Linux / macOS 均可），Sunshine 服务端装在这台机器上
• 一台串流终端（手机、平板或第二台电脑），装 Moonlight 客户端
• 两台设备在同一个局域网里，能互相访问即可

⚠️ 主机装好 Sunshine 后建议重启一次：Windows 端的虚拟输入驱动需要重启才彻底生效，省得后面输入不响应再排查。

按你的系统选一条路：

• Windows：从项目最新 Release 里下载官方 MSI 安装包，双击后注意逐项勾选选项，不要无脑点到底——安装日志在%%TEMP%/Sunshine/logs/install/，装出问题先看它
• Linux / macOS：敲下面的命令即可，Linux 走 Flatpak，macOS 走 Homebrew（macOS 上游戏手柄暂不支持，属实验性支持）

# Linux（Flatpak） flatpak install flathub dev.lizardbyte.app.Sunshine # macOS（Homebrew，需先 tap 官方仓库） brew tap LizardByte/homebrew && brew install sunshine

💡 Linux 各发行版其实都有官方打包的 deb / rpm / AppImage，优先选与你发行版匹配的包，详见 docs/getting_started.md 的 Install 章节，比 Flatpak 权限更全。

最小跑通路径：四步拿到第一条串流

1. 打开 Web 管理后台，设好账号。浏览器访问https://localhost:47990（自签名证书，浏览器警告忽略即可），首次进入会让你设置用户名和密码。成功标志：登录成功，能进入配置页。⚠️ 这组凭据忘了就只能命令行重置，当场存好。

2. 在 Moonlight 客户端里找到主机。装好 Moonlight 打开它，同一局域网内会自动发现Sunshine 服务器。成功标志：主机以卡片形式出现在客户端列表里，点开即弹出 PIN 码配对请求。

3. 在 Web 后台的 PIN 页面输入配对码。把 Moonlight 请求的码填进 PIN 输入框，回车并给设备起个名字。成功标志：页面弹出 Success，客户端完成配对，主机显示在线。

4. 挑一个应用开始串流。进入 Applications 页面，Desktop（桌面）默认就在列表里，直接点它；或点 Add New，填上游戏名、可执行文件路径和启动参数。成功标志：画面在客户端上出现，键鼠手柄都能操作——第一条串流通了。

从"能用"到"好用"：编码器与网络怎么调

串流体验的一半在编码，Sunshine 会按你的显卡自动选硬件编码器，几乎不用手动干预，对照表帮你确认它选对了没有：

硬件编码不占 CPU、延迟低，是体验流畅的根基。另一半在网络：用iperf3从主机往客户端测 UDP，目标是丢包低于 5%、抖动低于 2ms。不达标时先动哪个参数？先降分辨率，再降码率——这两项在 Applications 或配置的编码选项里改，比换路由器见效快。

真卡住了别瞎猜，打开后台的Troubleshooting页面，每条 warning / error 都写得直白，顺着提示走基本能定位问题：

别错过的进阶功能

• 🔍配置搜索一键定位——设置项多到迷路时，在配置页顶部搜索框敲bitrate、UPnP等关键词，目标配置直接高亮，不用翻菜单。入口：Web 后台 Settings 页搜索栏。
• 🔑PIN 码异地配对——Web 后台不限本机访问，出差在外用手机浏览器打开主机 47990 端口，照样能给家里新设备发放配对授权。入口：导航栏 PIN 页。
• 🔧端口族整体偏移——默认端口被占用时，只需把配置里的port = 47989改成别的值，整套相关端口会同步偏移，一处改动解决全家冲突。入口：配置页 port 项，详见 docs/configuration.md。

想动手研究的，把源码拉下来翻一遍，架构比想象中清晰：

git clone https://gitcode.com/GitHub_Trending/su/Sunshine

官方文档都在仓库的docs/里：docs/getting_started.md 带你起步，docs/configuration.md 逐项讲解每个参数的含义，docs/troubleshooting.md 专门排障。现在就打开那台主机，装好它，让今晚第一局游戏从你手里的屏幕上开始。

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