Sunshine 自托管游戏串流服务器部署指南把闲置主机变成 Moonlight 串流中心【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费开源的自托管游戏串流服务器它把家里的游戏主机变成 Moonlight 的串流端让你在电视、笔记本甚至手机上以低延迟玩到主机里的游戏。这篇教程带你从零完成安装、首次配置到跑通第一局串流全程标注常见坑位。先说结论适合你想把游戏主机游戏串到其他屏幕、且希望数据留在自己手里的人耗时Windows 约 10 分钟Linux 约 15 分钟macOS 约 5 分钟功能有裁剪部署成功的标志Moonlight 客户端里能看到你的主机串出 Desktop桌面画面并能用键鼠操作核心路径装好 Sunshine → 打开 Web UI 建账号 → PIN 码配对客户端 → 串流验证认识一下它到底帮你干什么先说场景不说名词客厅里电视接上月光MoonlightSunshine 的官方配套客户端书房主机的大作直接串过来手柄一接就能玩出差住酒店轻薄本或手机上装个客户端远程把家里主机拉起来打一局远程办公时它也能当低延迟远程桌面用串的是整个系统桌面不只是某个应用全程没有第三方中转服务器视频流直接在你客户端和主机之间传输隐私和带宽都归自己Web UI 的 Featured Apps 页面里官方汇总了各平台的 Moonlight 客户端和配套工具挑对应设备下载即可动手前自检开始前对照勾选一下主机系统Windows / Linux / macOS / FreeBSD 之一能流畅跑你想串的游戏显卡NVIDIA / AMD / Intel 独显优先负责硬件编码没有也行软件编码兜底但延迟和画质打折网络局域网内主机和客户端都走有线或 5GHz Wi-Fi 最稳客户端设备一台手机、平板、电视、另一台电脑均可装好 MoonlightWindows 用户准备安装 Virtual HID Driver虚拟手柄驱动串手柄用Linux 用户确认你的登录账号有桌面会话且能执行 sudo安装落地Windows官方 MSI 安装器去发布页下载Sunshine-Windows-AMD64-installer.msiARM 设备选 ARM64 版双击按向导安装。这里有个坑安装器会列出不少可选组件官方明确提醒不要闭眼全勾按需勾选特别是手柄驱动相关项。装完重启一次托盘区出现 Sunshine 图标即就绪。走这条路的原因安装器会自动处理系统服务、防火墙规则是官方推荐路径最省心。Linux发行版原生包最稳三条路里按你的发行版选一条有对应发行版包就别碰 AppImage 或 Flatpak它们不支持 KMS 采集Linux 下 HDR 串流的硬性前提Ubuntu / Debiansudo dpkg -i ./sunshine-ubuntu-24.04-amd64.debdpkg -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 配置与编译打包。这条路要完整工具链且耗时较长普通用户没必要折腾。macOSHomebrew 两条命令brew tap LizardByte/homebrew brew install sunshinetap添加官方 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 件按显卡选编码器顺手开 UPnPConfiguration 页顶部搜索框支持关键字检索搜encoderNVIDIA 选nvencIntel 选quicksyncAMD 选amdvceLinux 下 Intel/AMD 也可选vaapi兜底用softwareCPU 编码。这里有个坑编码器选错不是性能差的问题而是直接编码失败或 CPU 满载按显卡对号入座即可。搜upnp并设为 enabledSunshine 会自动在路由器上开端口转发公网串流在家以外连回来就靠它。路由器不支持 UPnP 时手动端口转发具体端口清单以官方文档为准。另外在 Applications 页可以管理串流应用默认已有 Desktop 和 Steam Big Picture点 Add New 填名称和可执行路径即可添加任意程序。改完记得在 Moonlight 里重进一次应用列表只在客户端重连后刷新不然看不到新加的。跑通与调优最小验证动作Moonlight 里选中 Desktop 应用开始串流。主机桌面实时出现在客户端屏幕上键鼠可正常操作——到这里部署就算跑通了。进阶玩法按需解锁画质上限局域网千兆网络下把max_bitrate单位 Kbps调高画面细节更好Wi-Fi 环境先保守一点多显示器切换串流中按CtrlAltShiftF1~F12切换采集的显示器CtrlAltShiftN隐藏/显示鼠标HDR 串流主机和客户端都要开 HDRWindows 端体验最完整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 页把警告和错误逐条列了出来显卡型号、内存占用都有照着报错定位比重启十遍快。下一步配置参考每个配置项的取值和默认值调优前翻一翻疑难排查比本文更全的故障库含网络测试方法快速上手部署细节的权威版本以它为准第三方包说明社区包情况注意官方不为其提供支持现在打开 Moonlight把第一个游戏串到你手边的那块屏幕上吧——书房那台主机今晚该换个位置发光了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Sunshine 自托管游戏串流服务器部署指南：把闲置主机变成 Moonlight 串流中心
Sunshine 自托管游戏串流服务器部署指南把闲置主机变成 Moonlight 串流中心【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费开源的自托管游戏串流服务器它把家里的游戏主机变成 Moonlight 的串流端让你在电视、笔记本甚至手机上以低延迟玩到主机里的游戏。这篇教程带你从零完成安装、首次配置到跑通第一局串流全程标注常见坑位。先说结论适合你想把游戏主机游戏串到其他屏幕、且希望数据留在自己手里的人耗时Windows 约 10 分钟Linux 约 15 分钟macOS 约 5 分钟功能有裁剪部署成功的标志Moonlight 客户端里能看到你的主机串出 Desktop桌面画面并能用键鼠操作核心路径装好 Sunshine → 打开 Web UI 建账号 → PIN 码配对客户端 → 串流验证认识一下它到底帮你干什么先说场景不说名词客厅里电视接上月光MoonlightSunshine 的官方配套客户端书房主机的大作直接串过来手柄一接就能玩出差住酒店轻薄本或手机上装个客户端远程把家里主机拉起来打一局远程办公时它也能当低延迟远程桌面用串的是整个系统桌面不只是某个应用全程没有第三方中转服务器视频流直接在你客户端和主机之间传输隐私和带宽都归自己Web UI 的 Featured Apps 页面里官方汇总了各平台的 Moonlight 客户端和配套工具挑对应设备下载即可动手前自检开始前对照勾选一下主机系统Windows / Linux / macOS / FreeBSD 之一能流畅跑你想串的游戏显卡NVIDIA / AMD / Intel 独显优先负责硬件编码没有也行软件编码兜底但延迟和画质打折网络局域网内主机和客户端都走有线或 5GHz Wi-Fi 最稳客户端设备一台手机、平板、电视、另一台电脑均可装好 MoonlightWindows 用户准备安装 Virtual HID Driver虚拟手柄驱动串手柄用Linux 用户确认你的登录账号有桌面会话且能执行 sudo安装落地Windows官方 MSI 安装器去发布页下载Sunshine-Windows-AMD64-installer.msiARM 设备选 ARM64 版双击按向导安装。这里有个坑安装器会列出不少可选组件官方明确提醒不要闭眼全勾按需勾选特别是手柄驱动相关项。装完重启一次托盘区出现 Sunshine 图标即就绪。走这条路的原因安装器会自动处理系统服务、防火墙规则是官方推荐路径最省心。Linux发行版原生包最稳三条路里按你的发行版选一条有对应发行版包就别碰 AppImage 或 Flatpak它们不支持 KMS 采集Linux 下 HDR 串流的硬性前提Ubuntu / Debiansudo dpkg -i ./sunshine-ubuntu-24.04-amd64.debdpkg -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 配置与编译打包。这条路要完整工具链且耗时较长普通用户没必要折腾。macOSHomebrew 两条命令brew tap LizardByte/homebrew brew install sunshinetap添加官方 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 件按显卡选编码器顺手开 UPnPConfiguration 页顶部搜索框支持关键字检索搜encoderNVIDIA 选nvencIntel 选quicksyncAMD 选amdvceLinux 下 Intel/AMD 也可选vaapi兜底用softwareCPU 编码。这里有个坑编码器选错不是性能差的问题而是直接编码失败或 CPU 满载按显卡对号入座即可。搜upnp并设为 enabledSunshine 会自动在路由器上开端口转发公网串流在家以外连回来就靠它。路由器不支持 UPnP 时手动端口转发具体端口清单以官方文档为准。另外在 Applications 页可以管理串流应用默认已有 Desktop 和 Steam Big Picture点 Add New 填名称和可执行路径即可添加任意程序。改完记得在 Moonlight 里重进一次应用列表只在客户端重连后刷新不然看不到新加的。跑通与调优最小验证动作Moonlight 里选中 Desktop 应用开始串流。主机桌面实时出现在客户端屏幕上键鼠可正常操作——到这里部署就算跑通了。进阶玩法按需解锁画质上限局域网千兆网络下把max_bitrate单位 Kbps调高画面细节更好Wi-Fi 环境先保守一点多显示器切换串流中按CtrlAltShiftF1~F12切换采集的显示器CtrlAltShiftN隐藏/显示鼠标HDR 串流主机和客户端都要开 HDRWindows 端体验最完整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 页把警告和错误逐条列了出来显卡型号、内存占用都有照着报错定位比重启十遍快。下一步配置参考每个配置项的取值和默认值调优前翻一翻疑难排查比本文更全的故障库含网络测试方法快速上手部署细节的权威版本以它为准第三方包说明社区包情况注意官方不为其提供支持现在打开 Moonlight把第一个游戏串到你手边的那块屏幕上吧——书房那台主机今晚该换个位置发光了。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
