如何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 分钟确认你的硬件是否达标：

💡 判断技巧：只要你的显卡支持硬件视频编码（H.264/HEVC/AV1），就能流畅串流 1080p 60fps 以上。

最快部署方法：Windows 一键安装（约3分钟）📦

这是绝大多数用户的最优路径：

1. 从项目的最新 Release 页面下载Windows 安装器（sunshine-windows-installer.exe）
2. 双击运行，按需勾选组件（不建议盲目全选，比如虚拟显示器驱动按需安装）
3. 安装程序会自动完成防火墙规则、服务注册等工作
4. 安装完成后 Sunshine 以服务形式在后台运行，系统托盘会出现状态图标

图：系统托盘中的 Sunshine 状态图标，绿色播放键表示正在串流

⚠️ 官方并不推荐"便携版解压即用"的方式——性能会有损失且需要手动配置防火墙与服务，新手请直接使用安装器。

其他系统安装：Linux 与 macOS 快速方法 🐧🍎

Debian / Ubuntu：下载对应发行版的.deb包后执行：

sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb

Linux 串流必做的一步（开启 KMS 采集，Wayland 桌面必需）：

sudo setcap cap_sys_admin+p $(readlink -f $(which sunshine))

然后启动并设置开机自启：

systemctl --user enable --now sunshine

macOS：通过 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 控制面板完成，这是新手最容易上手的地方：

1. 浏览器打开https://localhost:47990（浏览器提示"不安全"属正常现象，是因为自签名证书，直接继续即可）
2. 首次进入会让你创建用户名和密码，请务必记牢
3. 在Apps页面添加应用，比如：
   • 名称：Steam
   • 启动命令：C:\Program Files (x86)\Steam\steam.exe
   • 选择一张封面图即可
4. 在Encoder页面选择编码器（N 卡选 NVENC，A 卡选 AMF），普通家用选默认"平衡"档位即可

图：开启 HDR 串流后，高光场景（如逆光、天空）会保留更多细节

连接Moonlight客户端：4步发起第一次串流 🌙

1. 在电视/手机/电脑上安装Moonlight客户端
2. 客户端会自动发现局域网内的 Sunshine 主机；若没发现，可手动输入主机 IP
3. 点击主机时 Moonlight 会要求输入PIN 码：回到 Sunshine 的 Web 面板，在导航栏的PIN页面输入客户端显示的 PIN 确认配对
4. 选择应用（比如刚才添加的 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个高频问题速查 🛠️

更多疑难杂症可查阅 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