3分钟搞定免费游戏串流：Sunshine 保姆级部署教程
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
程序员小林搬进新家那天雄心勃勃：书房放最强的主机，客厅摆最好的电视。可三个月过去，客厅那台 4K 电视的播放记录永远是综艺，主机上的《赛博朋克》始终停在第三章——不是不想玩，是"想玩"和"玩上"之间隔着搬主机、拔线、调分辨率的一地鸡毛。每次想把游戏画面搬到客厅，都要先把显示器支架拧下来，再把主机抱过去，玩完再抱回来。这样的日子，你是不是也眼熟？
Sunshine 就是来终结这摊麻烦的。它是一款免费开源、自托管的游戏串流服务器，装上它、配合 Moonlight 客户端，你就能在任意设备上无缝接管书房主机的完整桌面：
- ✅零订阅费：纯开源自托管，不依赖任何商业云服务
- ✅全系硬件编码：NVENC、AMF、QuickSync、VAAPI 自动识别，几乎不占 CPU
- ✅Moonlight 全家族兼容：PC、Android、iOS、树莓派都能连
- ✅浏览器管理后台：配置、日志、配对一条龙，改完即生效
- ✅跨平台覆盖：Windows / Linux / macOS / BSD 通吃
值不值得继续读？值得。接下来 3 分钟，你就能跑通人生第一次串流。
三步完成首次串流，今晚就能躺在沙发上开玩
第一步：安装，按系统对号入座
- Windows：下载官方安装包，双击一路下一步即可
- Linux：执行
flatpak install flathub dev.lizardbyte.app.Sunshine - macOS：执行
brew install sunshine - 想尝鲜最新版，也可以从源码编译（仓库地址见文末）
第二步：设置管理密码
浏览器打开http://localhost:47990，默认用户名为sunshine，首次进入会要求你设置密码。请妥善保存——忘了只能靠命令行重置（下方避坑指南有救急方案）。
第三步：配对客户端
在手机、平板或另一台电脑安装 Moonlight 客户端，确保与主机处于同一局域网。打开后它会自动发现 Sunshine 主机，输入配对码即完成连接。
搞定！现在打开 Moonlight 点一下桌面图标，你就能在任意设备上看到书房主机的完整桌面，延迟低到几乎无感。✅
玩法进阶：把串流玩出花样
应用管理：把桌面和游戏都收进串流列表
Applications 页面就是你的"串流节目单"。桌面（Desktop）默认已配置好，点 Edit 确认路径后即可随时远程访问整个桌面；想串流特定游戏，点 Add New 填入游戏名、选择可执行文件路径、按需设置启动参数，保存即可。新增应用后记得重启一次 Moonlight 客户端，列表才会刷新。
配置搜索：几千个设置项一键直达
Web 后台的设置项多到眼花？试试右上角的搜索框——输入UPnP、bitrate等关键词，相关配置会立刻高亮定位，再也不用逐层翻菜单。比如想开启公网自动端口转发，搜 "UPnP" 勾选保存就完事，相当省心。
日志排查：卡顿断连不再靠猜
遇到画面卡顿、编码失败，先别急着百度。打开 Troubleshooting 页面实时查看日志，错误信息写得相当直白，比如 "Encoder not found" 会直接告诉你编码器没找到，还附带 GPU 型号与编码参数，方便你对照排查。更多参数说明可翻阅docs/configuration.md，官方文档就躺在仓库里。
常见疑问速答：新手最常踩的四个坑
Q1：客户端怎么也发现不了 Sunshine？
八成是防火墙拦住了端口。放行47989（串流端口）和47990（Web 界面端口），并确认两台设备处于同一局域网。
Q2：忘了 Web 界面密码怎么办？
别慌，在 Sunshine 主机上执行sunshine --creds 新用户名 新密码即可一键重置；Flatpak 安装需加前缀flatpak run --command=sunshine dev.lizardbyte.app.Sunshine。
Q3：手柄在游戏里没反应？
Windows 下先确认已安装 ViGEmBus 虚拟手柄驱动；进 Steam 设置，把手柄配置改为只支持"通用手柄"，并禁用主机上直连的实体手柄，让 Sunshine 虚拟出的手柄成为"第一手柄"。
Q4：画面一卡一卡的？
串流对网络稳定性的要求远高于带宽。用iperf3测主机到客户端的 UDP 丢包与抖动：丢包应小于 5%、抖动低于 1ms；不达标就先降分辨率、降码率。
现在就动手：让客厅电视响起 PC 游戏的 BGM
从下载安装到躺沙发上开玩，全程不到十分钟。Sunshine 让"游戏无处不在"从口号变成了现实。官方文档就躺在仓库的docs/目录里：docs/getting_started.md带你起步、docs/configuration.md教你调参、docs/troubleshooting.md帮你排障。现在就动手：
git clone https://gitcode.com/GitHub_Trending/su/Sunshine写作流程清单：定关键词（游戏串流 + Sunshine 部署 / Moonlight 配对 / 家庭串流环境）→ 搭六段骨架 → 写初稿 → 配图并补 alt → 打磨标题与收尾。🎮
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
