Sunshine 游戏串流从 0 到成功:装好、配对、调优全流程
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一个开源的自托管游戏串流服务器,装在自己的 PC 上后,就能通过 Moonlight 客户端把整个桌面和游戏画面串流到电视、手机等设备。数据全程走自己的局域网,不经过任何云服务,画质上限由你显卡的硬件编码器决定。本文按"装好 → 配对 → 管理 → 调优"的顺序,把从安装到串流顺畅的完整路径走一遍。
各平台安装 Sunshine 并启动服务
这一节解决"怎么让 Sunshine 先跑起来"的问题。
- Windows:从官方发布页下载 AMD64 版 MSI 安装包,双击运行,按向导走即可。安装过程中按需勾选可选项。装完后 Sunshine 以 Windows 服务在后台运行,任务栏托盘有图标。
- Linux(Debian/Ubuntu):
sudo dpkg -i ./sunshine-*.deb,Fedora 用 rpm 包,发行版没有原生包时选 Flatpak。装完执行systemctl --user --now enable app-dev.lizardbyte.app.Sunshine启用并启动用户级服务。 - macOS:下载 DMG 把应用拖入"应用程序",或
brew install sunshine。该版本目前是实验性质,暂不支持手柄输入,重度使用建议先观望。
服务起来后会自动生成配置,位置记一下:Windows 在%ProgramFiles%\Sunshine\config,Linux 和 macOS 在~/.config/sunshine,后面的日志查看和密码重置都以这个目录为基准。
🎮 配对 Moonlight 客户端,拿到第一次串流画面
这一节解决"怎么第一次把 PC 画面投到电视上",全程 3 分钟以内。
- 在电视、手机或平板上安装 Moonlight 客户端,各平台都有,名字就叫 Moonlight。
- 客户端通常会直接发现局域网内的 Sunshine,点添加即可;发现不到时手动输入 Sunshine 主机的 IP 添加。
- 发起配对后 Moonlight 会弹出一个 6 位 PIN 码。此时在 PC 浏览器打开
https://localhost:47990,首次访问会要求你创建登录账户(浏览器提示"不安全"是因为自签名证书,忽略即可)。账户建好后点导航栏的 PIN,输入同一串 6 位数字并给设备起个名字。 - 配对完成后,客户端列表里会出现 Sunshine 自带的 Desktop 应用,点它就能把整个桌面串出来,先拿它验证链路没问题。
串流过程中所有快捷键都以Ctrl+Alt+Shift开头,比如Ctrl+Alt+Shift+F1到F12用于切换串流哪块显示器。
连上之后,把 Web 界面初始化做完:主题、语言与报错检查
这一节解决"连上之后还有哪些值得顺手改的设置"。Web 界面是 Sunshine 的控制中心,三个位置值得过一遍:
- 导航栏下拉菜单:选择界面主题和语言,深色主题适合夜间串流。
- Featured Apps 标签页:能看到各平台的 Moonlight 客户端入口,之后想添设备时直接从这里拿。
- Troubleshooting 标签页:扫一遍确认没有红色错误项;有红色项就先记下涉及的编码器和驱动,后面排障会用到。
把游戏加进串流列表:从桌面到 Steam 大屏模式
这一节解决"Moonlight 里那些入口是哪来的"。客户端看到的每一个入口,都对应 Web 界面 Applications 标签页里的一条记录,常见三类:
- 桌面模式:默认的 Desktop 应用不需要任何命令,选中即串流桌面,适合远程办公或多任务。误删了也没关系,新建一个名为 Desktop 的应用即可恢复。
- Steam 大屏模式:命令填
steam://open/bigpicture,类型选分离式(Detached),避免 Steam 主进程退出时串流跟着中断;Linux 上可以写成setsid steam steam://open/bigpicture更稳。 - 自定义游戏:填启动命令、工作目录、显示名称和图标四样东西,命令支持环境变量,例如用
$(HOME)代表用户主目录。
更多现成的命令写法可以参考 docs/app_examples.md。
按显卡选编码器,再调网络,让串流更顺
这一节解决"为什么卡、怎么调"。画面由显卡上的硬件编码器实时压成视频,选型跟着显卡厂商走:
| 显卡 | 推荐编码器 | 说明 |
|---|---|---|
| NVIDIA | NVENC | 延迟与画质最均衡,首选 |
| AMD | AMF(Windows)或 VAAPI | 平衡模式表现较好 |
| Intel | QuickSync | 核显上性能优先 |
| 老显卡不支持硬编 | 软件编码 | 吃 CPU,建议同时降分辨率 |
网络方面,串流对稳定性比对峰值带宽更敏感:主机端尽量走千兆有线,客户端优先 5GHz WiFi,官方建议最低 802.11ac。画面卡就先降参数——在 Web 搜索栏输入bitrate就能直接找到码率和分辨率相关项;延迟偏高可以省一帧:NVIDIA 用户在驱动里开 Fast Sync,AMD 用户开 Enhanced Sync。
出问题时,用排障页和日志快速定位
这一节解决"卡住了该往哪看"。排查入口有两个:Web 界面的 Troubleshooting 标签页(可在线逐条展开日志),以及配置目录下的sunshine.log文件。忘了 Web 登录密码时,命令行执行sunshine --creds 新用户名 新密码重置(Flatpak 安装需用flatpak run --command=sunshine dev.lizardbyte.app.Sunshine包裹执行)。高频问题对照着查:
| 现象 | 常见原因 | 处理动作 |
|---|---|---|
| 打不开 47990 网页 | 防火墙拦截 | 放行 47990 端口或加例外规则 |
| 配对失败 | PIN 没及时输入 | 从网页 PIN 入口输 6 位码并命名设备 |
| 手柄无响应 | 驱动或权限缺失 | Windows 装 Virtual HID 驱动;Linux 把用户加入input组 |
| 掉帧严重 | 网络不稳定 | 改有线,或降低分辨率与码率 |
| 编码器报错 | 显卡驱动过旧 | 更新驱动后重启 Sunshine |
更细的配置项见 docs/configuration.md,完整的故障排查指南见 docs/troubleshooting.md。
长期用下去要留意的几件事
串流跑通只是开始,日常维护记住下面几条就够:
- 有线比无线稳,客户端 5GHz 优先,无线环境先测信号强度再怀疑软件。
- 编码器跟显卡厂商选;驱动报旧时先更新驱动,再怀疑串流本身。
- 码率跟带宽走,拿不准就往下调,宁低勿卡。
- 出问题的固定动作:先看 Troubleshooting 标签页,再翻
sunshine.log,对照上面的速查表定位。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考