Sunshine 完整指南：如何把 PC 游戏串到电视、平板和手机
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
想在客厅电视、平板或手机上直接玩 PC 游戏，Sunshine 是一个自托管的游戏串流服务器，装在你自己的电脑上负责采集画面、编码视频，再推送到 Moonlight 客户端播放，免费且无订阅费。主机端支持 Windows、Linux 和 macOS（实验性），客户端则是 Moonlight 生态的各端播放器。下面按"装好主机 → 建账户 → 配对 → 调参"的顺序走一遍，不需要任何串流背景。
动手前，确认这三样东西
| 项目 | 要求 | 说明 |
|---|---|---|
| 主机显卡 | 带硬件编码：NVENC（NVIDIA 显卡自带的硬件编码器）、AMD 的 AMF 或 Intel 核显的 QuickSync | 编码压力交给 GPU，CPU 几乎不占；三样都没有时会退回 x264/x265 软件编码，延迟和画质都会打折 |
| 客户端设备 | 能装 Moonlight 的电视、平板、手机、树莓派等 | Moonlight 是免费的播放端，负责解码画面并把手柄、键鼠操作回传给主机 |
| 网络 | 客户端与主机在同一网段，千兆有线或 5GHz Wi-Fi 体验最佳 | 外网访问之后再说，先把局域网跑通 |
三个系统，一次把主机跑起来
无论哪个系统，都在做同样四件事：装软件、起服务、设开机自启、打开管理页。差别只在第一步用什么包。
| 系统 | 安装方式 | 装完动作 | 注意事项 |
|---|---|---|---|
| Windows | 下载官方 MSI 安装包按向导装完（Intel/AMD 选 AMD64，ARM 选 ARM64） | 无，安装程序已注册后台服务并开机自启 | ARM64 属实验性，不含硬件加速 |
| Linux | 按发行版选 .deb、Arch 仓库或 rpm/Copr 包 | 用 systemd 用户服务启动并自启 | AppImage 和 Flatpak 不支持 KMS 采集 |
| macOS | 下载对应芯片的 DMG（Apple Silicon 选 arm64），拖进「应用程序」 | 首次启动授予屏幕录制与麦克风权限 | 实验性支持，暂不支持手柄 |
Debian/Ubuntu 安装与开机自启只需两条命令：
sudo dpkg -i ./sunshine-<distro>-<arch>.debsystemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 与 macOS 均无需额外命令：Windows 的服务随安装程序自动注册，macOS 只需在权限弹窗里点允许。服务跑起来后，浏览器访问https://localhost:47990能出页面，主机这一侧就算就绪。
从建账户到第一次串流（PIN 配对步骤）
- 浏览器打开
https://localhost:47990。提示证书不受信任是因为自签名证书，直接继续即可。 - 欢迎页要求设置用户名和密码。凭据只在页面上显示一次，关掉就再也看不到，当场抄到安全的地方。
- 添加一个串流条目：默认已自带 Desktop（直接串整个桌面）和 Steam Big Picture（进 Steam 库选游戏），不新建也能先用；想加自己的游戏就进 Applications 页填名称、可执行文件路径，工作目录和图标可选。
- 在 Moonlight 客户端添加主机：局域网内通常自动发现，找不到就手动输入主机 IP。
- Moonlight 会索要一个 PIN：登录 Web 界面，顶部导航点进「PIN」页，把当时显示的 PIN 输入客户端并给设备起个名字。PIN 会周期性更新，以配对那一刻显示的为准。
配对成功后，在 Moonlight 里点任意应用即可开始第一次串流。各平台启动命令与配对细节见 快速上手指南。
按网络环境选串流参数
| 网络环境 | 分辨率 / 帧率 | 建议比特率 |
|---|---|---|
| 千兆有线 | 1440p–4K，60–120fps | 20–50 Mbps |
| 5GHz 无线 | 1080p，60fps | 10–25 Mbps |
| 外网宽带 | 1080p，30–60fps | 5–15 Mbps |
编码器一律优先硬件方案（NVENC、AMF、QuickSync），延迟低、CPU 占用小，只有显卡太旧或过弱时才退回 x264/x265 软件编码。音频格式默认 Opus（低延迟、质量均衡），保持默认即可。端口默认占用 47984–47990 区间，其中 47990 是 Web 管理页；UPnP 端口转发默认关闭，想在路由器上自动开口时把upnp设为enabled就行。逐项解释见 完整配置手册。
出问题时，按这份清单自查
- 忘了管理员密码→ 命令行
sunshine --creds <新用户名> <新密码>重置凭据 - 客户端搜不到主机→ 确认同一网段；防火墙放行 47984–47990；确认 Sunshine 服务在运行；Moonlight 里手动填主机 IP
- 画面卡顿或延迟高→ 降分辨率或比特率；换硬件编码；关掉占带宽的程序；能插网线就别用 Wi-Fi
- 手柄不识别→ 确认 Sunshine 虚拟手柄在系统里排第一；Linux 把运行 Sunshine 的用户加入
input组；Windows 确认虚拟手柄驱动（VirtualHID 或 ViGEm）已装好 - 流起不来或行为异常→ 核对条目的可执行路径与启动方式；打开 Web 界面「Troubleshooting」页，逐条读告警日志
更多重置与日志分析命令见 故障排查手册。
下一步：进 Configuration 页按你所在网络微调分辨率和比特率，找到画面与延迟的平衡点；局域网稳定后再开 UPnP 试外网连接。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
