Sunshine 实战教程：如何用 10 分钟把电脑变成免费游戏串流服务器
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
云游戏订阅按月扣费，画质和延迟都看别人脸色。想把主机搬到客厅接大屏，拆线重装又是半天。Sunshine解决这件事：一款免费开源的游戏串流服务器，装在自己的电脑上，家里任何终端都能把主机里的游戏串过来玩。
为什么选 Sunshine
- 游戏跑在你自己的电脑上，画面走自己的显卡编码，不经过任何云，不产生订阅费
- 按显卡自动选硬件编码，NVIDIA、AMD、Intel 都有对应方案，CPU 基本不参与
- 接收端只需要一个免费的 Moonlight 客户端，手机、平板、电视盒子、笔记本都能接
Sunshine 安装步骤：按系统三选一
先备齐三样：一台能跑游戏的主机（Sunshine 装在这台）、一台接收终端（手机、平板或笔记本）、两者连在同一局域网。
- Windows：从项目 Release 页下载官方
.msi安装包，双击按向导装完，Sunshine 会自动注册为后台服务 - Linux（Ubuntu/Debian）：两条命令装好 Flatpak 版并同步系统权限
flatpak install --system flathub dev.lizardbyte.app.Sunshine flatpak run --command=additional-install.sh dev.lizardbyte.app.Sunshine其他发行版也可从 Release 页下载对应.deb/.rpm包安装。
- macOS：
brew tap LizardByte/homebrew brew install sunshine注意：macOS 版目前标记为实验性，手柄暂不支持。
Sunshine Web 后台：两分钟完成首次设置
装完后打开浏览器访问https://localhost:47990，localhost可换主机内网 IP。浏览器提示"不安全"是自签名证书，点继续即可。
预期看到：设置页要求创建用户名和密码，填完即进入后台。
⚠️ 这组凭据只显示一次，立刻保存；忘了只能靠命令行重置。
Linux 若没装成服务，手动启动一次：
systemctl --user start app-dev.lizardbyte.app.SunshineSunshine 配对码：一分钟绑定新设备
后台就绪后，在终端装 Moonlight 客户端（应用商店搜 Moonlight）。打开后它会自动发现Sunshine 主机；没出现就手动添加，填主机内网 IP。
预期看到：主机出现在 Moonlight 列表里。
点它连接，Moonlight 会显示一个配对PIN。回到后台，点顶部导航栏的PIN，输入同一个 PIN 并给设备起个名字。
预期看到：页面弹出成功提示，Moonlight 侧已能列出游戏。
Sunshine 应用配置：让游戏上任何大屏
配对完成后打开后台Applications页。目标就两种：整桌面串流，或一键拉起指定游戏。
- 桌面：列表里默认有Desktop，确认保存即可随时串流整个桌面
- 游戏：点Add New，填游戏名、可执行文件路径、启动参数，保存
预期看到：列表多出一条新应用；切到 Moonlight 点它，主机自动启动游戏并开始串流。
Sunshine 延迟排查：编码器和网络
串流跑起来之后，体验由两头决定。
编码端 Sunshine 自动按显卡选择，无需手动指定：
| 硬件条件 | 推荐编码器 | 适用环境 |
|---|---|---|
| NVIDIA 显卡 | NVENC | Windows / Linux |
| AMD 显卡 | AMF / VAAPI | Windows 用 AMF，Linux 用 VAAPI |
| Intel 核显 | QuickSync / VAAPI | Windows 用 QuickSync，Linux 用 VAAPI |
| Mac | Video Toolbox | macOS |
| 以上都没有 | 软件编码 | 兜底方案，全平台 |
网络端先测一次底：主机跑iperf3 -s，终端跑iperf3 -c 主机IP -t 60 -u -R -b 50M，看终端输出。
判定线：丢包 < 5%、抖动 < 1 ms。
- 达标：可以放心拉高码率，甚至试 4K
- 不达标：先确认两端都走 5GHz 或有线；仍不行就先降分辨率、降码率
💡 有线优于 5GHz，5GHz 优于 2.4GHz。
还卡，就去后台 Troubleshooting 页翻日志，警告写得直白：
Sunshine 常见问题：四个高频坑
- 现象：后台进不去，密码忘了。原因：凭据只在首次设置时显示一次。解决：终端执行
sunshine --creds 新用户名 新密码现象：Moonlight 搜不到主机。原因：主机防火墙挡了串流端口。解决：检查防火墙规则，放行 Sunshine 的端口。
现象：Linux 串流后键鼠没反应。原因：运行 Sunshine 的用户不在
input组。解决：执行sudo usermod -aG input $USER，注销重新登录生效。现象：Flatpak 或 AppImage 版掉帧。原因：沙箱缺提权，日志里有
CAP_SYS_NICE警告。解决：换 Vulkan 编码，或改用发行版官方包安装。
Sunshine 进阶配置与文档资源
三个容易错过的功能：
- 配置搜索：右上搜索框输入
UPnP、bitrate，对应选项直接高亮，不用翻菜单
- 端口族整体偏移：只改
port一项（默认 47989），整套端口随之移动，避免端口冲突 - 远程配对授权：任何设备的浏览器打开 47990 端口输入 PIN 即可放行新设备，出差在外也能登记家里新平板
想深入就拉源码看文档：
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），仅供参考
