Sunshine游戏串流从零搭建教程：一个晚上，我把书房里的PC搬进了客厅-平芜编程栈

Sunshine游戏串流从零搭建教程：一个晚上，我把书房里的PC搬进了客厅

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

那个周五晚上，我蹲在书房里刚把游戏存档加载完，客厅就传来一声："你那台电视快一年没开机了。"我盯着屏幕愣了三秒——Steam 里躺着两百多个游戏，可它们永远只能跟着书房这台电脑走。也就是那个晚上，我遇见了 Sunshine，一款自托管游戏串流服务器，也第一次动了"把 PC 游戏搬到客厅电视上玩"的念头。如果你也有台吃灰的电视、一台性能不错的电脑，那么这篇 Sunshine游戏串流从零搭建教程，大概就是为你准备的。

🏠 先别急着下载：Sunshine 到底是什么？我用两个比喻讲明白

Sunshine 干的事，可以理解成给电脑装了一个"信号中继器"：它在你的电脑上采集画面、压缩成视频流，通过网络发出去；而 Moonlight 客户端（手机、平板、电视上那个 App）负责接收、解码，同时把你的按键操作传回去。一来一回，你就实现了"隔空打游戏"。

更接地气的说法是：Sunshine 是"电脑画面的外卖店"。它把画面做成一盒盒"压缩视频"，Moonlight 是骑手加食客，负责送达和享用。中间这份"餐"由显卡里的专用模块来打包——这叫硬件编码，所以电脑 CPU 几乎不用加班，帧数损失极小。

为什么我不选现成的云游戏平台？云游戏服务的免费档我试过，排队、限时长、游戏库要听它的安排，数据还都存在别人服务器上。而 Sunshine 免费开源，串流的是我自己电脑里的游戏，画质多高、玩多久、隐私在不在自己手里，全由我说了算。就冲这三点——免费、自托管、硬件加速——我决定折腾到底。

🚀 从下载到第一次串流成功：我的 30 分钟操作记录

接下来是我当时一步步的真实操作记录。你照着走，大概率半小时内也能跑通。

第 1 步：装 Sunshine，比装个播放器还省事

我的电脑是 Windows，直接去项目 Release 页面下载安装包，一路"下一步"就装完了。装好后它默默在后台运行，桌面上几乎看不出痕迹。

如果你用的是 Linux 或者喜欢自己编译，也可以从源码构建，这部分我放到后面的进阶玩法里细说，先把最顺的路走通。

第 2 步：打开网页，先给服务器设个"门锁"

装好后，浏览器访问http://localhost:47990，会看到一个设置用户名和密码的页面——这就是 Sunshine 的 Web 管理界面，之后所有配置都在这里完成。第一次看到这个页面时我还有点意外：一个游戏工具，管理后台居然做得这么清爽。

首次打开管理界面会让你创建管理员账号，这个密码请务必记牢

设好账号密码后，管理界面就算"上了锁"，只有知道密码的人能进来改设置。这一步完成，服务器端的大门就守住了。

第 3 步：添加应用，把游戏"放进"串流列表

登录后进入"应用"页面，里面默认躺着两个条目：Desktop（桌面）和 Steam。意思是：你可以串流整个桌面，也可以直接串流 Steam 大屏幕模式。我把 Steam 加进列表后，又试着添加了一个自定义应用——任意可执行程序都能变成"一键串流"的入口。

应用以卡片形式展示，点一下就能编辑或删除，也可以自己添加任意程序

到这里，服务器端就全部准备好了。接下来轮到客户端登场。

第 4 步：装 Moonlight 客户端，输一串 PIN 完成配对

Moonlight 是接收端，手机、平板、电视、电脑都有对应版本。我客厅那台安卓电视上装了 Moonlight，打开后它自动发现了局域网里的 Sunshine——如果你没被自动发现，手动输入电脑的局域网 IP 也可以。

点进服务器后，屏幕上会弹出一个 4 位 PIN 码。这时回到 Sunshine 的 Web 界面，点导航栏里的"PIN"，输入这串数字，再给这台设备起个名字，回车——配对完成。整个过程不到一分钟，比我想象中"高大上"的握手流程朴素得多。

Sunshine 官方页面会列出各平台可用的 Moonlight 客户端，按需下载即可

第一次按下"开始串流"的那个瞬间

我在电视上点了"Desktop"，屏幕黑了一秒左右，然后——书房那台电脑的桌面，就那样出现在客厅的电视上。我甚至没忍住当场开了个游戏跑了两步，画面顺滑得不像"远程"。那一刻我承认，我被这个免费开源的小工具圈粉了。

🕹️ 如果你还想再进一步：3 个真正用得上的玩法

基础串流已经跑通，接下来这些属于"锦上添花"，按需取用，不用全做。

玩法一：把画质调到"又清晰又流畅"

默认设置其实已经不错，但想榨出更好的效果，去"配置"页面调整几个参数就行。Sunshine 的配置项不少，好在支持搜索——输入关键词就能快速定位，比如"encoder"（编码器）、"bitrate"（码率）。

在配置页直接搜索关键词，几秒就能定位到想改的选项

不同显卡有对应的硬件编码器，选对了能省下大量 CPU 占用：

你的显卡	Windows 上推荐选	Linux 上推荐选
NVIDIA	NVENC	NVENC
AMD	AMF	VAAPI
Intel	QuickSync	VAAPI

分辨率、帧率、码率是个"画质三角"：网络好就往上调，卡顿就往下调。我自己的经验值是 1080p、60fps、20Mbps，在千兆局域网里游刃有余。

玩法二：出门在外也能连回家里那台电脑

局域网串流只是入门，真正"自由"的是外网串流：人不在家，也能打开家里那台电脑继续玩。前提是在路由器上给 Sunshine 做端口转发（默认是 47984–47990 这一组端口），再开启 TLS 加密，免得密码在公网上"裸奔"。如果家里路由器支持 UPnP，Sunshine 还能自动帮你开端口，省去手动配置的麻烦。

玩法三：用一台旧电脑当串流主机（Linux / Docker）

如果你想用一台闲置的 Linux 机器当串流主机，从源码编译也很直接：

git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine mkdir build && cd build cmake .. make -j$(nproc) sudo make install

嫌麻烦也可以用现成的 Docker 镜像，一条命令拉起容器，把配置目录挂载出来就能用，很适合"一台机器专门负责串流"的玩法。

🕳️ 新手最容易踩的 5 个坑，我替你踩完了

以下是新手期我最常被绊倒的地方，每条都配了正确的做法：

连不上服务器，客户端一直提示超时——八成是防火墙没放行。正确做法：把 47984–47990 这组端口加入防火墙白名单再重试。
串流成功了，手柄却没反应——Windows 上需要先装 ViGEmBus 虚拟手柄驱动，装好它，手柄输入才能被"转发"给远端电脑。正确做法：装好驱动后重启 Sunshine。
画面一顿一顿，像在看幻灯片——先别怪网络，看看是不是还开着 4K 高码率在跑 Wi-Fi。正确做法：优先用有线连接，或者把分辨率降到 1080p、码率调到 20Mbps 左右。
一进游戏就黑屏或花屏——多半是 HDR 或刷新率不匹配。正确做法：先在客户端关掉 HDR 试一次，再排查显示输出设置。
哪里出问题全靠猜——Sunshine 自带日志页面，报错原因写得很直白。正确做法：出问题时先去日志页看一眼，把关键词复制出来搜索，比瞎调参数高效得多。

日志页会把错误原因写得很直白，遇到问题先来这里看一眼