十分钟搭好家庭游戏串流:Sunshine 配 Moonlight 三步开玩
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款免费开源的游戏串流服务器,搭配Moonlight客户端,能把你的 PC 变成一台家庭串流中心。数据只在自家网络里流动,自托管、零订阅费,局域网延迟低到接近直连,客厅大屏随时开玩。
开工前:把三张准入清单核对一遍
| 部件 | 硬件门槛 | 看什么 |
|---|---|---|
| 主机端(跑 Sunshine) | 带硬件编码的独立显卡即可 | NVENC / QuickSync / AMF 都有支持,支持 HEVC、AV1 编码的显卡画质上限更高 |
| 客户端(跑 Moonlight) | 能流畅解码视频的设备 | 电视盒子、旧笔记本都能胜任,支持 HEVC 硬解的机型观感更好 |
| 网络 | 有线或 5GHz Wi-Fi 优先 | 稳定性比峰值带宽更关键,2.4GHz 拥挤网络容易卡 |
花 60 秒理解分工:Sunshine 负责采集 + 编码 + 传输,把游戏画面逐帧压成视频流推出去;Moonlight 负责接收 + 解码 + 回传操作,把画面显示出来、把你的按键送回去。两端就绪、连着同一张网,串流就能成立。
装得上:三个平台各走一步
| 系统 | 安装方式 | 命令 / 操作 |
|---|---|---|
| Windows | 官方 MSI 安装包 | 双击运行,按向导完成,选项按需勾选 |
| Linux | Flatpak | flatpak install flathub dev.lizardbyte.app.Sunshine |
| Linux | 发行版包 / AppImage | 装对应 deb / rpm 包,或./sunshine.AppImage --install |
| macOS | Homebrew | brew install sunshine |
| macOS | DMG 镜像 | 打开后把 Sunshine 拖进 Applications |
官方不对第三方打包版本提供支持,优先选官方渠道。装完不用碰任何配置,直接进入第一次串流。
第一次串流:登录 Web 后台,PIN 配对客户端
启动 Sunshine,浏览器访问https://localhost:47990进入 Web 管理后台,先建账号:
⚠️ 浏览器会提示"不安全":自签名证书的正常状态,点"继续访问"即可,别被吓退。
⚠️ 默认用户名是sunshine,密码首次进入时创建、且无法自助找回,务必当场记下。
然后在客户端设备安装Moonlight,与主机保持同一局域网:
- 打开 Moonlight,它会自动发现局域网里的 Sunshine;找不到就手动输入主机 IP;
- 点击主机,客户端弹出 4 位PIN 码;
- 回到 Sunshine 后台,进入顶部导航的PIN页面,输入数字并回车,配对完成;
- 在 Moonlight 里选一个应用,第一次串流开始。
桌面(Desktop)应用默认已配好。想单独串某款游戏,在Applications页添加名称和可执行文件路径即可——改完记得重启 Moonlight 客户端,列表才会刷新:
拧到位:把画质、码率和端口调舒服
Sunshine 会按你的显卡自动挑最优编码器,一般不用管。真正需要拧的是四个旋钮:
- 码率:画质与带宽的权衡点。局域网从 20 Mbps 起步往上加,出现卡顿再回退;
- 分辨率:对齐客户端屏幕与主机输出能力,1080p / 1440p / 4K 任选;
- 帧率:60 或 120 帧。120 帧要求硬件编码余量充足,先跑稳 60 再谈;
- HDR:Windows 官方支持;Linux 仍属实验性且需 KMS 捕获后端配合,建议先把 SDR 调顺。
💡 后台右上角的搜索框是找配置项的最快路径:输入UPnP,自动端口转发开关一步到位,为公网串流铺路;端口与其他服务打架时,改port = 47989这一个值,整族端口会同步平移。所有参数细节见配置说明。
救火手册:四个高频故障秒查
找不到主机现象:Moonlight 里列表空空,发现不了 Sunshine。 原因:防火墙拦了端口,或两台设备不在同一局域网。 解法:放行47989(串流)与47990(后台)两个端口,确认同网段,然后在 Moonlight 里手动添加主机 IP。
忘记后台密码现象:47990页面登不进。 原因:Web 凭据没有自助找回机制。 解法:在主机上执行重置命令——
sunshine --creds 新用户名 新密码Flatpak 安装则用flatpak run --command=sunshine dev.lizardbyte.app.Sunshine --creds 新用户名 新密码。
手柄失灵现象:串流游戏里按键无反应。 原因:主机上直连的物理手柄占了"第一手柄"的位置。 解法:Steam 设置里只保留"通用手柄"支持,断开主机的物理手柄,让 Sunshine 提供的虚拟手柄排第一;Windows 还要确认装过虚拟手柄驱动并重启过。
画面卡顿现象:画面一卡一卡、偶发冻结。 原因:串流吃的是网络稳定性(丢包、抖动),不是峰值带宽。 解法:iperf3 定位——主机iperf3 -s,客户端iperf3 -c 主机IP -t 60 -u -R -b 50M,丢包低于 5%、抖动低于 1ms 才算合格,不达标先降分辨率和码率。
仍查不出原因时,打开后台的Troubleshooting页看实时日志,错误信息写得相当直白:
更多案例收录在排障案例里。
这套方案适合想把整台 PC 的游戏库搬上电视、平板的人,也适合想搭一个零订阅费、数据不出内网的家庭串流中心。想跟进最新功能,可以克隆源码自己编译:
git clone https://gitcode.com/GitHub_Trending/su/Sunshine官方文档三个入口:快速上手带你从零起步,配置说明是每个参数的详细解释,排障案例覆盖常见故障的处理方式。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考