5步搭好免费自托管游戏串流服务：Sunshine 从安装到畅玩全指南
5步搭好免费自托管游戏串流服务：Sunshine 从安装到畅玩全指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一款完全免费、开源的自托管游戏串流服务器，它把"云游戏"这件事搬回你自己的家里：让电脑负责游戏运行，再通过局域网把画面实时送到手机、平板或客厅电视上。如果你既不想为云游戏订阅掏月费，又希望游戏库始终握在自己手里，这套自托管游戏串流方案几乎就是为你量身定做的。本文从零开始，用五步带你完成搭建、配对、加游戏和调优，全程不需要懂代码。
先聊一个真实场景：游戏为什么会被"困"在书房
很多玩家的日常是这样的：新买的 3A 大作装在书房那台高性能电脑上，可客厅只有一台电视，沙发上的人玩不到；想在被窝里用平板续玩，又嫌重新开档太麻烦。传统云游戏服务能解决一部分问题，但每月订阅费、锁区限制、游戏库由平台说了算，再加上存档和隐私都存在云端，总让人不太安心。
Sunshine 的思路完全不同——它不提供游戏，只负责"搬运"。你电脑上已有的游戏，通过 Sunshine 编码后发送到任意一台安装了 Moonlight 客户端的设备上。游戏文件、存档、进度全部留在本地，串流通道也默认只走你的局域网。省钱、私密、自由，这正是它能在开源社区持续走红的原因。
第一步：弄清原理，确认自己的设备能不能跑
在动手安装前，先花一分钟搞清楚这套系统的分工，后面排错会轻松很多：
- Sunshine（本机服务端）：负责采集屏幕画面、用显卡硬件编码、通过网络推送出去，同时接收客户端的输入指令（键鼠、手柄）。
- Moonlight（远程客户端）：负责接收画面、解码显示，并把你的操作回传给 Sunshine。手机、平板、电视盒子、另一台电脑都能装。
Sunshine 最聪明的地方在于编码器选择完全自动化，它会根据你的显卡自动挑最合适的方案：
| 显卡厂商 | 编码技术 | 特点 |
|---|---|---|
| NVIDIA | NVENC | 性能强、画质好，是目前体验最成熟的方案 |
| AMD | AMF | 兼容性好，Windows 与 Linux 均可用 |
| Intel | QuickSync | 核显即可用，功耗低，适合轻薄主机 |
| 任意（备选） | 软件编码 | 没有独显也能跑，画质与性能平衡交给 CPU |
💡 编码相关的核心实现集中在项目源码的
src/nvenc/目录，感兴趣的进阶玩家可以翻一翻，理解不同显卡的适配逻辑。
硬件门槛其实不高：一台装了独立显卡（N 卡 A 卡均可）的电脑即可，Intel 核显也能应急。确认显卡型号后，到显卡官网把驱动更新到最新版，这一步直接决定串流是否流畅。
第二步：按系统选择安装方式，5 分钟装完
Sunshine 官方同时维护 Windows、Linux、macOS、FreeBSD 四个平台的构建产物，安装方式非常灵活。
Windows 用户
最简单的是直接下载官方.exe安装包双击安装；喜欢命令行的话，一行命令即可：
winget install LizardByte.SunshineLinux 用户
如果用的是 Fedora、Ubuntu 等常见发行版，Flatpak 是最省心的途径：
flatpak install flathub dev.lizardbyte.app.Sunshine偏好免安装便携方案，可以下载sunshine.AppImage，赋予执行权限后直接运行。动手能力强的同学也可以从源码构建，仓库里提供了完整的 CMake 构建脚本。
macOS 与 Docker
macOS 用户通过 Homebrew 一条命令完成：
brew install sunshine想用容器隔离环境的话，拉取官方镜像即可：docker pull lizardbyte/sunshine。
⚠️ 注意：Docker 部署需要额外处理显卡直通和容器权限，官方文档并不推荐新手首选，先在本机装好跑通，再考虑容器化。
第三步：首次启动，3 个动作完成初始化
装好后运行 Sunshine，然后在浏览器打开http://localhost:47990，会看到欢迎页面。这页做的很贴心：除了创建账号，还把文档、社区和许可证入口都摆在了旁边，方便你随时查阅。
初始配置只需三步：
- 用户名默认是
sunshine，直接沿用即可； - 设置一个强度足够的密码，它保护着你的整个串流入口，务必记牢；
- 保存后进入主界面，首次会提示配置网络相关选项，默认值对大多数家庭局域网已经够用。
完成这些，服务端就绪了。接下来打开手机上的 Moonlight 客户端，它通常会自动发现局域网里的 Sunshine 主机，手动输入主机 IP 也能连接，随后完成 PIN 码配对即可。
第四步：把游戏装进 Sunshine 的应用管理
配对成功只代表"通道"通了，真正要串流什么，需要在 Sunshine 的 Web 界面里配置"应用"。这里说的"应用"泛指一切可启动的程序——游戏、Steam 大屏模式、模拟器都可以。
添加一个应用的操作很直观：点"Add New"，选类型（桌面、Steam、自定义程序），填名称和启动路径，保存后就可以在 Moonlight 端看到并一键启动。项目自带了DESKTOP（桌面串流）和STEAM（Steam 大屏模式）两个常用模板，大多数场景改一改路径就能用，完整的字段说明在官方文档docs/目录里有详解。
💡 小技巧：给游戏单独建应用时，把"启动前命令"和"退出后命令"配合起来，可以实现进入游戏前自动关掉无关窗口、退出后自动恢复桌面，体验接近原生主机。
第五步：调优画质与延迟，串流才能"跟手"
游戏串流最怕两件事：画面糊、操作延迟。这两个问题都靠编码参数和网络质量解决。
编码器与码率怎么配
在配置页面的搜索框里输入关键词，比如"bitrate"或"fps"，就能快速定位对应选项，不用在一长串设置里翻找。配置界面本身也值得夸一句：搜索直达、分类清晰，中文界面友好度很高。
新手可以参考这套码率基准起步，再按实际效果微调：
| 目标体验 | 推荐码率 | 说明 |
|---|---|---|
| 1080p 60 帧 | 15~25 Mbps | 千兆局域网内的"保底画质"，流畅度优先 |
| 1440p 高帧率 | 25~50 Mbps | 适合 2K 显示器与高刷设备 |
| 4K 60 帧 | 50~100 Mbps | 客厅大屏最佳体验，对网络稳定性要求最高 |
想验证网络到底行不行，可以用iperf3做一次主机到客户端的反向 UDP 测试，参考数值：50 Mbps 速率下丢包率应趋近于零。
网络优化两条原则
- 优先有线：主机端务必插网线（千兆口、CAT5e 以上线材），路由器开启 QoS 给串流流量让路；
- 无线也有救：实在要无线，客户端用 5GHz 频段、信号强度保持在 -60dBm 以上，WiFi 6 路由器的表现会好很多。
⚠️ 注意：串流的敌人是"波动"而不是"带宽"。带宽再高，如果延迟忽高忽低、频繁丢包，游戏照样卡成幻灯片。
客户端推荐：Moonlight 全家桶够你用
Sunshine 官方推荐并深度适配的客户端是 Moonlight，它在 Windows、macOS、Linux、Android、iOS 都有对应版本，甚至还有面向树莓派等嵌入式设备的 Moonlight Embedded。Sunshine 的"精选应用"页面把这些客户端和辅助工具集中列了出来，配好即用，非常省事。
选择建议很简单：手机平板装 Android/iOS 版，客厅电视盒子用 TV 版或嵌入式版，卧室笔记本直接用 PC 版。所有客户端共享同一个配对流程，一台主机可以同时配多台设备。
排错手册：四个高频问题一次说清
真遇到问题别慌，按下面的清单排查，绝大多数情况 5 分钟内能解决。详细说明在官方文档docs/troubleshooting.md。
问题一：客户端找不到 Sunshine 主机
- 检查两端是否在同一局域网（不同 VLAN 或访客网络会互相看不见）；
- 确认系统防火墙放行了 TCP 47989 和 UDP 47984/48010 等端口；
- 重启一次 Sunshine 服务和路由器，让 UPnP 重新生效。
问题二：画面卡顿、掉帧明显
- 先降码率或分辨率做二分定位，看是编码压力还是网络瓶颈；
- 关掉主机上正在下载、上传的软件，串流时网络独占更稳；
- 更新显卡驱动，检查主机 CPU/GPU 占用是否异常。
问题三：忘记 Web 界面密码不用重装，终端里一条命令重置：
sunshine --creds 新用户名 新密码（Flatpak 安装的话前面加flatpak run --command=sunshine dev.lizardbyte.app.Sunshine）
问题四：手柄在 Steam 里正常、进游戏却没反应到 Steam 设置里只保留"通用手柄支持"，关闭单独的 Xbox/PlayStation 控制器支持；同时把直接插在主机上的实体手柄拔掉或停用，让串流虚拟出的手柄排在"第一顺位"。
遇到更复杂的问题，日志是最好的诊断工具。Web 界面里就能直接查看和搜索日志，不必翻文件。
日志文件的默认位置也记住一下：Windows 在%ProgramFiles%\Sunshine\config\sunshine.log，Linux/macOS 在~/.config/sunshine/sunshine.log，Docker 部署则用docker logs sunshine。
进阶玩法：从"能玩"到"玩得爽"
基础跑通之后，这几件事能明显提升体验：
- HDR 与高帧率：显示器和电视支持的话，开启 HDR 串流，画质观感会上一个台阶；帧率按游戏原生值匹配（60/120/144），配合垂直同步消除撕裂；
- 多用户共享：一台 Sunshine 主机可同时配多台客户端，家庭成员各用各的设备，互不影响；
- 手柄模拟：项目支持模拟 Xbox、PlayStation（DS4/DS5）、Switch Pro 等多种手柄，跨平台兼容性矩阵在 README 里有完整表格，Windows 下 Xbox 系手柄兼容最全；
- 客厅大屏方案：主机连电视，客户端用 4K 输出、码率拉到 50Mbps 以上，配合环绕声输出，体验非常接近主机平台。
动起来：你的下一步行动清单
整套流程其实就五件事，现在就可以开始：
- 到
https://gitcode.com/GitHub_Trending/su/Sunshine克隆或下载源码，或直接按上文方式安装对应系统的构建包； - 启动服务，在
localhost:47990完成账号创建； - 装好 Moonlight 客户端并完成 PIN 配对；
- 在 Web 界面添加你的第一款游戏应用；
- 从有线网络起步，跑通后再按码率表格做画质微调。
串流这件事，最怕的是"感觉麻烦"而一直没开始。其实装上 Sunshine 到玩到第一款游戏，通常用不了一顿晚饭的时间。当你在客厅沙发上、在被窝里流畅玩起书房电脑里的游戏时，会觉得一切都值得。祝玩得开心，也欢迎把遇到的问题带到项目文档docs/的对应章节里找答案——那里藏着让体验更进一步的钥匙。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考