如何10分钟快速部署Sunshine：从零开始的游戏串流完整指南
如何10分钟快速部署Sunshine：从零开始的游戏串流完整指南
【免费下载链接】foundation-sunshineSunshine fork: an enhanced sunshine, a self-hosted game streaming host for Moonlight with HDR10/HDR Vivid, virtual displays, advanced audio, optimized encoders, and a modern control panel.项目地址: https://gitcode.com/gh_mirrors/sunshine5/foundation-sunshine
Sunshine 是一个开源的自托管游戏串流主机（Game Streaming Host），部署后搭配 Moonlight 客户端，就能把 PC 上的游戏画面低延迟串流到手机、电视或另一台电脑上。这个增强版 Sunshine 还自带 HDR10/HDR Vivid 全链路、虚拟显示器、7.1.4 环绕声音频优化和现代化 Web 控制面板。本文将带你用最简单的方式，10 分钟从零完成 Sunshine 部署并发起第一次串流。
为什么选择Sunshine？游戏串流主机快速了解 🖥️
简单来说，游戏串流 =主机端（Sunshine）负责采集画面和编码，客户端（Moonlight）负责解码和显示。
- 低延迟：局域网内端到端延迟可低至 10ms 级别，操作手感接近本地
- 全平台：Windows、Linux、macOS 均可作为主机
- 免费开源：无需付费，配置一次长期使用
- 本增强版亮点：HDR 双格式编码（PQ + HLG）、虚拟显示器驱动、NVENC 13.0 / AMF 编码器优化、文件夹共享
核心特性说明见 README.md，更多部署细节可参考官方文档 docs/getting_started.md。
部署前准备：系统要求一键自查清单 ✅
开始之前，先花 1 分钟确认你的硬件是否达标：
| 组件 | 最低要求 | 4K 串流推荐 |
|---|---|---|
| 显卡 | AMD VCE / Intel VAAPI / 带 NVENC 的 NVIDIA 卡 | GTX 1080 及以上 |
| 处理器 | Ryzen 3 / Core i3 | Ryzen 5 / Core i5 |
| 内存 | 4 GB | 8 GB |
| 系统 | Windows 10 22H2+（虚拟显示器功能需要） | Windows 10 22H2+ |
| 网络 | 5GHz Wi-Fi（802.11ac） | 有线以太网 |
💡 判断技巧：只要你的显卡支持硬件视频编码（H.264/HEVC/AV1），就能流畅串流 1080p 60fps 以上。
最快部署方法：Windows 一键安装（约3分钟）📦
这是绝大多数用户的最优路径：
- 从项目的最新 Release 页面下载Windows 安装器（
sunshine-windows-installer.exe） - 双击运行，按需勾选组件（不建议盲目全选，比如虚拟显示器驱动按需安装）
- 安装程序会自动完成防火墙规则、服务注册等工作
- 安装完成后 Sunshine 以服务形式在后台运行，系统托盘会出现状态图标
图：系统托盘中的 Sunshine 状态图标，绿色播放键表示正在串流
⚠️ 官方并不推荐"便携版解压即用"的方式——性能会有损失且需要手动配置防火墙与服务，新手请直接使用安装器。
其他系统安装：Linux 与 macOS 快速方法 🐧🍎
Debian / Ubuntu：下载对应发行版的.deb包后执行：
sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.debLinux 串流必做的一步（开启 KMS 采集，Wayland 桌面必需）：
sudo setcap cap_sys_admin+p $(readlink -f $(which sunshine))然后启动并设置开机自启：
systemctl --user enable --now sunshinemacOS：通过 Homebrew 安装：
brew tap LizardByte/homebrew brew install sunshine首次启动时会请求屏幕录制与麦克风权限，记得全部允许。详细分支对照见 docs/getting_started.md。
进阶玩法：从源码编译你的Sunshine（可选）🔧
想体验最新特性或二次开发？整个构建基于 CMake（需 3.25+），核心配置逻辑在 src/config.cpp，Windows 显示采集实现在 src/platform/windows/ 目录。
git clone https://gitcode.com/gh_mirrors/sunshine5/Sunshine cd Sunshine cmake -B build -G Ninja -S . ninja -C build完整的依赖清单（CUDA、Boost、NVENC 等）和平台差异说明都在 docs/building.md 里，照着执行即可。
首次配置：Web控制面板与添加游戏应用 🎮
Sunshine 的配置全部在Web 控制面板完成，这是新手最容易上手的地方：
- 浏览器打开
https://localhost:47990（浏览器提示"不安全"属正常现象，是因为自签名证书，直接继续即可） - 首次进入会让你创建用户名和密码，请务必记牢
- 在Apps页面添加应用，比如：
- 名称：
Steam - 启动命令：
C:\Program Files (x86)\Steam\steam.exe - 选择一张封面图即可
- 名称：
- 在Encoder页面选择编码器（N 卡选 NVENC，A 卡选 AMF），普通家用选默认"平衡"档位即可
图：开启 HDR 串流后，高光场景（如逆光、天空）会保留更多细节
连接Moonlight客户端：4步发起第一次串流 🌙
- 在电视/手机/电脑上安装Moonlight客户端
- 客户端会自动发现局域网内的 Sunshine 主机；若没发现，可手动输入主机 IP
- 点击主机时 Moonlight 会要求输入PIN 码：回到 Sunshine 的 Web 面板，在导航栏的PIN页面输入客户端显示的 PIN 确认配对
- 选择应用（比如刚才添加的 Steam），点击Play，第一次连接需要接受自签名证书
图：主机端"Sunshine（阳光）"，客户端"Moonlight（月升）"，名字本身就是串流主从关系
增强版特色功能：HDR、虚拟显示器与音频 🎨
部署完成后，这些增强功能值得顺手体验：
- HDR 全链路：支持 HDR10/HDR Vivid 双格式，逐帧亮度分析（MaxCLL/MaxFALL），串流到 HDR 电视时色彩和亮度更准确。相关实现位于 src/hdr/ 目录，文档见 docs/vulkan_hdr_bridge.md
- 虚拟显示器：集成 ZakoVDD 驱动，无需接显示器即可串流，支持 5 种屏幕组合模式和 10-bit 色深，适合"无头游戏主机"玩法
- 7.1.4 环绕声：12 声道完整映射，配合 Opus DRED 抗丢包恢复，串流语音通话也不掉音，音频路由配置可参考 docs/images/discord_calls_04.png
- 文件夹共享：Windows 主机可在资源管理器右键直接共享目录给已配对设备
部署后常见问题：5个高频问题速查 🛠️
| 问题 | 快速解决方案 |
|---|---|
| Moonlight 找不到主机 | 确认主机防火墙放行、两台设备在同一网段，主机 IP 手动添加试试 |
| Linux 下 Wayland 采集失败 | 执行上文setcap命令开启 KMS 采集权限 |
| 浏览器打开 47990 报错 | 确认 Sunshine 服务在运行（托盘图标/systemctl --user status sunshine） |
| 串流有音画不同步/卡顿 | 优先换 5GHz Wi-Fi 或有线；编码器档位调低一档 |
| 4K 串流帧率不稳 | 关闭客户端里的 HDR 试 SDR；或改用 1080p + 高刷新率 |
更多疑难杂症可查阅 docs/troubleshooting.md，配置项全解释在 docs/configuration.md。
总结：你的串流之旅才刚刚开始 🚀
回顾一下这条10 分钟部署路线：下载安装器 → 后台服务就绪 → Web 面板添加游戏 → Moonlight 配对输入 PIN → 开玩。
部署完成只是起点：HDR 色调映射、虚拟显示器模式、编码器档位微调，都藏在 Web 控制面板里等你慢慢探索。祝串流愉快，游戏常胜！
【免费下载链接】foundation-sunshineSunshine fork: an enhanced sunshine, a self-hosted game streaming host for Moonlight with HDR10/HDR Vivid, virtual displays, advanced audio, optimized encoders, and a modern control panel.项目地址: https://gitcode.com/gh_mirrors/sunshine5/foundation-sunshine
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考