五大阶段打造Sunshine游戏串流服务器：自托管部署到远程畅玩的完整指南
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
当你躺在沙发上，想用平板或电视玩电脑里的 3A 大作时，传统云串流平台往往伴随着会员费、画质压缩与高峰期排队。Sunshine 是一款完全开源、自托管的游戏串流服务器（Self-hosted game stream host for Moonlight），它将游戏画面实时编码后推送出去，配合免费开源的 Moonlight 客户端，就能在局域网甚至跨互联网获得接近原生的串流体验，且不产生任何订阅费用。这份 Sunshine 游戏串流服务器搭建指南，会带你用五大阶段走完从安装、初始化、接入游戏到网络调优的全过程，全程不涉及复杂代码，跟着操作即可。
需要先说明的是，Sunshine 的定位始终是"发射端"：它只负责把电脑里的画面和声音变成网络流，本身不提供界面上的游戏列表。真正负责"接收"的是各平台上的 Moonlight 客户端——两者组合，才是完整的串流链路。理解了这一点，后面的每一步都会很顺畅。
阶段一：先看懂架构，再动手安装
串流的本质可以拆成三步：编码 → 传输 → 解码。游戏电脑上的 Sunshine 调用显卡编码器，把画面压成 H.264、HEVC 或 AV1 码流；网络把码流送到接收设备；Moonlight 解码并渲染画面，同时把手柄、键盘的输入反向送回主机。整个闭环延迟越低，手感就越接近坐在电脑前。
相比商业云串流，自托管方案的四个优势值得记住：
- ✅零订阅：软件免费，流量走自己的网络，不按小时计费
- ✅画质可控：码率、分辨率、帧率都由你设定，不受平台限速
- ✅隐私在本地：画面数据不出家门，适合对数据敏感的用户
- ✅设备覆盖面广：Windows、macOS、Linux、Android、iOS 及各类电视盒子都有客户端
搞清楚这套"主机 + 客户端"的协作关系后，接下来就是按你的设备选择安装方式。
阶段二：三大平台的 Sunshine 安装教程
安装环节没有统一答案，选择完全取决于你的操作系统。无论走哪条路，安装完成后 Sunshine 都会以后台服务的形式运行，并在系统托盘出现图标。
Windows：官方安装包，双击即用
Windows 用户最省心：前往项目的发布页面下载最新版安装程序，一路点击下一步即可。安装器会顺手注册系统服务，装完无需手动启动，托盘区的小图标就是它正在运行的标志。
Linux：一条脚本搞定编译
Linux 下的标准做法是拉取源码后用官方脚本编译，整个过程由脚本自动完成依赖检测与构建：
git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine ./scripts/linux_build.sh如果你用的是 Arch 系发行版，也可以直接用仓库里的 PKGBUILD 打包安装，省去编译等待时间。
macOS：一条 Homebrew 命令
macOS 用户最轻松，终端里执行：
brew install sunshine装完即拥有与桌面版一致的功能，配合 Apple Silicon 的硬编能力，串流画质同样出色。
阶段三：首次启动，建立你的安全基线
服务跑起来后，真正的主战场在 Web 控制台。在浏览器地址栏输入http://localhost:47990，即可进入 Sunshine 的管理界面。
第一次访问时你会看到欢迎页，系统会要求你创建一个用于登录 Web 界面的用户名和密码。页面上有一句醒目的黄色提示：这组凭据只在首次设置时展示一次，之后不会再出现，请务必妥善保存。建议直接把账号信息记到密码管理器里，避免日后忘记。
登录之后，你会进入控制台主页。顶部导航栏依次是 Home、PIN、Applications、Featured Apps、Configuration、Change Password、Troubleshooting 与 Theme 等入口。其中PIN 页面用于快速配对客户端，Configuration承担全部参数调整，Troubleshooting则是一站式的状态检查与日志查看中心，熟悉这几个入口就掌握了整个控制台。
阶段四：接入游戏与应用，让两台设备握手
控制台就绪后，下一步是把电脑里的游戏"登记"进 Sunshine，并让接收设备连上来。
在 Web 界面登记应用
进入 Applications 页面，默认已经内置了DESKTOP（串流整个桌面）与STEAM（直接唤起 Steam 大屏模式）两个快捷方式。想添加自己的游戏，点击右下角的Add New，填入应用名称与可执行文件路径即可。对于支持命令行参数启动的游戏，还可以在后面追加启动参数，实现一键直达。
需要注意：应用列表的刷新依赖客户端重启。新增或修改应用后，如果接收端看不到变化，重启一次 Moonlight 就能同步。
安装 Moonlight 客户端并完成配对
Sunshine 的Featured Apps页面是官方整理的客户端大全：PC、Android、iOS 以及各类嵌入式 Linux 设备的 Moonlight 客户端都能从这里找到入口，点开即可按平台下载。
配对过程很直接，只需要三步：
- 启动接收设备上的 Moonlight，点击右上角的"添加主机"按钮
- 输入游戏电脑在局域网中的 IP 地址
- 对照控制台 PIN 页面显示的 4 位数字，在客户端中完成输入
配对成功后，客户端会自动拉取你在 Sunshine 里登记的应用列表，点一下即可开玩。
阶段五：网络优化与避坑清单
串流体验的上限由网络质量决定。按下面这份清单逐项排查，可以避开绝大多数新手会踩的坑。
局域网畅玩：优先有线，其次 5GHz
在同一房间内，首选网线直连；条件不允许时，确保接收设备连接的是 5GHz 频段而非 2.4GHz。带宽充裕的前提下，建议把码率设置到 20Mbps 以上、帧率锁定与显示器刷新率一致，画质与流畅度都会有明显提升。
远程串流：开启 UPnP 自动端口转发
想在公司或旅途中连回家里的电脑，就需要让 Sunshine 的端口对公网可见。在 Configuration 页面顶部的搜索框中输入Upnp，勾选 UPnP 选项并保存，路由器会自动完成端口转发配置，免去手动折腾路由器的麻烦。
Windows 手柄支持：一键安装 ViGEmBus
如果你打算在 Windows 主机上使用虚拟手柄，需要先安装 ViGEmBus 驱动。打开 Troubleshooting 页面，如果检测到驱动缺失，界面上会直接给出Install ViGEmBus按钮，点击即可完成安装，无需手动下载。
遇到问题先看日志
串流失败时，别急着反复重启。Troubleshooting 页面提供的日志中心会按时间戳记录每次会话的详细信息，错误信息通常用红色标出，例如编码器打不开（"Encoder not found"）多半与显卡驱动或编码器配置有关，照着日志逐条排查效率最高。
顺手做点个性化
最后，Sunshine 的 Theme 选项支持多套配色方案，深浅色主题随意切换，让管理界面更贴合你的审美。
收尾：接下来该做什么
到这里，你的 Sunshine 游戏串流服务器已经完整跑通：安装、初始化、应用接入与网络调优全部就位。接下来可以做的三件事：
- 查阅官方文档：所有配置项的详细说明都在 docs/configuration.md，遇到故障优先翻 docs/troubleshooting.md
- 加入社区交流：无论是配对问题、编码器调优还是新功能建议，社区里都有大量现成经验可参考
- 从简到繁逐步尝试：先在局域网内稳定畅玩，再逐步挑战跨网络串流，最后研究码率与编码器的高级调优
常见疑问速答：忘记 Web 密码？删除配置目录下的凭据文件后重新初始化即可；串流黑屏？先检查显示器是否处于休眠状态，部分显卡在无显示输出时编码会异常；延迟偏高？优先排查网络是否混用 2.4GHz 频段，以及是否开启了影响性能的节能模式。
自托管串流的魅力就在于"我的游戏我做主"。现在就把 Moonlight 装上，挑一款最喜欢的游戏，享受属于你自己的零延迟客厅游戏时光吧！🎮
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
