Sunshine 自托管游戏串流服务器部署指南：把闲置主机变成 Moonlight 串流中心-开发者社区

Sunshine 自托管游戏串流服务器部署指南：把闲置主机变成 Moonlight 串流中心

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

Sunshine 是一款免费开源的自托管游戏串流服务器，它把家里的游戏主机变成 Moonlight 的串流端，让你在电视、笔记本甚至手机上以低延迟玩到主机里的游戏。这篇教程带你从零完成安装、首次配置到跑通第一局串流，全程标注常见坑位。

先说结论

适合你：想把游戏主机游戏串到其他屏幕、且希望数据留在自己手里的人
耗时：Windows 约 10 分钟，Linux 约 15 分钟，macOS 约 5 分钟（功能有裁剪）
部署成功的标志：Moonlight 客户端里能看到你的主机，串出 Desktop（桌面）画面并能用键鼠操作
核心路径：装好 Sunshine → 打开 Web UI 建账号 → PIN 码配对客户端 → 串流验证

认识一下：它到底帮你干什么

先说场景，不说名词：

客厅里，电视接上月光（Moonlight，Sunshine 的官方配套客户端），书房主机的大作直接串过来，手柄一接就能玩
出差住酒店，轻薄本或手机上装个客户端，远程把家里主机拉起来打一局
远程办公时，它也能当低延迟远程桌面用，串的是整个系统桌面，不只是某个应用
全程没有第三方中转服务器，视频流直接在你客户端和主机之间传输，隐私和带宽都归自己

Web UI 的 Featured Apps 页面里，官方汇总了各平台的 Moonlight 客户端和配套工具，挑对应设备下载即可：

动手前自检

开始前，对照勾选一下：

主机系统：Windows / Linux / macOS / FreeBSD 之一，能流畅跑你想串的游戏
显卡：NVIDIA / AMD / Intel 独显优先，负责硬件编码；没有也行，软件编码兜底，但延迟和画质打折
网络：局域网内主机和客户端都走有线或 5GHz Wi-Fi 最稳
客户端设备一台：手机、平板、电视、另一台电脑均可，装好 Moonlight
Windows 用户：准备安装 Virtual HID Driver（虚拟手柄驱动，串手柄用）
Linux 用户：确认你的登录账号有桌面会话，且能执行 sudo

安装落地

Windows：官方 MSI 安装器

去发布页下载Sunshine-Windows-AMD64-installer.msi（ARM 设备选 ARM64 版），双击按向导安装。

这里有个坑：安装器会列出不少可选组件，官方明确提醒不要闭眼全勾，按需勾选，特别是手柄驱动相关项。装完重启一次，托盘区出现 Sunshine 图标即就绪。走这条路的原因：安装器会自动处理系统服务、防火墙规则，是官方推荐路径，最省心。

Linux：发行版原生包最稳

三条路里按你的发行版选一条，有对应发行版包就别碰 AppImage 或 Flatpak，它们不支持 KMS 采集（Linux 下 HDR 串流的硬性前提）：

Ubuntu / Debian：

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

dpkg -i安装本地 deb 包，文件名要替换成你实际下载的版本和架构。

Fedora 系：

sudo dnf copr enable lizardbyte/stable sudo dnf install Sunshine

第一条命令启用官方的 COPR 软件源，第二条从该源装包。注意包名Sunshine大小写敏感。

Arch 系：直接pacman -S sunshine，一句话搞定。

装完启动服务：

systemctl --user start app-dev.lizardbyte.app.Sunshine

这条命令按用户级服务方式启动 Sunshine，开机自启把start换成--now enable。

偏爱源码构建的话：git clone https://gitcode.com/GitHub_Trending/su/Sunshine，进入目录后执行./scripts/linux_build.sh。脚本负责依赖检查、CMake 配置与编译打包。这条路要完整工具链且耗时较长，普通用户没必要折腾。

macOS：Homebrew 两条命令

brew tap LizardByte/homebrew brew install sunshine

tap添加官方 Homebrew 源，install拉包安装。也可以下载 DMG 把Sunshine.app拖进 Applications。

诚实提醒：macOS 版目前是实验性质，手柄模拟暂不支持，而且首次启动会请求屏幕录制和麦克风权限，都要放行。主力机是 Windows 的话，优先把 Sunshine 装在那台。

首次配置三件事

第 1 件：创建 Web UI 账号

