Sunshine 游戏串流完整指南：把书房里的电脑变成全家共享的私人游戏主机

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

Sunshine 是一款开源免费的自托管游戏串流服务器，专门配合 Moonlight 客户端使用，能把 PC 上的游戏实时送到手机、平板、电视等任何一块屏幕。它覆盖 Windows、Linux、macOS 与 FreeBSD，并会自动调用 NVIDIA NVENC、AMD AMF、Intel QuickSync 等硬件编码能力来压低延迟。下面的攻略不绕弯子，按"装起来—连起来—调明白—踩坑自救"的节奏，带你把整套串流环境从零跑通。

它到底解决的是什么样的麻烦？

先讲个很多玩家都经历过的画面：周末想瘫在客厅沙发上打游戏，电视开着，Steam 库里那款买了许久的大作就在书房电脑里，可你就是不愿意把机箱搬来搬去，也不想在书桌前端正坐一下午。要是电视能直接"跑"书房里的游戏，该多好。

Sunshine 干的就是这件事。它让你的电脑化身一台游戏服务器：画面在主机侧编码打包，通过本地网络送到另一台设备的屏幕上，你在那边按键、挥动手柄，指令原路传回。整个过程可以想成点外卖——画面是菜品，编码器是后厨，网络是骑手，延迟高低就是外卖送到手里的等待时间。Sunshine 要做的，就是让这份"外卖"基本做到秒送。

它服务的对象是 Moonlight，一款同样开源的老牌串流客户端。两者一个管"发"，一个管"收"，加起来就是你自己的私人云游戏平台。

它和市面上的云游戏平台，本质差别在哪？

云游戏平台这几年很热闹，但对很多玩家来说总有几个迈不过去的坎。Sunshine 这套自托管方案，恰好把每个坎都绕了过去：

• 钱的问题：云游戏要订阅、要买时长，Sunshine 完全免费，项目开源，代码摆在那里随便看。
• 游戏库的问题：云端平台只给你上架的那几款游戏；自托管方案串的是你自己 Steam、Epic、Xbox 应用里已有的整个库，想玩哪款玩哪款。
• 延迟的问题：云端数据要绕一大圈公网，而 Sunshine 默认走局域网，信号在自家网络里打转，延迟自然低得多。
• 平台的问题：Sunshine 服务端支持 Windows、Linux、macOS、FreeBSD，客户端这边 Android、iOS、Windows、macOS、电视盒子都有对应版本。
• 隐私的问题：游戏画面、账号信息全程不离开你的网络，谈不上数据泄露。

一句话总结：它不替你做任何取舍，只是把你已有的设备和游戏"串"起来。

从下载到第一次成功串流，总共几步？

挑一种最顺手的安装方式

Sunshine 的安装路径相当多，选适合自己系统的就好：

# 想从源码编译，先克隆仓库 git clone https://gitcode.com/GitHub_Trending/su/Sunshine # Windows 用户（推荐，一条命令搞定） winget install LizardByte.Sunshine # Linux 桌面用户（Flatpak 沙盒安装，升级省心） flatpak install flathub dev.lizardbyte.app.Sunshine # macOS 用户（Homebrew） brew install sunshine # 玩 Docker 的朋友（省去依赖折腾） docker pull lizardbyte/sunshine

装完别急着关终端，先确认一下安装是否成功，再继续下一步。

打开网页后台，先给自己建个账号

安装完成后，在浏览器里输入http://localhost:47990，会看到一个欢迎页面。第一次进来，页面会引导你创建管理账号——很多人图省事直接沿用默认用户名sunshine，这没问题，但强烈建议把密码设成一个足够强的、你记得住的组合，因为它今后就是你这套串流系统的"大门钥匙"。

这个后台界面值得多看两眼：以后添加游戏、调参数、看日志，全在这里完成。

让 Moonlight 和 Sunshine 互相认识

