企业官网建设流程全解析

Sunshine 游戏串流服务器搭建指南：从安装到 Moonlight 配对实操

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine

想把电脑里的游戏串流到客厅电视或手机上，却担心画质模糊、操作卡顿？Sunshine 就是为此设计的：一款为 Moonlight 客户端准备的自托管游戏串流服务器。它跑在你的主机上，用显卡硬件编码把画面压缩推流给客户端，并提供网页界面完成配置和设备配对，支持 Windows、Linux、macOS 和 FreeBSD。

🎮 它能干什么

一句话定义：Sunshine 是主机端的串流服务器，负责抓屏、编码、推流和接收输入，客户端端由 Moonlight 负责解码和呈现。

核心能力：

• 硬件编码：按 GPU 选用 NVENC（NVIDIA）、AMF（AMD）、QuickSync（Intel）、VAAPI、Video Toolbox（Apple）或 Vulkan Video，软件编码兜底
• 多平台屏幕捕获：Windows 用 DXGI 桌面复制，Linux 支持 X11、Wayland（wlroots）、KMS/DRM、NvFBC、XDG Portal 等多种方式
• 网页端配置：浏览器打开https://localhost:47990即可设置主题、应用、编码参数和设备配对
• 虚拟手柄注入：在主机侧模拟 Xbox 360/One/Series、DualShock/DS5、Switch Pro 等手柄，Linux 和 Windows 支持最全
• HDR 串流：Windows 主机正式支持，Linux 主机实验性支持

🧭 适合谁用

• 客厅电视玩家：家里有一台游戏 PC 和大屏，想零延迟感地把 Steam 库搬上电视，串流到电视或投影比买游戏机更灵活
• 出门在外的玩家：手机、平板装一个 Moonlight 客户端，回家局域网直连，出门走远程网络也能接着玩
• 无显示器主机：把一台闲置显卡主机当"串流盒子"，不接显示器也能通过 KMS 捕获或虚拟显示推流（Linux 平台方案见 docs/getting_started.md）

🚀 三步跑起来

第一步：安装。Windows 用官方 MSI 安装程序（推荐），或 winget 直接装：

winget install LizardByte.Sunshine

Debian/Ubuntu 先添加官方源，再执行：

sudo apt update && sudo apt install sunshine

第二步：启动服务。Windows 安装器默认装成系统服务，开机自启；Linux 上启用用户服务：

systemctl --user --now enable app-dev.lizardbyte.app.Sunshine

第三步：初始化网页端。浏览器访问https://localhost:47990，首次会让你设置用户名和密码（浏览器提示"不安全"是因为自签名证书，忽略即可）。设置好之后，添加应用、配对设备都在这个界面里完成。

⚙️ 核心功能实操

添加游戏与应用

能做什么：把任意可执行命令注册成"应用"，客户端点一下就能拉起并串流。

怎么用：在 Applications 页面点击添加应用，填应用名、启动命令和工作目录。比如串流 Steam 大画面模式，命令写steam://open/bigpicture；常见应用的命令模板可以参考 docs/app_examples.md。内置的 "Desktop" 条目不带命令，点它就直接串流整个桌面。

效果如何：客户端的应用列表与主机同步，选中即启动游戏并推流；应用退出时串流自动断开，新应用启动前会终止上一个应用。

网页端配置与搜索

能做什么：编码器、分辨率、码率、音频、网络等全部配置项都在浏览器里，不需要手写配置文件。

怎么用：配置页顶部有搜索框，输入关键字（如 encoder）直接定位到对应选项，选择硬件编码器后保存即可。配置文件默认在~/.config/sunshine（Linux/macOS）或%ProgramFiles%\Sunshine\config（Windows），全部选项说明见 docs/configuration.md。

效果如何：改完即生效，选对编码器是串流体验的关键。各平台可用的硬件编码器对照：

与 Moonlight 客户端配对

能做什么：让任意设备（电视盒子、手机、电脑）安全地连接到你的串流服务器。

怎么用：在 Moonlight 客户端里发现或手动添加主机；客户端提示输入 PIN 时，登录网页端导航栏的 "PIN" 页面，填入 PIN 并为设备起个名字。Moonlight 各平台客户端的下载入口就在网页端的 Featured Apps 页签。

效果如何：配对成功后客户端即可选择应用开始串流；后续连接走同一套凭据，不用再重复输入 PIN。

🔧 调优与避坑

两条官方调优建议：NVIDIA 用户在控制面板开启 Fast Sync、AMD 用户开启 Enhanced Sync（Windows），都能再省一点延迟（见 docs/performance_tuning.md）。另外，串流对网络稳定性比带宽更敏感，可以用 iPerf3 实测：丢包低于 5%、抖动低于 1ms 才算健康。

常见问题：

1. 忘了网页端账号密码：终端执行sunshine --creds 新用户名 新密码重置。
2. Linux 上键盘鼠标手柄没反应：把运行 Sunshine 的用户加入 input 组，注销后重新登录：sudo usermod -aG input $USER。
3. NVIDIA 显卡 KMS 捕获黑屏：给内核参数加上nvidia_drm.modeset=1后重启。

排查问题优先看网页端 Troubleshooting 页签，每条告警都带日志线索：

📚 继续学习

• docs/getting_started.md：各平台安装方式与初始配置全流程
• docs/configuration.md：全部配置项参考（含编码器选项）
• docs/troubleshooting.md：按平台分类的故障排查
• docs/app_examples.md：Steam、Epic 等应用的命令示例
• src/platform/：各平台捕获与编码实现；src/nvenc/：NVENC 编码器集成

写在最后

Sunshine 把任意一台带显卡的 PC 变成家庭游戏串流服务器，配置、配对、排查都在一个网页里完成。现在就装上它，打开https://localhost:47990，把游戏库串到最大那块屏上。

【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine