把「好电脑锁在书房」变成「沙发也能玩 4K 串流」：Sunshine 自托管游戏串流上手指南

把「好电脑锁在书房」变成「沙发也能玩 4K 串流」：Sunshine 自托管游戏串流上手指南

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

晚上十点，你窝在客厅沙发上想继续打没通关的那局游戏，可那台顶着 RTX 4080 的主机还亮在书房里。搬过去太折腾，再买一台更不现实。这时候你缺的不是新硬件，是一套免费的 Sunshine 游戏串流方案：让书房那台机器替你跑游戏，客厅的平板只负责显示。

Sunshine 用一句话说清楚

Sunshine 是一个自托管游戏串流服务端（self-hosted game stream host），说白了就是游戏跑在你的高性能电脑上，画面和声音被实时编码、走网络推到手机、平板、电视等任何屏幕上。它免费、开源、无广告，Windows、Linux、macOS、FreeBSD 全平台，Intel / AMD / NVIDIA 三家显卡的硬件编码基本全覆盖。

分工很明确：Sunshine 管"发送"，装在高性能主机上；配套的Moonlight 客户端管"接收"，装在你手边那块屏幕上。两个配合，就是一套完全归你自己的云游戏方案——不按月付费、不锁功能。

一句话记忆点：Sunshine 是发送端，Moonlight 是接收端，一次串流 = 两端完成握手。

🎮 快速跑通：从装好到第一次成功

目标很单纯：让画面出现在第二块屏幕上。熟手 10 分钟能跑通，新手摸一摸也别超过半小时。

1. 在高性能电脑上装 Sunshine。Windows 去发行版页下载安装包双击；Linux 用.deb/ COPR / AppImage；macOS 一句brew install sunshine。进程在后台跑起来，就算成功。
2. 打开网页管理后台。浏览器访问https://localhost:47990，首次进入让你设置管理员账号和密码。页面能打开、账号建好，就算成功。
3. 装 Moonlight 客户端。手机、平板、电视的应用商店搜 Moonlight 即可，装好能列出设备就算成功。
4. 配对连接。Moonlight 会扫描局域网里的 Sunshine 主机，主机端点一下"确认配对"完成握手，客户端里能看到这台机器就算成功。
5. 选应用开串流。在后台把桌面或某个游戏加进应用列表，Moonlight 里点它，画面出来就算通关。

这张图对应第 2 步：浏览器打开后台后，先设置登录凭证，旁边就是文档资源入口。

🔌 为什么选它：4 个说得清的理由

编码器全覆盖：集显轻薄本也能跑

一句话：不管显卡是什么牌子，都有对应的硬件编码路径。

对你意味着：有张不错的 N 卡或 A 卡，硬件编码几乎不占 CPU；就算只有集显轻薄本，软件编码也能先把串流跑起来。

画面抓取：X11 / Wayland / DXGI 都有路

一句话：不只是编码，"怎么把画面抓出来"也提前铺好了路。

Windows 用DXGI，Linux 覆盖X11、Wayland、KMS/DRM、KWin、XDG Desktop Portal，macOS 走ScreenCaptureKit。机制名都摆在这，你在不同桌面环境基本不用自己造轮子。

划重点：Linux 上抓取方式要和你实际用的桌面环境对齐，X11 就选 X11，Wayland 就确认走 wlroots 或 Portal，硬凑容易黑屏。

手柄模拟：远程手柄本地化

一句话：把客户端传来的手柄信号，在主机上模拟成一台"本地手柄"，游戏根本察觉不到你是远程接入。

Xbox 360 / One / Series、PS4 / PS5、Switch Pro 这些型号，在 Windows 和 Linux 上都能完整模拟。

网页管理：搜索框改参数

一句话：不翻配置文件、不记命令，改哪个参数直接搜。

后台带搜索框，想改哪个设置键词一搜就定位，比如把 UPnP 自动端口映射的开关找出来只要几秒。

这张图对应"网页管设置"：搜索框一输，码率、端口、UPnP 这些开关都能直接定位。

⚠️ 适合谁，不适合谁

住校学生党：宿舍只有一台游戏本，想躺床上用手机玩。720p@30fps、码率压到 10Mbps 以内，校园网也跑得动。

多成员家庭：客厅电视、卧室笔记本、孩子的平板共用书房一台主机。电视 4K、笔记本 1080p、平板 720p，谁玩谁连，一台主机多端复用。

独立游戏开发者：不用买一堆测试机，就能测不同分辨率、帧率、编码器下的表现；远程协作时队友也能连上来现场看效果。

劝退提醒：如果你的主机是 macOS，官方标注它是实验性支持，手柄模拟目前不可用——Mac 当主机、又必须用手柄的话，先别硬上。Docker 镜像对大多数人也不建议，GPU 直通、输入设备都要额外折腾，直接装原生包省心。

被问得最多的 5 个问题

问题 1：画面能出来，但手柄没反应？九成是缺虚拟输入驱动。Windows 上需要装 Sunshine 配套的虚拟输入驱动，装完最好重启一次电脑；Linux 上把运行 sunshine 的用户加进input组。

问题 2：全用默认设置，画质稀碎？默认参数偏保守，建议按网络给码率。千兆有线可给 50Mbps 以上，5GHz 无线给 25Mbps 左右，再开高帧率或 HDR。具体参数在 docs/configuration.md 里逐项可调。

问题 3：局域网没问题，跨网段或外网就连不上？多半是路由器挡路。开 UPnP，或手动把 47989 附近的端口转发出去；游戏串流实际走的是 47998 起的 UDP 端口。

问题 4：连上了但画面花屏、掉帧？先打开后台的Troubleshooting 日志页。它把每次会话的细节都记下来，能帮你判断是编码器、网络还是驱动的问题。

这张图对应排查入口：日志页里逐条翻 warning / error，比盲猜快得多。

问题 5：浏览器提示"不安全网站"，正常吗？正常。后台用的是自签名证书，忽略那个警告继续就行。

最后

Sunshine 最实在的价值，是把"云游戏"从厂商的订阅里解放出来——码率、帧率、编码器全是你自己说了算。现在就去后台把第一个应用加进列表，Moonlight 里点一下，30 秒内画面就能出来。想再深一点，文档和编码器实现分别在 docs/ 和 src/nvenc/。

仓库地址：https://gitcode.com/GitHub_Trending/su/Sunshine

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