接下来在手机、平板或另一台电脑上装 Moonlight 客户端，只要保证它和 Sunshine 主机在同一个局域网内，客户端通常会自动发现服务器。如果没自动发现，也可以手动输入主机的 IP 地址。

发现服务器后，客户端会弹出一个四位数的配对码（PIN），回到 Sunshine 的网页后台，把 PIN 填进去确认，两边就算"握手成功"了。之后每次连接，只需在客户端里点一下服务器、选个应用就能开玩。

第一次串流成功后，先熟悉这几个面板

应用管理：把游戏摆上你的"串流菜单"

Sunshine 默认给你准备好了两个应用：Desktop（整个桌面）和Steam。前者适合先串流桌面看看效果，后者会直接拉起 Steam 的大屏模式，手柄友好。

在这个页面里，你可以随意增删应用。给你几个常用的配置思路：

• 只想快速进游戏的：把游戏主程序的 exe 路径直接填进去，一个游戏一个入口；
• 习惯用平台启动的：Steam 填steam://open/bigpicture，Epic 填对应的启动链接；
• 折腾模拟器的：把 RetroArch 之类的模拟器加进来，电视上玩老游戏也别有一番味道。

每个应用都能单独设置启动参数、工作目录，还有"预启动命令"这种进阶玩法，等上手了再慢慢研究。

精选应用：省去自己找客户端的功夫

后台里有一页"精选应用"，官方替你把常用客户端都筛好了：Windows 上功能最全的 Moonlight PC、移动端体验极佳的 Moonlight Android、给树莓派等嵌入式设备用的 Moonlight Embedded，点进去就有下载入口。

对刚入门的人来说，这一页最大的价值是"官方认证过的选择"，不用自己在网上到处找，避免下到来路不明的版本。

顺手一提：管理界面还能换主题

后台界面自带深色、浅色两套主题，还能跟随系统自动切换，夜里调设置不至于被白底晃眼睛。这种细节虽然不影响串流本身，但用起来确实舒服不少。

画面卡、延迟高，该先动哪个旋钮？

第一次串流顺利跑起来之后，接下来的课题通常是"怎么让它更流畅、更清晰"。别急着一股脑拉高所有画质，按下面的顺序来。

谁在负责把画面打包？编码器

Sunshine 会根据你的显卡自动选编码器，一般不用手动干预：NVIDIA 显卡走 NVENC，AMD 显卡走 AMF，Intel 核显或独显走 QuickSync，实在不行还有 CPU 软件编码兜底。编码器选对，延迟和画质就有了基本盘。

如果你之后把 Sunshine 换到另一台电脑上跑，记得检查显卡驱动是不是最新——驱动版本太老，常常是编码器"罢工"的头号原因。

码率给多少才合适？

码率可以理解成"每秒钟给画面分配多少传输额度"，给少了画面糊、有马赛克，给多了会挤压网络。参考这几个常见组合，先照着试再微调：

• 720p/60 帧：5–10 Mbps，适合手机流量或信号一般的场合；
• 1080p/60 帧：15–25 Mbps，多数家庭网络都能轻松扛住，也是折中体验最好的档位；
• 1440p/高刷新率：25–50 Mbps，配 144Hz 显示器或高分屏用；
• 4K/60 帧：50–100 Mbps，客厅大电视的归宿，前提是你网线够粗、WiFi 够好。

记不住设置项在哪？用搜索

Sunshine 后台的设置项不少，新手容易翻花眼。好在页面顶部有搜索框，输入关键词就能直达对应选项，比如想开 UPnP、调网络相关参数，搜一下就有。

网络端还能做的几件小事

画质调好了，网络也得跟得上：

• 能插网线就插网线，有线永远比无线稳；
• 用 WiFi 的话优先 5GHz 频段，避开 2.4GHz 的拥挤和干扰；
• 路由器开启 QoS，把游戏流量优先级提上去；
• 信号不好时，离路由器近一点，隔墙两堵以上基本就该考虑改方案了。

想让体验更进一步？试试这几个进阶玩法

