Sunshine游戏串流快速上手指南：免费开源自托管，从安装到调优一次跑通

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

出差在外的深夜，你想连回家里那台 PC 玩刚买的 3A 大作，打开商业云游戏平台却发现游戏不在库里，想玩的要加钱，画质还得看网络脸色。Sunshine 就是解决这个问题的答案——它是一款免费开源的自托管游戏串流服务器，把家里电脑变成你的私人云游戏主机，让手机、平板、电视在任何角落都能直接玩到 PC 上的游戏，画面采集、编码、传输全部发生在你自己的设备之间。

三分钟想清楚：它是什么、适合谁、强在哪

动手安装之前，先弄清三件事，免得白折腾。

一句话定位：Sunshine 是 Moonlight 的开源服务端。Moonlight 负责"接收和显示"，Sunshine 负责"采集画面、编码、推流"，两者配对，就是一套完整的串流链路。

它最适合这三种人

• 手上有手机、平板、笔记本、电视盒子多台设备，想共享一台主机算力的玩家
• 不想按月为云游戏平台付费，也不愿意把游戏库交给第三方的用户
• 家里主机配置不错，只差"出门也能玩"这最后一环的人

与商业云游戏的六项核心差别

三句点睛：

1. 它不是"又一个云游戏平台"，而是把"云"搬回你自己家里。
2. 它不做游戏分发，只专注一件事：把画面高效送到你手上。
3. 它的核心价值不是功能多，而是"可控"——编码器、码率、端口全部透明。

10分钟跑通首次串流：从装到玩的最短路径

完整流程只有四步，每一步 2-3 分钟，做完就能进游戏。

第一步：拿到源码（可选）

想从源码构建或参与二次开发的用户，先克隆仓库：

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

对大多数玩家来说，直接进入第二步用官方安装包更省时间。

第二步：按系统选安装方式

第三步：首次登录并设置密码

装好后打开浏览器，访问http://localhost:47990，看到的就是欢迎页面：

默认用户名为sunshine，首次登录会强制你设置一个自己的密码。这一步务必做完并妥善保存——它是你 Web 管理界面的唯一钥匙。

第四步：添加第一个应用，用 Moonlight 连上

在 Web 界面的 Applications 页点击 "Add New"，选现成模板（桌面或 Steam 大屏模式），填上名称和启动路径，保存即可：

然后在手机或另一台电脑装好 Moonlight 客户端，让它自动发现 Sunshine 主机，输入 PIN 码完成配对，第一个应用就能点开了。

三个关键设置，让体验从将就变讲究

跑通只是及格线。下面三个设置，直接决定你后续是"流畅到无感"还是"卡到劝退"。

1. 网络：有线这样配最稳

串流质量的天花板是网络，不是显卡。

• 主机与路由器之间优先千兆有线（超五类网线起步）
• 无线场景选 5GHz 频段，客户端与路由器距离尽量控制在 8-10 米内
• 路由器支持 QoS 时，把游戏串流流量优先级调高，别让下载任务挤占带宽

在 Configuration 页打开 UPnP 自动端口转发，可以为远程串流场景省去手动配端口的麻烦：

2. 编码器：自动识别，但要记住兜底方案

Sunshine 会根据显卡自动挑选编码器：NVIDIA 走 NVENC、AMD 走 AMF、Intel 走 QuickSync，三者都是硬件编码，延迟和画质兼顾。

新手只需记住一件事：如果某类显卡驱动异常导致编码失败，可在 Audio/Video 配置里切到软件编码兜底，保存后重启串流即生效。

3. 客户端：不同设备选不同入口

• Windows / macOS / Linux 桌面：Moonlight 官方客户端
• 手机和平板：Moonlight 移动版，触控布局可自定义
• 电视盒子、树莓派等嵌入式设备：Moonlight Embedded

客户端直接决定操作手感，值得花十分钟把按键映射和触控布局调到顺手。

五个高频问题排查清单：卡在哪、怎么解

Q1：客户端搜不到 Sunshine 服务器？

三步排查：确认两台设备在同一局域网 → 检查系统防火墙是否放行 47990 端口 → 重启 Sunshine 服务再试。绝大多数情况是防火墙拦截，不是软件故障。

Q2：画面频繁卡顿或掉帧？

先降一档分辨率或码率试串，排除带宽瓶颈；再确认游戏没有吃满 CPU 和 GPU；最后更新显卡驱动——编码器对驱动版本相当敏感。

Q3：手柄连上却没反应？

手柄要连接在客户端设备上，而不是主机上。先在 Moonlight 里测试手柄输入，确认能识别后再调整按键映射和布局。

Q4：出门在外怎么串流？

局域网外串流需要打通网络：最省心的是用 ZeroTier 或 Tailscale 这类虚拟组网工具，把设备和主机放进同一个虚拟局域网；也可以用路由器端口转发把串流端口映射出去，并配合强密码保护。

Q5：报错信息看不懂怎么办？

Web 界面的 Logs 页会实时滚动输出日志，包含编码器初始化、连接握手等关键信息：

把错误关键字（比如编码器名称）复制到官方文档里搜索，通常几分钟就能定位原因。

动手清单：接下来五件事直接照做

文章到此为止，剩下的交给行动：

1. 装——按你的系统选好安装方式，完成首次登录和密码设置
2. 连——在常用设备装好 Moonlight，完成 PIN 配对
3. 试——先串流桌面或 Steam 大屏模式，确认画面、声音、手柄都正常
4. 调——按上文网络与编码建议做一轮优化，验证延迟变化
5. 查——把官方文档加入收藏，遇到问题先查配置说明再动手改

项目源码与安装包都在仓库里：git clone https://gitcode.com/GitHub_Trending/su/Sunshine。想逐项吃透参数，看 docs/configuration.md 和 docs/performance_tuning.md；想了解串流与编码的实现细节，可以翻 src/ 与 src/nvenc/ 源码。

今晚就先把家里那台电脑点亮，让游戏在你去到的每一个地方，都等你回来。

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