
30 分钟搭好免费游戏串流服务器Sunshine 安装与 Moonlight 配对完整教程【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是一款免费开源的游戏串流服务器官方定位是给 Moonlight 客户端当自托管self-hosted串流宿主端装好它之后你那台带显卡的 PC 就能把游戏画面连同声音实时编码推给手机、平板、电视盒子或另一台电脑键盘鼠标和手柄指令再原路传回来。本文按效果 → 环境 → 安装 → 场景化配置 → 配对 → 调优 → 排障的顺序带你走一遍局域网有线环境下整条链路的延迟通常在几十毫秒量级接近本地游玩的手感而且全程零订阅费。先看结果你得到什么付出什么在动手之前把账算清楚项目实际情况画面1080p 起步GPU 编码能力足够时可到 4K有线网络体验最佳延迟局域网内一般几十毫秒手柄操作跟手接近本地游玩软件成本0 元开源免费无需注册任何云服务账号硬件前提一台带显卡的 PCNVIDIA / AMD / Intel 均有对应硬件编码网络前提同一局域网直接可用跨网段串流需要端口转发或 UPnP唯一的隐性成本串流期间宿主 PC 必须开机且显卡被编码占用。想长期在客厅玩这台机器基本就是客厅的专属设备了——先确认你接受这一点再继续。按下开始串流的那一刻主机上发生了什么理解这条链路后面所有配置项就不神秘了。你在 Moonlight 里点下某个应用时Sunshine 依次做这几件事接收客户端经配对校验后的启动请求拉起你登记过的应用某个游戏或干脆是整个桌面通过系统级采集接口抓帧——Windows 走 Desktop DuplicationLinux 可选 KMS/Wayland/X11 等后端macOS 用 ScreenCaptureKit交给 GPU 硬件编码器实时压缩NVENC、VAAPI、AMF、QuickSync 等取决于你的显卡把编码流走 UDP 推给客户端与此同时你按下的每个按键、每次摇杆移动都以虚拟输入设备的身份注入回宿主。也就是说采集、编码、回传输入三件事都由你这台主机自己完成不经过任何第三方服务器这是自建二字的实际含义。部署前的环境检查清单对照勾选全部满足再开始宿主系统为 Windows 10/11、主流 Linux 发行版或 macOS 14.2显卡驱动已更新到较新版本硬件编码对驱动版本敏感宿主与客户端设备在同一个局域网跨网段则计划好端口转发至少一台能跑 Moonlight 客户端的设备手机、平板、电视盒子或电脑心里有数整条链路唯一要创建的账号是本地 Web 控制台的管理员账号三个平台安装各取所需Windows 三步装完到官方发布页下载最新的 Windows 安装包MSI双击运行按向导走完安装完成即自动启动系统托盘常驻一个图标部署结束。Windows 用户留意一点完整的手柄与 Raw Input 鼠标支持依赖 libvirtualhid 的 Virtual HID Driver需要单独安装装完驱动建议重启一次电脑。Linux 一条脚本出包如果你的发行版有现成官方包Ubuntu/Debian 的 .deb、Fedora 的 rpm、Flatpak优先直接装包省事且行为最完整。没有对应包时用项目自带的构建脚本从源码出包git clone https://gitcode.com/GitHub_Trending/su/Sunshine cd Sunshine ./scripts/linux_build.sh脚本会自己处理编译依赖NVIDIA 机器还会拉取 CUDA 相关组件首次运行耗时较长属于正常。装好之后用这条命令启动服务并设置开机自启systemctl --user --now enable app-dev.lizardbyte.app.SunshineAppImage 和 Flatpak 形式存在沙箱限制不支持 KMS 采集官方也建议有发行版专属包时优先使用专属包。macOS 一行命令brew install sunshine首次启动 Sunshine.app 时会请求屏幕录制与麦克风权限照常授予即可。macOS 端目前仍属实验性质官方明确手柄暂不受支持键鼠场景为主。客厅场景30 秒开 UPnP再登记你的游戏浏览器打开https://localhost:47990把 localhost 换成宿主的局域网 IP 也行。浏览器提示不安全是正常的——自签名证书而已直接继续。首次进入欢迎页会让你创建用户名和密码这组凭据是整个串流链路的唯一钥匙建议随手记下来。开启 UPnP 端口转发同一局域网其实不需要但开了之后跨网段也省心进入Configuration标签页顶部搜索框输入 Upnp在Network分组下把 UPnP 开关打开点底部Save。路由器不支持 UPnP 的话就在路由器后台手动转发 47998–48000UDP这几个串流端口Web 管理端口 47990 只在需要远程进控制台时才需要开放。把游戏登记成应用切到Applications标签页点Add New填应用名和可执行文件完整路径点Save重复第二步可以把想串的游戏都加进去。页面默认自带Desktop整个桌面和Steam Big Picture两条预设开箱就能用。应用列表要在 Moonlight 客户端重启后才会刷新。刚加完看不到新应用多半是客户端没重启别怀疑没保存成功。配对 Moonlight 客户端开始第一场串流客户端不用到处找Web 控制台的Featured Apps标签页里桌面版、Android、iOS、Linux 电视等适配版本都列好了点 Get 跳转对应下载渠道。配对流程只有四步一次配对长期有效确保客户端设备与宿主 PC 在同一网络打开 Moonlight它会自动发现局域网里的 Sunshine 主机客户端提示输入配对码时回到 Web 控制台的PIN标签页把 4 位 PIN 填进客户端并给设备起个名字配对成功后在应用列表里点一下开玩。之后每次想看主机上的游戏打开客户端直接选应用就行不用再碰 PIN。画质与延迟调优只动这四个地方显卡Windows 上的编码器Linux 上的编码器NVIDIANVENCNVENC / VAAPIAMDAMFVAAPI / Vulkan VideoIntelQuickSyncVAAPImacOS 固定走 VideoToolbox。四步调优按这个顺序来先选对编码器按上表选你显卡对应的硬件编码没有可用硬编时才退回软件编码CPU 占用明显上升码率与分辨率有线环境可以直接拉高再按画质回退Wi-Fi 环境先设保守值每次小步上调直到出现卡点为止帧率与客户端那块屏的刷新率对齐高刷设备开高帧率收益最大显卡驱动的隐藏开关AMD 控制面板里开 Enhanced SyncNVIDIA 控制面板里开 Fast Sync——官方性能文档指出这两项各能再省大约一帧的延迟成本几乎为零。症状 → 排查动作客户端发现不了主机→ 先确认两台设备同网段再看宿主防火墙是否放行了 47990管理与 47998–48000串流。画面卡顿、模糊→ 第一选择是改有线仍不行就降码率串流路径的丢包与抖动是硬指标官方文档建议丢包低于 5%、抖动低于 1ms可用 iPerf3 这类工具实测。黑屏或启动失败→ 打开 Web 控制台的Troubleshooting标签页日志里逐条看采集后端与编码器状态报错信息基本能直接定位。手柄 / 键鼠无响应→ Linux 上把运行 Sunshine 的用户加进input组Windows 上确认虚拟输入驱动已装好任何驱动装完或更新后重启一次最稳妥。忘了 Web 控制台密码不用重装终端执行sunshine --creds 新用户名 新密码直接重置。接下来往哪走完整安装方式、快捷键与 HDR 细节docs/getting_started.md每个配置项的含义与可选值docs/configuration.md按显卡分类的进阶调优docs/performance_tuning.md更多网络与输入类疑难杂症docs/troubleshooting.md把这套自建游戏串流服务器跑通之后下一个值得折腾的方向就是 HDR 串流和 4K 高刷——宿主的显示输出、编码档位和客户端的解码能力都要对齐官方文档里有对应的硬件门槛表可以参考。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考