基础串流跑顺之后，下面这些玩法能明显提升幸福感：

• 多显示器：Sunshine 可以指定串流哪块屏幕，也能设置成"连接时自动切换"，客厅电视和书房显示器各司其职；
• 手柄：Xbox、PlayStation 手柄都支持得很好，虚拟手柄驱动装好后，WiFi 延迟的手感也基本可用；
• HDR：两端都开启 HDR 后，暗部细节和色彩明显不一样，喜欢看画面的玩家值得一试；
• 外网串流：出门在外想连家里的电脑，需要做端口转发（47989–47990 的 TCP/UDP），或者干脆用 ZeroTier 这类组网工具，比手动折腾端口更省心；
• 换皮肤：前面提到的深色/浅色主题之外，页面里还能调整字体、排版密度，把后台调成自己顺眼的样子。

万一翻车了，按这张清单逐项排查

串流这东西，环境一复杂就容易出幺蛾子。别慌，多数问题就出在那么几个地方。

客户端就是找不到服务器

先确认手机/平板和主机在同一个局域网；再看主机防火墙有没有放行 47990 端口；最后把 Sunshine 服务和路由器都重启一遍。这三步做完，绝大多数"找不到"的问题都能解决。

画面一顿一顿、糊成一团

先降码率或分辨率试试，往往立竿见影；再关掉后台那些占带宽的下载任务、视频播放；最后检查主机 CPU 和 GPU 占用，如果已经满载，说明硬件到瓶颈了，该考虑换更省资源的编码预设。

自己看不明白？让日志说话

如果前面都试了还不行，Sunshine 的日志会告诉你真正的原因。日志页面就在网页后台里，打开就能看到每一条报错。

不同系统的日志位置也给你整理好了：

Windows : %ProgramFiles%\Sunshine\config\sunshine.log Linux/macOS : ~/.config/sunshine/sunshine.log Docker : docker logs sunshine

错误码速查

• 30 号错误：编码器没找到，八成是显卡驱动的问题，更新驱动后再试；
• 100 号错误：网络连不通，回头检查防火墙和端口；
• 200 号错误：权限不足，Windows 上试试以管理员身份运行。

几个大家常问的问题

Sunshine 支持哪些系统？服务端支持 Windows 10/11、主流 Linux 发行版、macOS 10.15 以上和 FreeBSD 13.0 以上，覆盖面相当广。

对硬件有要求吗？日常使用推荐至少 4 核 CPU、8GB 内存，以及一块带硬件编码能力的显卡——NVIDIA GTX 1050 以上、AMD RX 550 以上、Intel HD 600 以上都行。没有独显也能跑，只是画质和延迟会打折扣。

支持几个人同时连？理论上可以多客户端同时连接，但画面编码很吃性能，实际体验一般建议一到两个客户端同时在线。

能不能串 HDR 游戏？可以，Sunshine 原生支持 HDR 串流，前提是主机端和客户端都要把 HDR 打开。

出门在外怎么连家里的电脑？两种主流方案：一是做端口转发（47989–47990 的 TCP/UDP），二是用 ZeroTier、Tailscale 这类虚拟组网工具，后者对新手更友好。

写在最后：一条从零开始的落地路线

回头看，整条路其实很清晰：装好 Sunshine → 在网页后台建账号 → 用 Moonlight 配对 → 加几个游戏应用 → 按自家网络调一调码率 → 遇到问题查日志。全程不需要懂编码原理，也不需要改任何一行代码。

想深入研究的话，项目文档写得很全：配置项逐一解释见 docs/configuration.md，遇到问题先翻 docs/troubleshooting.md，想榨干硬件性能就看 docs/performance_tuning.md。

把游戏串流这件事做好，Sunshine 算是开源世界里最省心的一条路：免费、开放、跨平台，装好即用。现在就去把书房那台电脑变成全家共享的游戏主机吧——客厅的沙发，已经等你好久了。

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