Sunshine 游戏串流主机完全指南：免费开源，一台 PC 15 分钟开播
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是免费开源的游戏串流服务器，跑在你自己的 PC 上，配合 Moonlight 客户端把画面和输入送进任意屏幕。适合有一台能玩游戏的电脑、想零月费把游戏搬上电视、平板或手机的人，从装好到配对通流大约 15 分钟，不花一分钱。
什么情况下值得自己搭
先算账：串流方案分三种，区别在成本和归属。
| 对比项 | 云游戏订阅 | 厂商自家串流 | Sunshine 自托管 |
|---|---|---|---|
| 每月花费 | 订阅费 | 一般免费但受生态限制 | 0 元，开源 |
| 游戏跑在哪 | 厂商机房 | 你的电脑 | 你的电脑 |
| 数据去向 | 第三方 | 厂商生态内 | 只走自己的网络 |
| 客户端 | 受限 | 自家设备 | Moonlight：Win / macOS / Linux / Android / iOS / 电视盒子 |
| 编码 | 服务端统一 | 厂商自研 | 显卡硬件编码（NVENC、AMF、QuickSync、VAAPI），也可软件编码 |
结论：游戏本来就在你显卡上跑，只是想换个屏幕看——自托管就是最省的那条路。
我的机器能不能跑
四项检查，每项给验证方法和兜底方案。
- 系统版本：要求 Windows 11、Ubuntu 22.04+、Debian 13+（trixie）、Fedora 43+、macOS 14.2+、FreeBSD 15.1+。验证：
uname -a或系统"关于"页。不满足：老系统装不了官方包，只能 Docker 凑合或换机；macOS 目前还是实验性质且不带手柄支持，主力玩机建议用 Windows 或 Linux。 - 硬件门槛：CPU 至少 Ryzen 3 或 Core i3，内存 4GB，显卡能硬件编码即可——AMD 要 VCE 1.0+，Intel 要 VAAPI 核显（Windows 上是 Skylake 起的 QuickSync），NVIDIA 要 NVENC 卡。验证：驱动工具或 配置参考 里看编码器选项。不满足：Sunshine 自带软件编码，全平台可用，只是吃 CPU。
- 网络：主机和客户端都建议 5GHz（802.11ac）；上 4K 时两边最好都插 CAT5e 以上网线。验证：
ipconfig或系统网络面板。不满足：2.4GHz 能串但别追 4K，先压分辨率和码率。 - 4K / HDR 高配项：4K 要 VCE 3.1+（AMD）、HD 510+（Intel）、RTX 2000 系 / GTX 1080+（NVIDIA）外加 Ryzen 5 / i5 级 CPU；HDR 门槛见 README 的 HDR 表，且主机系统要先开启 HDR。达不到：先跑 1080p60，稳了再升级。
安装与首次连接 🚀
装：每个系统一行命令，各就各位。
# Linux（Flatpak，各发行版通用；官方包也有 deb/rpm/AppImage） flatpak install --user flathub dev.lizardbyte.app.Sunshine # macOS（Homebrew 源） brew tap LizardByte/homebrew && brew install sunshine # Docker（官方文档注明不推荐大多数用户使用） docker pull lizardbyte/sunshineWindows 从发布页下载Sunshine-Windows-AMD64-installer.msi双击安装即可。装 Linux 的 deb / rpm 包更省事，发行版有官方构建时优先用它们。
首次连接五步：
- 启动 Sunshine：Linux 跑
systemctl --user start app-dev.lizardbyte.app.Sunshine；Windows 装完即以服务常驻。 - 浏览器打开
https://localhost:47990管理界面，自签名证书报警告是常态，直接继续访问。 - 首登时按提示建管理员用户名和密码，记牢，这是管理端的钥匙。
- 在目标设备装 Moonlight 客户端，添加这台主机。
- 客户端弹出 PIN 请求时，回到 Web 界面导航栏的 PIN 页输入该码并给设备起名，提示成功即配完。
验收标准：目标屏 5 秒内出现主机画面；键盘、手柄按键都有即时响应；Moonlight 性能叠加层码率稳定不掉零。三条都过，算接通。
跑通之后还能做什么
- 整屏上桌（电视级桌面）：Sunshine 自带 Desktop 入口，不配置任何东西就能把整块桌面推到大屏，旁边还有 Steam 入口直接进大屏游戏模式。操作：Moonlight 应用列表选 Desktop → 开始串流 → 串流中按
Ctrl+Alt+Shift+N隐藏光标。坑：多显示器的主机默认串主屏，想换目标先在配置页选定显示器，不然可能把 4K 副屏串出去。 - 给每个游戏一个直达入口：常用游戏不用再翻桌面。操作：Web 界面 Applications 页 → Add New → 填应用名、启动命令（
cmd）和工作目录（cwd）→ 保存，Moonlight 里立即可见。命令里支持$(HOME)之类的变量。坑：被串流的应用一退出，串流跟着断，想常驻就把入口指到壳程序而不是游戏本体。 - 出门在外连回家里：操作：配置页搜
upnp，把默认disabled改成enabled，路由器自动映射端口（串流走47989，管理端47990）；Moonlight 里手动填主机公网 IP。坑：远程对上行带宽敏感，先降分辨率和码率再试。 - 管住管理端访问范围：
origin_web_ui_allowed默认lan，管理界面只对局域网开放，外网想管得另做端口转发并配强密码。坑：别为了省事把它放开到公网。
出了问题怎么办
| 症状 | 最可能的原因 | 处理办法 |
|---|---|---|
| Moonlight 找不到主机 | 不同网段或防火墙挡了 | 确认同一局域网并放行端口，或手动填 IP 添加 |
| Web 界面打不开 | 用了http或端口被占 | 用https://localhost:47990，检查防火墙 |
| 日志里编码器报错 | 显卡驱动缺或编码不支持 | 更新驱动，对照 README 编码兼容表核对自己 GPU |
| 卡顿、掉帧 | 带宽不够或码率拉太高 | 先降分辨率/码率，再按 性能调优 微调 |
| 键盘、手柄没反应 | 输入权限或驱动缺失 | Linux 把用户加进input组后重启；Windows 装 Virtual HID Driver 后重启 |
| 忘了 Web 登录密码 | 凭据丢失 | 命令行跑sunshine --creds 新用户名 新密码重置 |
日志默认在~/.config/sunshine/sunshine.log（Linux）或%ProgramFiles%\Sunshine\config\sunshine.log（Windows），可用配置项log_path改位置；sunshine --help列出全部启动参数。
动手清单
- 按系统装好 Sunshine
- 打开
https://localhost:47990建好管理员账号 - Moonlight 里完成 PIN 配对
- 用内置 Desktop 串一次桌面，核对画面和输入
- 添加至少一个自定义游戏入口
- 按排查表处理一次实际故障
- （进阶）启用 UPnP 解锁远程串流
官方文档：
- 安装指南：各平台安装包与首次启动细节
- 配置参考：每个配置项的默认值与可选值
- 性能调优：码率、分辨率、编码器怎么选
- 故障排查：分平台的疑难问题手册
- 构建指南：从源码编译的开发者入口
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
