从零到跑通：Sunshine 自建 Moonlight 游戏串流服务器完整落地手册

从零到跑通Sunshine 自建 Moonlight 游戏串流服务器完整落地手册【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine主力机的显卡算力被锁死在书房那张椅子上而你想在客厅电视、办公笔记本甚至掌机上接着玩——这就是 Sunshine 想解决的事。它是一个自托管的游戏串流主机stream host把整台电脑变成一台私人的云游戏服务器再配上开源客户端 Moonlight就能以接近本地的延迟把游戏画面送到任意屏幕上。整个链路不经过任何第三方中转画面、音频、输入都走你自己的网络。Sunshine 的核心价值拆开来看是这几点硬件编码低延迟自动识别 NVIDIA / AMD / Intel 显卡并调用对应编码器纯软件编码仅作兜底延迟远低于传统远程桌面多端客户端Moonlight 覆盖 Windows、macOS、Linux、Android、iOS、电视与嵌入式设备浏览器管理配置修改、应用管理、设备配对全在 Web UI 里完成不用手改配置虚拟手柄注入把客户端手柄虚拟成 Xbox / PS / Switch 手柄打进主机操作体验无损完全自托管没有第三方服务器数据与授权都在你手里动手前把这张清单过一遍先把能不能跑和跑得好不好区分开。前两条是硬性要求后几条是可以妥协的。项目是否硬性说明一台能流畅运行游戏的电脑✅ 硬性系统需为 Windows 11 / Linux / macOS 14.2 / FreeBSD 之一支持硬件编码的显卡✅ 硬性NVIDIA(NVENC)、AMD(VCE)、Intel(QuickSync/VAAPI) 任一即可无独显可走软件编码但延迟、画质打折稳定的局域网⚠️ 建议主机与客户端都优先 5GHz 802.11ac 或千兆有线追求 4K 则建议 CAT5e 以上有线一个 Moonlight 客户端✅ 硬性手机、平板、电视、另一台电脑都可以输入权限⚠️ 按需Linux/FreeBSD 要把用户加入input组Windows 想完整体验手柄需另装 Virtual HID Driver⚠️ 诚实提醒一句macOS 上的 Sunshine 目前仍属实验阶段手柄模拟不可用如果你的主力机是 Windows优先选 Windows 方案更稳妥。分平台落地从装好到第一次成功串流Windows官方安装器最省事去发布页下载对应架构的 MSI 安装包Intel/AMD 选Sunshine-Windows-AMD64-installer.msiARM 设备选 ARM64 版本双击按向导走即可。预警安装器里的可选组件不少别图省事一路全勾——按需勾选勾多了反而可能引入你没用的功能。装完建议重启一次之后系统托盘会常驻 Sunshine 图标。Linux发行版优先源码构建兜底Linux 用户最省心的是直接用发行版现成包。Ubuntu / Debian 下载对应.deb后执行下面这条它会安装依赖并拉起服务sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.debFedora 系先启用官方 COPR 仓库再装copr enable加源、install拉包两条命令一气呵成sudo dnf copr enable lizardbyte/stable sudo dnf install SunshineArch 系更直接pacman -S sunshine一条搞定。为什么优先发行版包而不是 AppImage / Flatpak 这类通用格式官方文档明确提示AppImage 与 Flatpak 不支持 KMS 采集会直接砍掉 Linux 下的 HDR 串流能力。发行版包则把依赖和权限都处理好了。偏爱源码构建的话克隆仓库后一条脚本编译打包。脚本会依次检查依赖、执行 CMake 配置、编译并出包全程耗时较长且需要完整工具链普通用户没必要折腾git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine ./scripts/linux_build.shmacOSHomebrew 一条命令brew tap把 LizardByte 的源加进本地brew install随后拉包安装brew tap LizardByte/homebrew brew install sunshine也可以直接下载 DMG把 Sunshine.app 拖进 Applications。首次登录与第一次串通创建 Web UI 凭据装好后浏览器访问https://localhost:47990进入欢迎页要求你设置用户名和密码。这套凭据只展示这一次之后再也不会出现务必当场记牢。浏览器弹证书不安全的警告可以直接忽略这是自签名证书的正常表现。打开 UPnP 自动端口转发进 Configuration 页顶部搜索框输入 Upnp所有配置项都支持这种快速检索勾选后保存。它让 Sunshine 自动在路由器上完成端口转发省掉手动配置的麻烦也是公网串流的先决条件。如果你的路由器不支持 UPnP就只能手动转发相应端口。添加要串流的应用切到 Applications 页默认已有 Desktop 与 Steam Big Picture。点 Add New 可添加任意程序填上名称与可执行文件路径即可。预警一个高频坑应用列表只在客户端重启后才刷新。改完配置记得在 Moonlight 里重新进一次否则新应用不会出现在列表里。PIN 码配对客户端在 Moonlight 里手动添加主机 IP客户端会弹出一串 PIN 码。回到 Sunshine 的 Web UI点顶栏 PIN 输入这串数字、给设备起个名字回车看到 Success 提示即配对成功。之后每次串流都基于这套信任关系做校验。只调真正影响体验的几个参数Sunshine 默认配置对多数人已经够用真正值得动的其实没几个。encoder编码器默认会选第一个可用编码器但手动指定更稳。按显卡对应nvencNVIDIA、amdvceAMD、quicksyncIntel、vaapiLinux 下 AMD/Intel、vulkan仅 Linux。选错可能导致编码失败或 CPU 满载——这一步错了后面再调码率也白搭。max_bitrate最大码率单位 Kbps默认 0 表示完全跟随 Moonlight 请求的码率。局域网内可以把它调高以放开画质上限但网络一般时反而更容易卡顿——先确认网络够硬再往上调。capture采集后端仅 Linux 关心想上 HDR 必须选 KMS其它采集方式NvFBC、X11 等不支持 HDR。这是 Linux HDR 串流绕不开的硬性要求。想深挖每个字段含义见官方文档 docs/configuration.md所有配置项都有完整说明与可选值。卡住了先看这里现象 → 原因 → 解法画面正常但键鼠/手柄无反应→ 多为输入权限问题。Linux/FreeBSD 把运行 Sunshine 的用户加入input组并注销重登Windows 则确认 Virtual HID Driver 已安装且版本够新。串流卡顿、频繁丢包→ 先确认客户端连的是有线或 5GHz Wi-Fi再把max_bitrate适当调低仍不行就去 Troubleshooting 页看有没有编码报错据此判断是网络瓶颈还是编码器选型问题。忘 Web UI 用户名/密码打不开管理页→ 在主机终端执行sunshine --creds 新用户名 新密码重置AppImage 用户换成./sunshine.AppImage --creds ...。黑屏或连上后无内容→ 进 Web UI 的 Troubleshooting 页翻每一条 warning/error错误码、显卡型号、内存占用都列得很清楚比盲目重试高效得多。浏览器一直提示网站不安全→ 自签名证书的正常现象忽略即可介意的话可在配置里换成自己的证书。把服务器留在后台跑起来配好之后让它开机自启就完事了。Linux 上一条命令即可设为用户级服务并立即启动systemctl --user --now enable app-dev.lizardbyte.app.SunshineWindows 走安装器默认就以服务模式后台运行无需额外操作。之后在 Moonlight 里选中 Desktop 应用主机桌面实时出现在客户端、键鼠可控说明整条链路已经通了。想继续解锁进阶玩法主机与客户端都开启 HDR 再串流Windows 体验最好用CtrlAltShiftN隐藏/显示鼠标、CtrlAltShiftF1~F12切换采集显示器通过 SSH 在无显示环境下启动 Sunshine 配合 HDMI 诱骗器即可搭一台无人值守的串流服务器。各平台 Moonlight 客户端汇总在 Web UI 的 Featured Apps 页按设备挑一个装好即用。更多细节以 docs/getting_started.md 与 docs/troubleshooting.md 为准核心逻辑集中在 src/ 源码目录里。现在就装一个 Moonlight 客户端把第一局游戏串到你想玩的任何一块屏幕上去吧。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考