Sunshine + Moonlight 游戏串流实战指南：把 PC 游戏免费投到电视
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
Sunshine 是一个自托管的 PC 游戏串流服务器，搭配 Moonlight 客户端使用：主机端把画面和声音压缩后，直接走局域网推给电视、手机或平板，你的按键和手柄操作再反向传回主机执行。整条链路不经过任何云中转，也没有月费——这是它相比云游戏最硬的一条优势。本指南按"装好→出画面→排障→调优"的顺序，带你跑通全流程。
安装前先自检环境
这一节解决"我的机器到底能不能跑"，装完才发现平台不支持会白忙一场。
Sunshine 对平台的实际支持范围：
| 平台 | 版本要求 | 画面捕获方式 | 可用硬件编码器 |
|---|---|---|---|
| Windows 11+ | 完全支持 | DXGI 桌面复制 | NVENC、AMF、QuickSync |
| Linux | Ubuntu 22.04+ / Debian 13+ / Fedora 43+ | X11、Wayland、KMS（内核态直接抓显示输出） | NVENC、AMF、QuickSync、VA-API、Vulkan |
| macOS | 14.2+（实验性） | ScreenCaptureKit | VideoToolbox |
| FreeBSD | 15.1+ | KMS/DRM、X11 | VAAPI |
两个坑提前说：⚠️ macOS 版仍是实验阶段，虚拟手柄不可用——想用手柄串游戏就把主机放 Windows 或 Linux 上；AppImage 和 Flatpak 包不支持 KMS 捕获，能装发行版包就优先装包。
网络方面，主机和接收端必须在同一局域网；无线环境官方基线是 5GHz 802.11ac 起步，低于这个规格后面调优容易撞天花板。
三个平台把服务器跑起来
这一节的目标是把 Sunshine 服务拉到"active（运行中）"状态，每个平台各走各的最短路径。
Windows
- 到项目发布页下载
Sunshine-Windows-AMD64-installer.msi，双击安装（ARM 机器下 ARM64 版）。 - 装完 Sunshine 以系统服务身份后台常驻，浏览器会自动弹出配置页，地址是
https://localhost:47990。 - 页面提示"不安全"是正常的——本地自签证书而已，点继续访问。
✅ 阶段验证：浏览器里能看到账号创建页，说明服务已经跑起来了。
Linux
有发行版包就直接装：
sudo apt update sudo apt install sunshineFedora 换sudo dnf install Sunshine，openSUSE 换sudo zypper install Sunshine。没有现成包时，从发布页下载对应架构的 AppImage 放到主目录，执行./Sunshine_{version}_{arch}.AppImage --install。
然后用用户级 systemd 服务拉起并设为开机自启：
systemctl --user enable --now app-dev.lizardbyte.app.Sunshine✅ 阶段验证：systemctl --user status无报错、状态显示 active，就可以进下一步了。
macOS
brew tap LizardByte/homebrew brew install sunshine首次启动会弹系统授权框，"屏幕录制"和"麦克风"两项都允许掉。⚠️ 再次提醒：此版本虚拟手柄不可用，串桌面和串应用没问题。
网页建账号与 Moonlight 配对四步出画面
这一节解决"从打开网页到电视上真正出画面"的完整链路。先用浏览器访问https://localhost:47990；想用别的设备操作，把 localhost 换成主机的内网 IP，自签证书的警告直接忽略。
- 建管理员账号：首次访问要求填用户名和密码，这是之后登录网页、完成设备配对的唯一凭证，记牢它。
- 认识应用列表：默认有一条 Desktop 记录，选它串的就是整个桌面；想单独串某个游戏，点添加，填名称和启动命令，保存后与 Desktop 并列出现。
✅ 阶段验证：登录后能看到 Desktop 应用卡片，账号环节完成。
接下来是 Moonlight 配对，顺序别搞反：
- 在电视盒子、手机或平板上装好 Moonlight（各平台均有官方客户端），确保与主机同局域网，客户端会自动扫描到主机；
- Moonlight 发起配对请求，屏幕弹出PIN 码；
- 回到网页版，点导航栏的 "PIN" 页，输入 PIN 码，顺手给设备起个名字，保存；
- 回到 Moonlight 选 Desktop，点开始串流。
✅ 阶段验证：电视上出画面，且在客户端按键盘、动鼠标，主机端有对应反应——游戏串流链路已全通。
出画面不顺时怎么办
这一节是最常见故障的对照表，先查表再动手，别上来就重启服务。
| 现象 | 多半是哪里的问题 | 处理动作 |
|---|---|---|
| 客户端搜不到主机 | 防火墙拦了 47990 等端口，或两端不同网段 | 放行 Sunshine 相关端口，确认同网段后重启服务再试 |
| 画面卡顿、帧率上不去 | 带宽不足，或码率超出网络承载 | 主机换有线或 5GHz WiFi；降一档分辨率/帧率；回调max_bitrate |
| Linux 下键鼠手柄无响应 | 运行用户不在input组，虚拟输入设备建不出来 | 执行sudo usermod -aG input $USER，注销重新登录后生效 |
| macOS 手柄配置无效 | 实验性版本暂不支持虚拟手柄 | 手柄场景换 Windows/Linux 主机 |
表里覆盖不到的，打开网页版 Troubleshooting 标签——它汇总了全部运行日志，逐条点开警告按提示修：
画质调优：编码器、码率与 4K 门槛
这一节解决"画面发糊"和"想冲 4K 60fps"两类游戏串流调优需求。
编码器没选对→ 在配置页搜索框输入encoder立刻过滤出对应项。默认行为是自动选第一个可用编码器，手动锁定更稳：N 卡设nvenc，AMD 设amdvce，Intel 核显设quicksync。
画面发糊→ 主因是码率偏低。搜max_bitrate，单位 Kbps，按家里带宽往上加，配置文档里的示例写法是max_bitrate = 5000。
想冲 4K 60fps→ 主机和客户端都要过这条硬件线：
| 部件 | 最低要求 |
|---|---|
| 显卡 | NVIDIA GTX 1080+ / AMD VCE 3.1+ / Intel HD 510+ |
| CPU | AMD Ryzen 5 或 Intel Core i5+ |
| 网络 | CAT5e 有线及以上（两端一致） |
另外：想串 HDR，先在主机系统里开启 HDR，客户端侧同步打开 HDR 选项。
下一步与资料索引
- 快捷键与多显示器切换：docs/getting_started.md
- 完整配置参数清单：docs/configuration.md
- 编码器细节与系统级优化（如 N 卡 Fast Sync）：docs/performance_tuning.md
- 排障参考：docs/troubleshooting.md
- 重装系统前先备份配置目录：Linux / macOS / FreeBSD 在
~/.config/sunshine/，Windows 在%LOCALAPPDATA%\LizardByte\Sunshine，整个目录拷走，恢复时拷回原位即可。
【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
