十分钟搭好家庭游戏串流:Sunshine 配 Moonlight 三步开玩
2026/9/1 9:19:37 网站建设 项目流程

十分钟搭好家庭游戏串流: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 安装包双击运行,按向导完成,选项按需勾选
LinuxFlatpakflatpak install flathub dev.lizardbyte.app.Sunshine
Linux发行版包 / AppImage装对应 deb / rpm 包,或./sunshine.AppImage --install
macOSHomebrewbrew install sunshine
macOSDMG 镜像打开后把 Sunshine 拖进 Applications

官方不对第三方打包版本提供支持,优先选官方渠道。装完不用碰任何配置,直接进入第一次串流。

第一次串流:登录 Web 后台,PIN 配对客户端

启动 Sunshine,浏览器访问https://localhost:47990进入 Web 管理后台,先建账号:

⚠️ 浏览器会提示"不安全":自签名证书的正常状态,点"继续访问"即可,别被吓退。

⚠️ 默认用户名是sunshine,密码首次进入时创建、且无法自助找回,务必当场记下。

然后在客户端设备安装Moonlight,与主机保持同一局域网:

  1. 打开 Moonlight,它会自动发现局域网里的 Sunshine;找不到就手动输入主机 IP;
  2. 点击主机,客户端弹出 4 位PIN 码
  3. 回到 Sunshine 后台,进入顶部导航的PIN页面,输入数字并回车,配对完成;
  4. 在 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询