Sunshine游戏串流服务器从零跑通：Moonlight自建方案完整部署与避坑指南
Sunshine游戏串流服务器从零跑通Moonlight自建方案完整部署与避坑指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine想要把主力机的游戏库串到客厅电视、笔记本或掌机上Sunshine 是最省心的自托管游戏串流服务器它把本机变成 Moonlight 的串流主机硬件编码压低延迟浏览器里就能管完所有配置。本文带你从环境自查、安装到配对跑通一次讲清 Sunshine 的部署全流程。它到底能帮你做什么你在办公室用轻薄本想接着打主机游戏装一个 Moonlight 客户端连上家里的 Sunshine主机画面几秒内推到笔记本上——低延迟来自显卡硬件编码而不是普通远程桌面那种逐像素传输。坐在客厅沙发上电视端的 Moonlight 连过来整台主机的游戏库都能玩手柄操作会被 Sunshine 虚拟成 Xbox、PS、Switch 等实体手柄注入主机游戏里按的是真手柄手感不打折。不想折腾命令行Sunshine 自带 Web 管理界面改配置、加应用、配对设备全在浏览器里点完。再加上 Windows 端的 HDR 串流支持Linux 端实验性可用以及完全自托管、不经过任何第三方中转的架构——数据、授权、端口都在自己手里。动手前环境自查清单检查项要求说明主机系统Windows / Linux / macOS / FreeBSD以官方最新文档支持的版本为准显卡NVIDIA / AMD / Intel 独显优先没有独显可走软件编码延迟和画质打折显示器串流主机需能输出画面无显示器可配 HDMI 诱骗器网络局域网千兆有线或 5GHz Wi-Fi公网串流需路由器支持 UPnP 或手动端口转发客户端一个 Moonlight手机/平板/电视/电脑Web UI 的 Featured Apps 页有各端入口额外驱动Windows 需 Virtual HID Driver完整手柄体验依赖它Linux 需input组权限⚠️ 坑点提醒Linux 下如果账号不在input组手柄和键鼠注入会直接失效装完记得先处理这一步。安装落地分平台Windows 安装MSI 安装器从项目发布页下载与你架构匹配的Sunshine-Windows-AMD64-installer.msiARM 设备选 ARM64双击按向导安装即可。 小贴士安装向导里有不少可选组件别一路默认全勾按需勾选装完重启一次系统托盘会出现 Sunshine 图标。想要完整键鼠和手柄注入还需单独安装 Virtual HID Driver。Linux 安装发行版包优先Ubuntu / Debian 下载对应.deb后sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb这条命令会把 Sunshine 及其 systemd 服务装进系统。Fedora 系先启用官方 COPR 仓库再安装sudo dnf copr enable lizardbyte/stable sudo dnf install SunshineArch 系则直接pacman -S sunshine。为什么坚持推荐发行版包因为官方已处理好依赖和设备权限而AppImage / Flatpak 不支持 KMS 采集会直接影响 Linux 下的 HDR 串流。偏爱源码构建可以走这条路需要完整工具链耗时较长普通用户不必折腾git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine ./scripts/linux_build.sh脚本负责检查依赖、执行 CMake 配置并编译打包一条命令跑完整个构建流程。macOS 安装Homebrew 或 DMGbrew tap LizardByte/homebrew brew install sunshinebrew tap把官方仓库加入本地源随后拉取安装也可以直接下载 DMG 把 Sunshine.app 拖进 Applications。诚实说一句macOS 版目前仍是实验性质手柄暂不支持主力机是 Windows 的话优先选 Windows 方案。首次配置与关键调优设置 Web UI 凭据装好后浏览器访问https://localhost:47990欢迎页会要求你创建 Web 界面的用户名和密码。页面有明确提示这套凭据只显示这一次务必当场记牢。浏览器跳不安全警告属于正常现象源于自签名证书忽略即可。打开 UPnP 自动端口转发进入 Configuration 页顶部搜索框输入 Upnp所有配置项都支持这样快速检索勾选启用后保存。它会让 Sunshine 自动在路由器上开串流端口是公网串流的前置条件路由器不支持时需要手动转发相关端口具体以官方最新文档为准。把编码器选对encoder是最影响成败的选项选错会编码失败或 CPU 满载显卡/平台推荐值NVIDIAnvencAMDamdvceWindowsLinux 可用vaapi/vulkanIntelquicksyncWindowsLinux 用vaapi/vulkan兜底softwareCPU 编码画质上限由max_bitrate控制单位为 Kbps默认 0 表示跟随 Moonlight 客户端请求的码率局域网带宽富余时可以在 Web UI 里把它调高试试具体数值以官方文档说明为准。添加串流应用切到 Applications 页默认自带 Desktop 与 Steam Big Picture点 Add New 可填任意程序的名称和可执行文件路径。⚠️ 坑点提醒应用列表要在客户端侧重启后才刷新改完记得回 Moonlight 重进一次否则看不到新条目。跑通验证与排障验证动作在 Moonlight 里手动添加主机 IP客户端弹出一串 PIN 码回到 Web UI 顶栏点 PIN填入数字并给设备起个名字回车看到 Success 即配对完成。然后选 Desktop 应用主机桌面实时出现在客户端、键鼠可操作就算部署成功。排障路径出问题别盲猜先开 Web UI 的 Troubleshooting 页读日志再对照下表症状常见原因处理动作忘了 Web UI 账号密码凭据只显示过一次终端执行sunshine --creds {新用户名} {新密码}重置AppImage 换成./sunshine.AppImage --creds ...键鼠/手柄无反应Linux/FreeBSD 权限不足Windows 缺驱动Linux 把运行用户加入input组后注销重登Windows 确认 Virtual HID Driver 已装浏览器提示不安全自签名证书属正常现象介意的话可在配置中替换为自己的证书卡顿、频繁丢包网络质量差或码率过高确认客户端走有线/5GHz适当调低max_bitrate再看日志里有无编码报错打不开 Web UI防火墙拦截或进程没跑检查防火墙对 47990 端口的放行确认 Sunshine 进程在运行进阶玩法HDR 串流主机系统与客户端都开启 HDR 后再串流Linux 端必须用 KMS 采集后端这是硬性要求快捷键CtrlAltShiftN隐藏/显示鼠标CtrlAltShiftF1~F12切换串流显示器无显示器主机通过 SSH 启动 SunshineX11 场景配合 HDMI 诱骗器搭无人值守串流服务器找客户端工具Featured Apps 页汇总了各平台 Moonlight 客户端和实用工具按设备挑一个装好即用资源索引与收尾想深挖某个配置项直接翻 docs/configuration.md部署细节以 docs/getting_started.md 为准踩坑优先查 docs/troubleshooting.md功能实现可以看 src/ 下的源码目录。项目社区活跃官方 Discord 和讨论区沉淀了大量现成经验卡壳时搜一搜大概率直接命中同款问题。现在去装一个 Moonlight 客户端把第一局游戏串到你手边任何一块屏幕上去吧。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考