Sunshine 游戏串流服务器入门指南：安装、首配与跨设备串流
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 
项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一个开源自托管游戏串流服务器，作为 Moonlight 的主机端，把 Windows、Linux 或 macOS 电脑上的游戏画面实时编码后，串流到手机、平板、电视等任意 Moonlight 设备。它支持 AMD、Intel、NVIDIA 硬件编码，也提供软件编码兜底，整个配置都在浏览器里完成，数据和游戏库始终留在你自己的机器上。
一、先用 30 秒判断它适不适合你
如果你有一台能跑游戏的电脑，想在家里电视、卧室或旅途中用另一台设备继续玩它，Sunshine 就是为此准备的。它把电脑变成串流主机，画面走局域网或宽带，串流本身不收费，存档也不会被传到别人的服务器。
开始之前，先确认这几件事：
- 显卡：NVIDIA 需带 NVENC 的卡，AMD 需 VCE 1.0+，Intel 在 Linux 上走 VAAPI、Windows 上需 Skylake 及更新；没有硬编也能用软件编码，只是更吃 CPU。
- 系统：Windows 11+、macOS 14.2+（实验性）、或主流 Linux 发行版（Ubuntu 22.04+、Fedora 43+ 等）。
- 内存：至少 4GB。
- 网络：主机和客户端都尽量用 5GHz 无线或有线；4K 与 HDR 场景官方建议以太网。
- 控制器：Windows 上要额外装 Virtual HID Driver，macOS 目前不支持手柄。
二、把 Sunshine 装好
官方推荐直接用发布页提供的二进制包，各平台都有。以下以最简单的 Windows 为例。
其他平台各有对应的包，按包名安装即可：
- Debian / Ubuntu：sunshine-{distro}-{version}-{arch}.deb，用 dpkg -i 安装
- Arch：sunshine，用 pacman -S 安装
- Fedora：copr 源 lizardbyte/stable 里的 Sunshine 包
- macOS：Sunshine-macOS-arm64.dmg（Apple 芯片）或 Sunshine-macOS-x86_64.dmg（Intel），拖进「应用程序」
三、跑通第一次使用
目标是用最短的路径，把一条串流链路从零跑到通。
四、参数只调这几个
Sunshine 用默认配置就能工作，多数人不用碰参数。真要调，先盯住这四个，都能在配置页的搜索框里直接找到。
| port | 47989 | 串流端口族，被占用或与其他服务冲突时改；改它会让其余端口一起偏移 |
| max_bitrate | 0 | 编码比特率上限（Kbps），0 表示完全跟随 Moonlight 的请求值；网络不稳时给个上限 |
| encoder | 首个可用编码器 | 强制指定编码器，如 nvenc、quicksync、vaapi；默认自动挑第一个能用的 |
| gamepad | auto | 主机侧模拟的手柄类型，客户端手柄不工作时可手动锁定为 x360、ds4 等 |
原则是先让默认跑通，再针对具体症状一次只改一个变量。比特率、编码器、手柄类型是三类最常见的调优点，其余参数保持默认即可。
五、让其他设备接进来
客户端统一用 Moonlight，Sunshine 只负责主机侧。
- PC（Windows / macOS / Linux）：装 Moonlight 桌面端，局域网内会自动发现主机。
- 手机 / 平板（Android / iOS）：应用商店搜 Moonlight 安装，确保和主机在同一网段。
- 电视 / 盒子 / 树莓派：装对应平台的 Moonlight 或 Moonlight Embedded，接 HDMI 输出。
配对流程是统一的：主机侧在 Web 界面 PIN 页输入客户端显示的 PIN 并给设备命名，客户端侧选择应用开始串流。之后设备会留在这台主机里，下次直接连。
六、卡住了先看这里
- 客户端发现不到主机：先确认两台设备同网段、防火墙放行、Sunshine 服务在运行；都不行就手动填主机 IP。
- 手柄没反应：Windows 装好 Virtual HID Driver；Linux 上把运行 Sunshine 的用户加入 input 组。
- 画面卡或延迟高：降到有线或 5GHz、把 max_bitrate 限低一档、确认在用硬件编码。
- 键位不对：Windows 可在配置里切换 always_send_scancodes，非美式键盘布局常有此问题。
- 忘了管理员密码：走命令行重置凭证，或翻日志定位。
遇到异常，先翻 Web 界面 Troubleshooting 标签页的日志，逐条读警告和错误信息，多数问题在那里就有线索。
七、想继续深入
- docs/getting_started.md：各平台安装细节与启动方式，装的时候对照着看。
- docs/configuration.md：全部配置项的默认值与说明，调参时当字典查。
- docs/performance_tuning.md：分硬件的调优建议，追求低延迟和 4K/HDR 时再看。
Sunshine 的价值在于把串流这件事收进自己手里：主机是现成的电脑，客户端遍布各类设备，中间不经过第三方。先把局域网这条链路跑顺，再按你的带宽和显卡能力逐步上调分辨率与帧率，比一上来就奔 4K 更省时间。
【免费下载链接】Sunshine Self-hosted game stream host for Moonlight. 项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
