免费把书房主机变成全屋游戏终端：Sunshine 自托管游戏串流完整上手
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
晚上十点，你窝在沙发上想续白天没打完的那局《艾尔登法环》，可那台 RTX 4080 主机还亮在书房。搬过去太折腾，再买一台钱包抗议。Sunshine 就是干这个的：把它装在主机上，游戏画面经局域网实时串流到你手边的平板、电视或笔记本——免费、开源、自托管，画面和声音全走硬件编码，延迟低到可以打动作游戏。
一句话说清：它是 Moonlight 的开源服务端
Sunshine 是一个自托管的游戏串流服务端，免费开源的 Moonlight 客户端是它的"接收端"。游戏跑在你自己的电脑上，画面和声音被实时编码后通过网络送到任意屏幕，平板、电视、轻薄本统统能当"远程显示器"。对比商业云游戏订阅：不按月付费、不锁功能、画质帧率自己调，硬件 100% 在你手里。
划重点：Sunshine 管"发送"，Moonlight 管"接收"，两者一配，就是一套完全属于你自己的云游戏方案。
从零配对到第一次串流
装服务端
Windows 在终端里直接：
winget install LizardByte.SunshineLinux 用户可选 .deb 包、AppImage 或 AUR；macOS 一句brew install sunshine搞定。
打开网页后台
浏览器访问https://localhost:47990，首次进入会让你设置管理员账号密码。之后所有配置、配对确认、日志查看，都在这一个网页里完成。
首次启动的欢迎页：设置登录凭证，顺手把旁边的文档入口看一遍。
装客户端
在你真正要玩的那台设备上装 Moonlight：手机、平板、电脑、电视盒子，应用商店搜名字就有。
配对开跑
打开 Moonlight，它会自动扫局域网里的 Sunshine 主机（也可以手动填 IP）。主机网页端点一下"确认配对"完成握手，然后选桌面或任意一个应用，开串。
从装机到画面出现在屏幕上，熟手大概 10 分钟，新手摸一摸不超过半小时。
能力拆解：它为什么值得装
全显卡通吃：集显轻薄本也能当主机
| 编码器 | 厂商 | 平台 |
|---|---|---|
| NVENC | NVIDIA | Windows / Linux |
| AMF | AMD | Windows |
| QuickSync | Intel | Windows |
| VAAPI | AMD / Intel / NVIDIA | Linux / FreeBSD |
| Video Toolbox | Apple / Intel | macOS |
| Vulkan Video | 三家 | Linux / FreeBSD |
| 软件编码 | 任意 CPU | 全平台 |
编码器还会自动挑选，不用你折腾驱动参数。这意味着你不用为了串流专门买显卡——一台五年前的集显本，也能把"主机"的活干起来。
屏幕抓取：桌面环境全覆盖
Windows 走 DXGI 或 Windows.Graphics.Capture；Linux 覆盖 X11、Wayland（wlroots）、KMS/DRM、KWin 录屏、XDG Desktop Portal、NvFBC；macOS 走 ScreenCaptureKit。每种桌面环境都有现成抓取方案。这意味着你换新系统时不用纠结"为什么我黑屏"——在支持表里就有路径。
手柄模拟：游戏以为你是本地玩家
主机端把客户端传来的手柄信号模拟成本地手柄，Xbox 360 / One / Series、PS4 / PS5、Switch Pro 全都能模拟，Windows 和 Linux 上均可用。这意味着游戏察觉不到你在沙发，本地手感一分不少。
备注：macOS 暂不支持手柄模拟，FreeBSD 仅部分支持——拿 Mac 当主机前，先确认自己的需求。
一个网页管完所有设置
不用翻配置文件、不用记命令，绝大多数设置都在 Web 后台完成，还带搜索框，输入关键词直接跳到对应开关。
配置搜索界面：想开 UPnP 自动端口映射，搜一下关键词就能定位到开关。
这意味着所有调参动作都发生在浏览器里，手机远程改主机设置也没问题。
谁在真用
住校学生党：游戏本 + 手机。画质压到 720p@30fps、码率 10Mbps 以内，校园网 WiFi 也能跑得动——躺在床上玩，本子在桌上不烫手。
多口之家：客厅 Android TV、卧室笔记本、孩子的平板，共用书房那台主机。电视 4K@60、笔记本 1080p、平板 720p，谁玩谁连，一张显卡全家用，省下的硬件预算够买不少游戏。
独立开发者：不同分辨率、编码器下的表现直接在自己机器上测；远程协作时队友连上你的机器看实时效果。这意味着不用买一堆测试机，一台顶一队。
应用管理页：把桌面、Steam 大屏模式和常用游戏加进列表，Moonlight 里一键可选。
新手避坑清单
坑 1：画面正常，手柄没反应（Windows）。九成是没装虚拟手柄驱动。打开 Web 后台的"故障排除"页，按引导安装虚拟手柄驱动（Virtual HID Driver，老环境可回退 ViGEmBus），装完重启一次。
故障排除页里的驱动安装入口：按页面指引装完，手柄立刻被识别。
坑 2：画面糊得像隔了一层纱。默认参数偏保守。千兆有线给 50Mbps 以上码率，5GHz 无线给 25Mbps 左右，再开高帧率，效果立竿见影。
坑 3：跨网段或外网连不上。在后台开启 UPnP 自动端口映射，或手动在路由器上转发 47989 附近的 TCP/UDP 端口。
坑 4：Linux 上黑屏。抓取方式和桌面环境必须对上：X11 选 X11，Wayland 走 wlroots 或 Portal 那条路，硬凑错配必黑屏。
坑 5：拿 Docker 镜像当首选。GPU 直通、输入设备、配置都要额外折腾，官方文档建议大多数场景直接装原生包。
卡住了怎么办
先翻 Web 后台"故障排除"页的日志，每次会话的细节都记在里面，花屏、连不上、编码器报错都能看出个大概。搜 "encoder"、"not found"、"failed" 这类关键词，能快速分清是驱动、网络还是编码器的问题。想细调参数看配置手册 docs/configuration.md，连接类问题翻 docs/troubleshooting.md，追求极限延迟读 docs/performance_tuning.md。
日志页：看到 "Encoder not found" 这类提示，基本可以断定是驱动没装对。
把主机请出书房
Sunshine 真正打动人的地方，是把"在哪玩游戏"这件事从订阅服务手里夺了回来——技术、隐私、自由度全在自己手上。下一步动作很明确：装好、配对、连一次，然后从沙发上用平板打开书房那台主机的《艾尔登法环》，你会发现被锁在书房的从来不是乐趣。想深挖实现的，克隆下来翻源码：git clone https://gitcode.com/GitHub_Trending/su/Sunshine。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
