10 分钟搭好免费游戏串流服务器：Sunshine 完整安装与配对指南

10 分钟搭好免费游戏串流服务器：Sunshine 完整安装与配对指南

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

游戏装在书房主机上，人却躺在客厅沙发里。Sunshine 游戏串流干的就是这件事：它把装有游戏的那台电脑变成串流服务器，你在手机、平板或电视盒子上装一个开源客户端 Moonlight，就能通过局域网连回去玩。本指南面向零基础读者，从安装到首次成功串流，全程免费、不用订阅任何云服务。

先自查环境能不能上

动手前花一分钟对照这张表，四项都达标再往下走：

宿主端唯一要注册的东西，是第一次进管理页时填的本地账号，不涉及任何第三方服务。

选一条最短安装路径

三个平台的安装方式差别很大，先对比再下手：

Windows 是最常用的宿主平台，这里给详细步骤：

1. 打开 Sunshine 项目的发布页，下载最新的 Windows 安装包；
2. 双击安装包，按向导一路"下一步"；
3. 装完后程序自动启动，系统托盘里会出现常驻图标——到这一步，Windows 端就算部署完成了，无需任何手动配置。

Linux 走源码路线，克隆仓库后跑官方构建脚本，它会自动处理依赖并安装：

git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine ./scripts/linux_build.sh

脚本会顺带编译第三方依赖，首次执行耗时长一点很正常。前提是先装好git和基础编译工具链。

macOS 最简单，装好 Homebrew 之后一条命令：

brew install sunshine

编译细节和依赖清单可以查官方文档 docs/building.md。

首次登录管理页：47990 端口的三件关键设置

装完后打开浏览器访问：

http://localhost:47990

第 1 步，建账号。首次访问是欢迎页，依次填用户名、密码并确认一次，点登录即可。这组凭据是你管理串流服务器唯一入口，记牢它。

第 2 步，配外网（可选）。局域网内用默认配置就能串，想在外网玩再回来做这一步：进 "Configuration" 页，搜索框输入 "Upnp"，在 "Network" 选项卡打开 "UPnP" 开关，点底部 "Save"，路由器会自动完成端口转发。

第 3 步，登记应用。串流目标要以"应用"形式登记：点顶部 "Applications" 选项卡，左下角 "Add New"，填应用名和可执行文件完整路径，点 "Save"。页面自带 "Desktop"（桌面）和 "Steam Big Picture" 两个预设，直接能用。注意页面提示：应用列表要等客户端重启后才刷新，加完新应用记得重启一次 Moonlight 客户端。

串流画质相关的编码器、码率、帧率都在这同一个配置页调整，建议先跑通再调参，参考 docs/performance_tuning.md。

给任意设备配对开玩

客户端选哪个，看设备：Sunshine 管理页的 "Featured Apps" 页面列出了官方适配的各平台 Moonlight 客户端——桌面版（Windows/macOS/Linux）、Android 版、树莓派等嵌入式 Linux 版本，点 "Get" 就能跳转下载。

配对流程一次搞定，长期有效：

1. 确认客户端设备和宿主电脑在同一网络；
2. 打开 Moonlight，它会自动发现局域网里的 Sunshine 主机；
3. 到 Sunshine 管理页的 PIN 选项卡看 4 位配对码，在客户端输入完成配对；
4. 配对成功后客户端列出全部可串流应用，点一下开玩。

不工作时查这里

• 客户端找不到主机？确认两台设备同一局域网，防火墙放行 47990（管理页）和 47998–48000（串流数据）端口。
• 画面卡顿、模糊？先换有线，再降一档码率或分辨率，顺手关掉占带宽的程序。
• 黑屏或启动失败？查显卡驱动和编码器状态，去日志页看具体报错。
• 手柄、键鼠没反应？确认客户端识别了输入设备，再检查宿主端输入相关配置。

日志入口就在管理页里，docs/troubleshooting.md 列了更系统的排查思路，截图留证能帮你在社区里更快问出答案。

Sunshine 游戏串流排查问题时查看日志界面

接下来

到这里，从装好、配好到配对成功，你手上已经有一套完全自持、免费可用的串流链路了。编码器的底层细节、性能调优和安全加固，官方文档里都还有得挖，社区里也随时有人愿意分享经验——现在就可以打开客户端，开始第一场远程游戏 🎮

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