Sunshine 免费游戏串流服务器：三分钟把书房 PC 装进全家屏幕的完整指南

Sunshine 免费游戏串流服务器：三分钟把书房 PC 装进全家屏幕的完整指南

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

一个雨后的周末傍晚，你瘫在客厅沙发上，想接着昨晚没打完的那局 RPG，可游戏装在书房的 PC 里，显示器、手柄全拴在那张桌前。搬电脑到大厅？线要重插一遍，下次还得搬回来。更省事的路子是游戏串流：电脑留在原地负责渲染，把画面实时压成视频流送出去，再把你的操作传回去。而 Sunshine 就是一款完全免费、开源的游戏串流服务器，官方定位是 "Self-hosted game stream host for Moonlight"——不用订阅费，游戏库留在你自己的 PC 上，客厅、卧室、出差酒店的屏幕都能玩 🛋️

大白话原理：Sunshine 游戏串流是怎么跑起来的

把 Sunshine 想成你书房里的一间直播间导播台：游戏画面先被显卡上的硬件编码模块（一块独立于 CPU 的压缩电路，压缩时几乎不占用 CPU 资源）压成视频流，顺着家里网络发出去；Moonlight 则是散落在各个房间的"电视机"（它是各平台的免费串流客户端），负责解码显示，并把键盘、鼠标、手柄的操作原路送回。

也就是说，整条链路只有两个角色：Sunshine 在主机侧发送，Moonlight 在客户端侧接收。画质和延迟好不好，主要取决于三件事——显卡的编码能力、两端之间的网络、以及码率帧率参数。

官方最低配置要求（摘自 README）：

一句话记住：主机只负责渲染和编码，任何一块屏幕都能变成你的游戏窗口。

Sunshine 安装与 Moonlight 配对：快速上手教程

第一步：用一条命令安装 Sunshine

按你的系统选一条即可：

winget install LizardByte.Sunshine

flatpak install flathub dev.lizardbyte.app.Sunshine

brew install sunshine

docker pull lizardbyte/sunshine

想自己编译也可以克隆官方仓库：git clone https://gitcode.com/GitHub_Trending/su/Sunshine。装完后系统托盘里出现 Sunshine 图标，就说明服务已经在跑了。

第二步：打开 Web 管理后台，设好账号密码

浏览器访问 https://localhost:47990（首次是 https 自签名证书，浏览器提示"不安全"直接继续即可）。首次进入会让你创建用户名和密码，这是后面配对的唯一凭据，密码建议 12 位以上。验证点：能登录并看到 Configuration、Applications 等页面，即成功。

第三步：装上 Moonlight，用 PIN 完成配对

在手机、电视或另一台电脑装好 Moonlight 客户端，确认它与 Sunshine 主机在同一局域网。打开 Moonlight 会自动发现名为 "Sunshine" 的主机；当它弹出 PIN 输入框时，到 Sunshine 后台顶栏的 "PIN" 页面复制配对码填进去、给设备起个名字，即可绑定。验证点：Moonlight 里点 "Desktop"（桌面串流）能直接看到你的桌面画面，就算全链路跑通。

进阶玩法：添加游戏入口与画质参数怎么调

在 Applications 页面添加游戏入口

让每个游戏单独出现在串流列表里，客户端一目了然。操作路径：后台进 Applications → Add New → 填名称和启动命令，比如独立游戏直接填可执行文件路径，Steam 大屏模式填 steam://open/bigpicture，模拟器指向 RetroArch 主程序。保存后 Moonlight 列表里立刻多出一个图标。

小贴士：串流结束的行为由启动命令决定，如果某个应用串流一启动就立刻黑屏退出，多半是它需要以 detached（分离进程）方式运行，参考官方启动文档里的 Considerations 一节。

用配置搜索找到码率、帧率并调整

串流体验九成取决于码率、帧率、分辨率三个参数，而所有设置项都在 Configuration 页面，顶部搜索框输入关键词就能秒定位，改完点 Save 即时生效。编码器不用操心——Sunshine 会自动识别显卡走 NVENC、AMF 或 QuickSync；你要调的是：帧率尽量匹配游戏原生帧率（60/120），码率按网络给足（1080p60 给到 15–25 Mbps 起步，4K 拉满到 50 Mbps 以上）。