浏览器访问https://localhost:47990，进入欢迎页设置用户名和密码。

两个提醒：这套凭据只显示这一次，先抄到备忘录里；浏览器报"网站不安全"是因为自签名证书，属正常现象，忽略即可。这步为什么必须做：之后所有配置、配对、排障都从这个界面进，它是唯一入口。

第 2 件：把 Moonlight 客户端配对进来

在 Moonlight 里手动输入主机 IP 添加设备，客户端会弹出一串 PIN 码。回到 Web UI 顶栏的 PIN 入口，输入数字、给设备起个名，回车出现 Success 即完成。

这一步建立的是主机和客户端之间的信任关系，之后每次串流都基于它做校验，省去了反复授权。

第 3 件：按显卡选编码器，顺手开 UPnP

Configuration 页顶部搜索框支持关键字检索，搜encoder：NVIDIA 选nvenc，Intel 选quicksync，AMD 选amdvce，Linux 下 Intel/AMD 也可选vaapi，兜底用software（CPU 编码）。这里有个坑：编码器选错不是性能差的问题，而是直接编码失败或 CPU 满载，按显卡对号入座即可。

搜upnp并设为 enabled，Sunshine 会自动在路由器上开端口转发，公网串流（在家以外连回来）就靠它。路由器不支持 UPnP 时，手动端口转发，具体端口清单以官方文档为准。

另外在 Applications 页可以管理串流应用：默认已有 Desktop 和 Steam Big Picture，点 Add New 填名称和可执行路径即可添加任意程序。改完记得在 Moonlight 里重进一次，应用列表只在客户端重连后刷新，不然看不到新加的。

跑通与调优

最小验证动作：Moonlight 里选中 Desktop 应用开始串流。主机桌面实时出现在客户端屏幕上，键鼠可正常操作——到这里部署就算跑通了。

进阶玩法，按需解锁：

画质上限：局域网千兆网络下，把max_bitrate（单位 Kbps）调高，画面细节更好；Wi-Fi 环境先保守一点
多显示器切换：串流中按Ctrl+Alt+Shift+F1~F12切换采集的显示器；Ctrl+Alt+Shift+N隐藏/显示鼠标
HDR 串流：主机和客户端都要开 HDR，Windows 端体验最完整；Linux 端是实验性支持，且采集后端必须是 KMS
无人值守机房：Linux + X11 场景可通过 SSH 远程拉起 Sunshine，配合 HDMI 诱骗器当 7x24 串流服务器

踩坑急救箱

症状：忘了 Web UI 的账号密码，进不去界面原因：凭据只在首次创建时显示一次处置：终端执行sunshine --creds 新用户名新密码重置（AppImage 用./sunshine.AppImage --creds ...）

症状：串流画面正常，但键鼠/手柄没反应原因：Linux/FreeBSD 下大多是权限问题，运行账号没有虚拟输入设备的权限处置：执行sudo usermod -aG input $USER把当前用户加入 input 组，然后注销重登；Windows 则确认 Virtual HID Driver 已安装且版本达标

症状：浏览器打不开https://localhost:47990原因：进程没跑，或防火墙拦了 Web UI 端口处置：先确认 Sunshine 服务在运行，再检查防火墙放行情况；仍不行看 Troubleshooting 页日志

症状：画面卡顿、丢包严重原因：常见是网络不稳，或主机网卡速度远高于客户端那一端的链路（比如主机 2.5G、客户端只有百兆），中间设备缓冲溢出处置：客户端改用有线/5GHz；调低max_bitrate；必要时把主机网卡降速到与客户端匹配（如 2.5G 降到 1G）

症状：Linux 下 KMS 采集失败原因：AppImage / Flatpak 这类沙箱化安装没有 KMS 所需的高级权限处置：换用发行版原生包重装；若追求 KMS 采集体验，通用包直接放弃

症状：手柄在 Steam 里能用，进游戏没反应原因：Steam 的手柄支持配置抢占了识别，或主机上直连了太多实体手柄处置：在 Steam 设置里只保留 Generic 手柄支持；有条件时禁用主机上的实体手柄，让 Sunshine 注入的虚拟手柄成为"第一个"

以上排不掉时，别盲猜：Web UI 的 Troubleshooting 页把警告和错误逐条列了出来，显卡型号、内存占用都有，照着报错定位比重启十遍快。