
Sunshine从零搭建专属低延迟游戏串流服务器完整指南【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine周末朋友来家里想在客厅大屏上玩你 PC 里的单机大作可 HDMI 线插到电视上、主机搬到客厅又都麻烦。自托管游戏串流是这时最务实的路线——Sunshine 正是一款自托管游戏串流服务器它跑在你的电脑上实时抓取画面、用 GPU 硬件编码压缩视频通过网络送到 Moonlight 客户端手机、平板、电视、另一台电脑都能玩。全程免费开源配置管理在浏览器里完成。想把家里旧主机变成游戏盒子、或远程接管自己的游戏机10 分钟就能搭起来。它解决什么问题很多人听到串流先想到云游戏服务但那条路是租别人的机器按月付费游戏库受平台限制。Sunshine 走的是自托管路线——用你自己的 GPU 编码、你自己的游戏做内容成本只有电费。Sunshine 负责服务端配合开源的 Moonlight 客户端覆盖 Windows、macOS、Linux、iOS、Android 和电视串流链路就闭环了。它的核心价值有三点三家 GPU 厂商都支持硬件编码即调用显卡上的专用编码单元压缩视频不占用 CPU项目开源免费Windows、macOS、Linux、FreeBSD 都有官方包。而且串流源不限于游戏PC 上能跑的任何程序都可以推到大屏。维度云游戏服务Sunshine Moonlight费用按月或按次付费免费开源只花硬件电费游戏库平台提供哪些玩哪些PC 里装了什么都能玩硬件租用云端机器自己的 PCGPU 硬件编码网络依赖服务商节点局域网最稳跨网需端口转发数据游戏跑在别人的机器上全部留在本机下一步建议家里有吃灰的游戏 PC 的话直接按下面步骤把它变成串流主机。快速上手 官方推荐用最新 Release 的安装包源码编译只在有特殊需求时考虑。Windows绝大多数 x86 电脑安装 AMD64 版 MSI 安装包向导里的选项防火墙规则、Windows 服务、开机自启建议逐项确认不要一路下一步。也可以直接用包管理器winget install LizardByte.SunshineLinuxDebian/Ubuntu 先添加官方 stable 源配置脚本见官方入门文档然后sudo apt update sudo apt install sunshine不想动系统源的话可以用 Flatpak注意它不支持 KMS 捕获有发行版原生包时优先原生包flatpak install flathub dev.lizardbyte.app.Sunshine装好后启用用户级服务登录桌面时自动启动systemctl --user --now enable app-dev.lizardbyte.app.SunshinemacOS下载对应芯片的 DMG拖入应用程序即可。官方明确 macOS 版本是实验性的手柄暂不可用首次启动需要授予屏幕录制和麦克风权限。首次启动与配对Sunshine 跑起来后浏览器打开https://localhost:47990首次进入时创建用户名和密码浏览器对自签名证书的不安全警告可忽略。之后在 Moonlight 客户端搜索到 Sunshine网页端会弹出 PIN 配对请求输入 PIN 并给设备命名配对完成。下一步建议先串流内置的桌面项试试客户端能看到桌面画面说明链路全通再加具体游戏。核心能力拆解选对编码器硬件编码省 CPU软件编码全靠 CPU 硬压帧率一高就卡。Sunshine 会自动识别显卡并匹配对应的硬件编码接口你在网页上只需确认选中的是哪一种编码器适用 GPU可用平台NVENCNVIDIA 显卡内置编码器NVIDIAWindows / LinuxAMFAMDWindowsQuickSyncIntelWindowsVAAPILinux 的标准视频加速接口AMD / Intel / NVIDIALinux / FreeBSDVideoToolboxApple / IntelmacOS软件编码任意 CPU全平台兜底建议网页配置项很多直接用搜索栏定位encoder比逐页翻快得多。屏幕捕获Windows 省心Linux 要选对Windows 用 DXGI 桌面复制系统级屏幕镜像 API基本不用管。Linux 的麻烦在于捕获方式多KMS/DRM 直接读显示输出、NvFBC 是 NVIDIA 在 X11 下的低延迟路径、WaylandLinux 新一代桌面协议下有 wlroots 和 XDG Portal 等选错容易黑屏或掉帧。捕获方式平台特点DXGI 桌面复制Windows标准方式KMS/DRM内核显示管理接口Linux / FreeBSD无桌面无头环境也能用NvFBCLinuxX11NVIDIA 专属延迟低Wayland / XDG Portal / KWinLinux适配现代桌面ScreenCaptureKitmacOS系统标准录屏 API建议Linux NVIDIA X11 优先试 NvFBCWayland 桌面用 KMS 或 wlroots。任何程序都能当串流源串流不等于只能玩游戏——网页、模拟器、整个桌面都可能是你想要的画面。在网页端应用页签里添加任意程序填命令、工作目录即可支持环境变量和启动参数。注意流中启动新应用会终止当前应用像 Steam 这类需要常驻的程序建议设成 detached脱离方式运行避免串流随进程退出而断开。手柄透传虚拟手柄手柄握在客户端手里服务器端的游戏却没有手柄。Sunshine 的做法是在宿主机上模拟一个虚拟手柄把客户端输入映射过去支持 Xbox 360/One/Series、DualShock 4/5、Switch Pro 手柄等。手柄类型LinuxWindowsmacOSFreeBSD通用 HID支持支持不支持部分支持Xbox 360/One/Series支持支持不支持部分支持DualShock 4 / DualSense支持支持不支持部分支持Switch Pro支持支持不支持部分支持Windows 上需要装虚拟手柄组件ViGEmBus 只支持 Xbox 360 和 DS4 且已停止维护官方 Virtual HID Driver 支持更多手柄但属于付费选项。建议主力用手柄玩的话先确认目标平台的虚拟手柄支持情况再部署。实测数据 官方 README 公布了捕获与编码的兼容矩阵适用 Linux/FreeBSD这是选方案时最可靠的依据。延迟没有公开的统一基准值本文不编造数字——它取决于 GPU 编码链路与网络路径官方排障文档建议用 iPerf3 测试客户端与服务器之间链路的稳定性重点是低延迟抖动、无丢包而不是极限带宽。捕获方式VAAPIVulkan VideoNVENC软件编码KMS/DRM✅✅✅✅NvFBC❌❌✅❌Wayland (wlroots)✅❌✅✅X11✅❌✅✅XDG Desktop Portal✅✅✅✅KWin Screencast✅✅✅✅结论很直接NvFBC 只能配 NVENCKMS/DRM 通吃Wayland 下 XDG Portal 覆盖面最广。网络方面官方建议主机与客户端都走 5GHz802.11acWi-Fi上 4K 则要求 CAT5e 以上有线。实测发现局域网里硬件编码加有线连接体感明显稳于无线。下一步建议部署前先用 iPerf3 跑一轮链路测试把网络变量排除掉再调画质。避坑与常见问题 ⚠️卡住时先看网页端 Troubleshooting 页签的日志官方把常见报错都列在里面浏览器提示不安全或打不开 47990 页面现象地址栏红色警告或从其他设备完全访问不到。 原因网页使用自签名证书警告属正常现象访问不到多为防火墙拦了端口。 解法忽略或信任该证书在防火墙放行 47990。忘记网页端账号密码现象登不进配置页什么也改不了。 原因凭据存在本机配置里网页端没有找回入口。 解法命令行直接覆盖——sunshine --creds 新用户 新密码然后正常登录。Linux 下键盘、鼠标、手柄无响应现象能连上、能看画面但输入全部失效。 原因运行 Sunshine 的用户不在input组没有权限创建虚拟输入设备。 解法把该用户加入input组注销并重新登录生效。串流卡顿、丢帧现象画面周期性掉帧音频偶尔不同步。 原因实时串流对网络稳定性的要求高于带宽——丢包和延迟抖动才是主因。 解法iPerf3 测链路能换有线就换有线检查 MTU网络包大小设置仍不行再降分辨率或码率。生态与资源入门指南安装、初始化、配对docs/getting_started.md配置项全参考docs/configuration.md性能调优docs/performance_tuning.md故障排查手册docs/troubleshooting.md三大平台实现linux/windows/macos 子目录src/platform/NVENC 编码器封装src/nvenc/单元与集成测试tests/第三方依赖子模块third-party/想看源码可以执行git clone https://gitcode.com/GitHub_Trending/su/Sunshineclone 后按 docs/building.md 编译。建议从 configuration 文档挑两三个最关心读一读比通读效率高。Sunshine 让你用现成的 PC 拿到云游戏给不了的串流体验。挑一个平台按快速上手装起来半小时后电视上就能玩你整个游戏库。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考