小贴士：后台左上角可以切换界面语言，参数几十上百个的时候，用熟悉的语言翻配置排错会快很多。

Windows 主机给远程设备"借"手柄

Sunshine 会把客户端的手柄输入在主机上虚拟成一个系统设备，Xbox、PlayStation、Switch Pro 手柄都支持。操作路径：Windows 主机装好后，到后台 Troubleshooting 页面安装虚拟手柄驱动（优先 Virtual HID Driver，ViGEmBus 作为降级方案），装完建议重启一次电脑。

小贴士：Linux 主机如果手柄完全没反应，多半是权限问题，把运行 Sunshine 的用户加入 input 组后重新登录即可，官方排障文档里有现成命令。

在 Featured Apps 页面找各平台 Moonlight 客户端

不想到处找下载源，后台 Featured Apps 页把各平台的 Moonlight 客户端和常用工具分门别类列好，点 "Get" 直达。

小贴士：电视盒子、安卓手机、Apple TV 的客户端都在这里，配对前先把客户端装齐，避免中途卡住。

后台主题与语言切换

深色、浅色、自定义配色在后台导航栏的下拉菜单里就能换，客厅大屏晚上用深色主题更护眼。

小贴士：主题只是界面外观，不影响串流本身，可以先跳过，回头再慢慢调。

把入口、参数、手柄都调顺之后，串流就从"能玩"变成"好用"了。

一次选型：游戏串流、云游戏和远程桌面怎么选

云游戏解决的是"没有好电脑"的问题，而你明明有一台能跑大作的 PC。远程桌面解决的是"远程操控"的问题，不是"流畅玩游戏"的问题。搬设备解决的是位置问题，代价是每次大动干戈——Sunshine 的思路是设备不动、只动画面，一次配置长期受益。

避坑手册：游戏串流常见问题与解决

1. Moonlight 一直发现不了 Sunshine 主机

• 原因：防火墙挡了端口，或两台设备不在同一子网。
• 解法：放行 47989（串流主端口，默认值）和 47990（Web 后台）；确认设备 IP 同网段；路由器开 UPnP 或手动端口转发。

2. 浏览器打不开 47990 后台

• 原因：防火墙规则拦截，或误信了"不安全网站"提示后没继续。
• 解法：先查防火墙；证书是自签名的，点"高级→继续访问"即可，属正常现象。

3. 画面一卡一卡，掉帧严重

• 原因：带宽不够或抖动大，或编码器被旧驱动拖后腿。
• 解法：码率降一档；WiFi 走 5GHz、能插线就插线；更新显卡驱动，编码器性能经常随驱动提升。

4. Windows 上远程手柄连上了但游戏没反应

• 原因：主机缺虚拟手柄驱动。
• 解法：Troubleshooting 页面安装 Virtual HID Driver（或 ViGEmBus 降级方案），装完重启电脑再试。

5. 忘了后台账号密码，进不去了

• 原因：凭据遗忘，没有在线找回入口。
• 解法：在主机上用 sunshine –creds 新用户名 新密码 重置（AppImage 加 ./ 前缀，Flatpak 走 flatpak run 方式），官方排障文档有现成命令。

6. 日志里报编码器错误，甚至黑屏

• 原因：所选编码器与显卡不匹配、驱动过旧，或 Linux 上 KMS 抓取权限/内核参数不对。
• 解法：后台 Troubleshooting 页面自带日志搜索和错误高亮，报错直接标红；按提示把编码器换回显卡支持的格式，Linux 用户可参考排障文档中 nvidia_drm.modeset=1 等条目对照处理。

排障顺序永远是：先日志、再参数、后系统。

收尾：今晚就能跑起来的 Sunshine 游戏串流

Sunshine 的价值一句话：让你的游戏库跟着生活场景走，而不是让游戏库锁死在电脑桌前。

•  用系统对应的命令装好 Sunshine，托盘出现图标
•  打开 https://localhost:47990，设置 12 位以上的强密码
•  手机/电视装 Moonlight，用 PIN 完成配对并串一次桌面
•  在 Applications 里加 1–2 个游戏入口
•  按设备把码率、帧率调到推荐值
•  出问题先看 Troubleshooting 日志，再对照排障文档

现在就装一个，让家里每一块屏幕都变成你的游戏窗口 🎮

延伸阅读：官方快速入门、排障手册、配置项全解

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考