1. GameStream 谢幕之后Sunshine 凭什么接棒1.1 事件回顾一次“砍掉”引发的社区接力先说背景。NVIDIA 在 GeForce Experience 里内置了 GameStream 功能让用户可以把自己电脑上的游戏串流到 Shield 设备、手机或另一台电脑上。这个功能在局域网内表现非常出色延迟低、画质好是很多人搭建家庭云游戏的默认选择。但 NVIDIA 在 2023 年初宣布从 GeForce Experience 3.27 版本开始移除 GameStream官方推荐用户转向 Steam Remote Play 或者其他方案。对于已经习惯用 GameStream 串流的玩家来说这算得上是一次“被迫搬家”。问题在于市面上现成的串流方案要么绑定特定硬件要么走公网中转画质和延迟都受制于人。于是社区里早就存在的两个开源项目被推到了台前Sunshine 承担服务端角色负责接收串流请求、采集画面、编码视频、回传输入Moonlight 承担客户端角色负责解码并显示画面、采集本地输入。两者合在一起几乎是 GameStream 的“完全体替代方案”。Sunshine 的 GitHub Star 数量能够冲到 4 万级别靠的并不是运气而是整个自托管云游戏需求在 GameStream 退场之后集中爆发的真实结果。1.2 项目定位Sunshine 和 Moonlight 的分工要理解 Sunshine必须先理解它和 Moonlight 之间的关系。Moonlight 最初是为了连接 NVIDIA GameStream 而开发的客户端它实现了 NVIDIA 串流协议的解码端。Sunshine 则是一个逆向工程实现的 GameStream 服务端让 Moonlight 客户端不需要连到 NVIDIA 的闭源服务而是直接连到 Sunshine 所在的电脑上。换句话说Sunshine 把原来只能跑在 NVIDIA 显卡和 GeForce Experience 上的服务端能力移植到了任意平台、任意显卡上。Sunshine 本身是一个高性能的串流服务器支持 Windows、Linux、macOS视频编码端支持 NVIDIA NVENC、AMD AMF、Intel QSV甚至还能跑软件编码 x264/x265。这意味着只要你的电脑有主流显卡哪怕是一台 AMD 核显轻薄本也能变成一台云游戏服务器。这一点是 GameStream 时代完全不敢想的——彼时串流服务被锁死在 NVIDIA 生态里A 卡和 I 卡用户根本没有官方途径享受低延迟串流。1.3 自托管云游戏到底是什么很多人一听“云游戏”就想到谷歌 Stadia 或者 GeForce NOW 这类服务但自托管云游戏是完全不同的逻辑。自托管的意思是服务器是你自己的电脑串流链路也是你自己的局域网或者你自行打通的网络。数据不经过第三方的云服务器中转延迟、画质、隐私都由你自己掌控。Sunshine 解决的核心问题可以拆成三个我不在电脑前怎么远程玩到这台电脑上的游戏我不想被网线束缚怎么在客厅、卧室、手机、平板上随时接着玩我不想把游戏存档和处理能力交给云服务商数据和算力都在自己手里这三点分别对应了 Sunshine 在串流服务、客户端兼容、数据可控性上的价值。对于普通用户来说它就是一套“自己家开的云游戏机房”只不过机房只有一台电脑观众和玩家都只有你自己。2. 串流链路全解析一条游戏数据是怎么从电脑到手机的2.1 整体架构与核心模块把 Sunshine 部署好之后一次完整的串流会话从玩家在 Moonlight 客户端点击“开始串流”开始到画面在客户端呈现、手柄输入反馈回服务器端生效为止中间会经过一串非常紧密配合的模块。单说 Sunshine 服务端它的内部大致由几个核心部分组成控制服务器负责处理 Moonlight 客户端的配对、握手、会话建立、心跳维持。视频采集模块在 Windows 上通常抓取显示器输出在 Linux 上依靠 KMS/DRM 或 NVFBC 等接口抓取桌面画面。输入模拟模块将手机触摸屏、手柄按键、鼠标键盘动作转成服务器端的虚拟 HID 输入。编码分发模块调用硬件编码器对视频帧进行实时编码再通过 RTSP/HTTPS 等通道传输给客户端。Web 管理界面Sunshine 内置了一个配置页面用来管理配对码、视频参数、网络参数、音频设置等。这些模块之间通过内部消息循环协作。客户端发来一个控制信号服务端解析后改写输入状态同时服务端每一帧从采集模块取回画面塞给编码器处理再打包发送出去。整体上Sunshine 就是一个“图像采集 视频编码 输入回传”的三明治结构。2.2 握手、配对与端口网络层的准备工作Sunshine 和 Moonlight 之间使用 RTSP实时流协议进行会话控制数据通道则分为视频流和音频流。整个通信依赖固定端口这也是部署时最容易出问题的环节。默认端口分配如下用途协议端口HTTPS 配对/控制TCP47984HTTP 流媒体TCP47989Web 管理界面TCP47990视频流UDP48010客户端控制/音频流UDP47998、47999Moonlight 客户端首次添加主机时会通过 HTTPS 和 Sunshine 建立配对。Sunshine 的 Web 管理界面会生成一个 PIN 码客户端手动输入这串数字完成密钥交换。这个机制保证了即使服务端暴露在公网上没有配对过的设备也无法直接发起串流。配对完成后Sunshine 会把客户端信息保存在本机后续启动串流时会自动匹配。2.3 视频编码环节为什么必须用硬件编码器串流体验好不好编码器是关键。游戏画面是动态实时渲染的每一帧都必须尽快编码、发送、解码不能像视频剪辑那样花几秒钟慢慢压。软件编码虽然画质上限高但 CPU 占用惊人打游戏时本来 CPU 就要负责游戏逻辑和物理计算再分出一大块算力去跑编码画面帧率和延迟都会崩。所以 Sunshine 几乎必须调用硬件编码器。硬件编码器就是显卡里专门负责视频编码的那一小块电路比如 NVIDIA 的 NVENC、AMD 的 AMF、Intel 的 QSV。它们的好处是几乎不占用 CPU 和 GPU 的主要计算资源编码速度快延迟低。Sunshine 在 Windows 上默认会优先调用 NVENC如果是 A 卡环境它会自动切到 AMFI 卡则用 QSV。这里有个容易让新手误解的点Sunshine 对 AMD 和 Intel 的支持不是靠某个特殊安装包而是同一个主程序在运行过程中自动检测编码器。所以网上那些“AMD 处理器选择哪个 Sunshine 安装包”的疑问其实是被误导了——安装包都是一样的设备上的 GPU 是什么Sunshine 就会自动匹配什么编码方案。为了压低延迟Sunshine 的视频编码参数里通常会设置很低的关键帧间隔和短的 GOP画面组这样客户端丢失数据后能快速恢复画面。编码预设也会偏向低延迟模式比如 NVENC 里的p1最快预设或者llhq低延迟高质量。画质和延迟永远在博弈Sunshine 提供了大量参数让用户自己权衡。2.4 输入回传与虚拟显示器体验里的隐形功臣串流最容易忽略的其实是“反向链路”——客户端不只是显示画面它还要把玩家的输入送回服务器。Moonlight 客户端会把键盘、鼠标、手柄、触摸屏的输入事件打包发送Sunshine 收到后在服务器本地模拟成对应的物理设备操作。Windows 上Sunshine 通过虚拟 HID 驱动实现鼠标键盘和手柄的模拟这就解释了为什么安装时它需要管理员权限。实际体验中这部分做得相当成熟手感接近直连延迟几乎感觉不到。还有一个很多人不知道的细节串流时如果你的物理显示器没开或者选的分辨率和物理显示器不匹配画面可能会出现黑屏、花屏、无法切换分辨率等问题。解决方案是装一个虚拟显示器驱动让系统认为有一个不存在的显示器连接在显卡上。Sunshine 在虚拟显示器环境下可以稳定输出指定分辨率和刷新率这也是延迟优化里非常关键的一步。Sunshine 官方文档推荐了 VDDVirtual Display Driver方案安装在系统里后显卡会额外挂一个“虚拟屏幕”串流时画面从虚拟屏幕输出物理显示器关不关都无所谓。3. 从下载到跑通Sunshine 部署与基础配置实录3.1 安装与准备工作Windows / Linux 分别说部署 Sunshine 绝对算不上难但细节很多。先说 Windows 环境。去 Sunshine 的 GitHub Releases 页面下载最新版文件名一般是sunshine-windows-installer.exe或类似格式。这里不需要区分 AMD 或 Intel同一个包覆盖所有显卡。安装时选择默认路径即可安装完成后首次启动需要以管理员身份运行因为它要装虚拟显示驱动和虚拟 HID 驱动。有些杀毒软件会对驱动安装行为弹窗放行即可。准备一对硬件建议游戏主机有独立显卡NVIDIA 的 GTX 10 系及以上、AMD RX 5000 系及以上、Intel 核显都能胜任。Windows 上还需要装好显卡驱动N 卡用户最好装上 NVIDIA 驱动里附带的 NVENC 编解码组件新版驱动默认自带。Linux 环境下会稍微复杂一些但有两种省事路径直接下载官方提供的 AppImage在大多数发行版上双击或chmod x后运行。使用发行版的包管理器安装比如 Arch 的 AUR 里就有sunshine包Ubuntu/Debian 系可以用官方维护的.deb包。Linux 上需要注意显卡驱动和权限问题。N 卡用户要安装 NVIDIA 专有驱动A 卡走 amdgpu 开源驱动I 卡走 i915 驱动。想要采集桌面画面用户需要属于video组并且要有访问/dev/dri设备的权限。如果安装完启动后日志提示无法打开 GPU 设备大概率就是权限或驱动问题。3.2 Web 管理界面的初始化与配对Sunshine 启动后在浏览器里访问https://localhost:47990就能进入 Web 管理界面。首次访问因为自签名证书浏览器会警告“不安全”不用管点继续访问即可。进入界面后第一步是创建用户名和密码这是管理界面的登录凭证和 Moonlight 配对的 PIN 码不一样。登录后界面分为几个主要区域General常规、Audio音频、Video视频、Network网络、Advanced高级等。想添加 Moonlight 客户端时在 General 页面或“Pairing”区域点击生成 PIN 码然后打开客户端选择手动添加主机输入电脑 IPMoonlight 会提示输入配对码填进去就成了。这里我踩过一次坑如果你有两台 Sunshine 设备或者主机名有特殊字符Moonlight 里添加主机时可能会显示“找不到主机”。解决办法是手动输入 IP 地址而不是主机名并且在同一个局域网网段内操作。配对码有时效性过期后重新生成就行。3.3 视频与网络参数配置照着抄就行Web 界面里最核心的是 Video 配置区。我常用的配置如下编码器NVIDIA NVENC / AMD AMF / Intel QSV按实际硬件选选错会导致启动串流时报错。分辨率按客户端屏幕比例选比如 1920x1080 或 2560x1440。建议固定不要用“自动”否则每次串流都要重新握手。帧率60 FPS 是平衡点如果你是 144Hz 显示器玩家可以试 90 或 120但要注意码率会相应上涨。码率局域网 20-30 Mbps 起步无线环境可以降到 10-15 Mbps。CRF/CQP这是决定画质的关键参数。Sunshine 支持设置恒定质量系数数值越低画面越好、码率越高。我一般设 20-24画质和码率比较均衡。编码预设NVENC 推荐p1或p2AMF 推荐speedQSV 推荐veryfast优先保延迟。关键帧间隔设为 2-4 秒别太长否则丢包后画面恢复很慢。Network 区里主要关注端口和帧延迟控制。端口默认值不要乱改除非你有多个 Sunshine 实例要跑。网络带宽上限可以配合码率设置给其他设备留出余量。3.4 防火墙与常见环境坑部署完成后最常遇到的问题就是“配对成功但无法串流”或者“客户端一直转圈”。排查顺序里第一个就是防火墙。Windows 上安装 Sunshine 时安装向导一般会弹出防火墙许可提示很多人手滑点了取消导致客户端连不上端口。解决办法是手动到“允许应用通过防火墙”里添加 Sunshine并且同时放行 TCP 47984/47989/47990 和 UDP 47998/47999/48010。如果服务器在 Linux 上用ufw或firewalld放行同样的端口。路由器上如果开了 AP 隔离无线设备互相隔离手机和电脑之间就没法通信串流自然失败。这个问题在办公网络或某些公共 WiFi 上尤其隐蔽排查时要想到。4. 性能调优把延迟从“能用”压到“敢玩”4.1 延迟都藏在哪里串流延迟不是单一数值而是一条链路上所有环节延迟的总和。一次串流的延迟大体由以下几段构成采集延迟画面从 GPU 输出到编码器输入端的时间。Windows 上用 WGC 或者 NVFBC 采集延迟通常在 1-5ms 之间。编码延迟视频帧被硬件编码器压缩的时间NVENC 在低延迟预设下大约 2-5ms。网络传输延迟局域网内 1ms 左右走公网则取决于你的网络环境可能几十毫秒。解码延迟客户端硬件解码耗时手机和平板一般在 3-10ms。显示延迟显示器或屏幕本身的刷新延迟。如果你在家里局域网内测试端到端延迟能控制在 20-40ms 之间这已经非常接近直连电脑的体验了。如果你想把延迟压得更低优先从采集和编码环节下手。4.2 编码器与码率选择建议编码器选择是最影响体验的决策。N 卡用户直接选 NVENC这是目前各项表现最均衡的硬件编码器画质和延迟几乎无可挑剔。A 卡用户选 AMFI 卡用户选 QSV虽然绝对画质与整卡性能相关但 Sunshine 的适配已经相当成熟正常用不会有大问题。码率设置有两个方向固定码率CBR适合网络不稳定的场景保持恒定数据量。可变码率VBR/CRF按画面复杂程度动态调整码率画质更好但瞬时码率可能冲得很高。我建议局域网环境用 VBR / CRF 方案画质优先公网串流或无线环境用固定码率避免拥塞导致花屏卡顿。一个比较实用的经验值1080p/60fps 下 CRF 22 的局域网码率大约在 20-40 Mbps如果在手机 5G 网络下串流手动限到 15 Mbps 会更稳定。4.3 不同硬件组合的实际表现参考我实测过几套配置可以作为参考硬件组合编码器1080p/60fps 延迟局域网4K/60fps 表现NVIDIA RTX 4070NVENC约 15-20ms良好码率 40Mbps 画面干净AMD Radeon RX 6700 XTAMF约 20-25ms可以跑但 4K 高码率时延迟略高Intel Iris Xe 核显QSV约 25-35ms不适合 4K1080p 完全能玩无独显纯 CPU 压片x264约 40-60ms不推荐数据不是绝对的和驱动版本、系统负载、网络设备都有关系但可以得出一个结论想获得接近本地直连的体验N 卡依然是首选A 卡居中核显适合轻量场景。4.4 进阶虚拟显示器、HDR 与多显示器如果你打算长期用串流代替直连虚拟显示器几乎是必装项。安装虚拟显示器驱动后即使物理显示器断电系统也能保持一个稳定的虚拟屏幕输出串流端不会黑屏分辨率切换也稳定。virtual-display-driver 项目在 GitHub 上可以找到安装后去系统显示设置里把虚拟显示器设为“扩展这些显示器”或者“复制”再在 Sunshine 的 Video 配置里把分辨率锁定到目标值。HDR 串流是另一个可玩性很高的进阶项。Sunshine 支持 HDR 透传前提是客户端解码设备支持 HDR并且你的游戏画面本身是 HDR 输出。开启后需要在 Web 配置里启用 HDR 选项编码码率适当调高否则暗部细节会被压成一团黑。多显示器环境要注意指定输出显示器。Sunshine 的配置里有一项“Display Output”或“Output Name”你可以选择抓取哪一块屏幕的画面。如果选错了串流端看到的可能是桌面壁纸而不是游戏画面。我自己的习惯是游戏跑在主显示器上串流也固定抓主显示器副屏只放聊天工具和浏览器。5. 常见问题与排查技巧实录5.1 配对失败 / 连不上 / 黑屏这三个问题是所有串流用户绕不开的坎我按优先级整理一下排查路径。配对失败时先确认 Sunshine 是否处于运行状态、Web 管理界面能否正常打开。如果 Web 界面打不开说明服务没起来去查看系统日志或 Sunshine 的日志文件。其次确认客户端输入的主机 IP 是否正确有些路由器分配了多个网段手机和电脑可能不在同一个网段互相之间ping不通。配对成功但连不上串流端口多半是防火墙。Windows 上检查“允许应用通过防火墙”里是否放行了 SunshineLinux 上用ss -lntu看端口监听状态再用telnet或nc从客户端侧测试 TCP 47989 是否连通。黑屏问题的根源几乎都在视频采集端。先试试把虚拟显示器装好再确认 Sunshine 的编码器选项和实际显卡匹配。如果黑屏时还有声音说明链路已经通了只是画面没采到。这时候去系统设置把显示器扩展出来或者指定正确的采集输出问题基本能解决。5.2 日志里的“Failed to initialize”类报错怎么查有人反馈在日志或者命令终端里看到类似failed to initialize NVML或者更完整的every 5.0s: nvidia-smi ... failed to initialize这样的输出这正是排查时的重要线索。这个报错出现在需要调用 NVIDIA GPU 的环境里意思是 NVIDIA 管理库NVML无法初始化也就是系统没有正确暴露或加载 NVIDIA 驱动。先说一个最容易出现这个问题的场景在虚拟机或容器里跑 Sunshine但并没有把物理 NVIDIA 显卡直通进去系统只看到了虚拟显卡。这时候 nvidia-smi 确实跑不起来Sunshine 自然也无法用 NVENC 编码。解决办法是确认宿主机显卡直通配置或者在物理机上运行 Sunny。如果确认是物理机那么先卸载驱动再重新安装最新版驱动重启后执行nvidia-smi能正常输出显卡信息和驱动版本才算恢复。Linux 下还有一个隐蔽问题开源驱动nouveau会和 NVIDIA 专有驱动冲突导致 NVML 无法初始化。检查方式是执行lsmod | grep nouveau如果有输出需要把 nouveau 加入内核黑名单并重建 initramfs然后重启。这个坑比较深但一旦遇到靠改配置是绕不过去的必须从驱动加载层面解决。5.3 音频、手柄和外设类问题串流时没有声音优先检查 Sunshine 的 Audio 配置。Windows 上它默认会捕获系统默认播放设备的音频如果默认播放设备是静音或者物理声卡被禁用串流端就会无声。把系统默认播放设备切换到正常设备或者安装虚拟声卡驱动可以根治这个问题。手柄失灵的排查方向很明确先看客户端是否识别到手柄再看 Sunshine 的输入状态是否收到事件。Windows 上 Sunshine 通过虚拟 HID 模拟手柄如果系统装了第三方手柄映射工具例如 DS4Windows可能会出现冲突。建议先关掉这些映射工具再测试。手机端串流时虚拟按键不响应多半是客户端的手柄映射配置问题去 Moonlight 的按键设置里重新映射即可。5.4 常见问题速查表现象可能原因解决动作Web 管理界面打不开服务未启动查看服务状态重新启动 Sunshine配对时提示找不到主机IP 网段不一致确认客户端与服务端同网段手动填 IP串流黑屏但有声音显示器采集失败安装虚拟显示器驱动并指定采集输出画面卡顿、马赛克码率不足提高码率上限或降低分辨率/帧率延迟忽高忽低无线信号不稳定换 5GHz 频段或改有线连接音频无声默认播放设备不对设置正确的系统默认音频设备手柄无响应输入映射冲突关闭手柄映射工具重新配置 Moonlight日志报 NVML 初始化失败驱动未加载或虚拟化环境未直通 GPU重装驱动检查 GPU 直通/黑名单配置6. 写在最后关于 Sunshine 的一些个人体会Sunshine 打动我的地方不在于它有多少 Star而在于它真的把“云游戏”这个概念变成了普通人能拿在手里的工具。GameStream 被砍之后很多人以为这条路断了结果社区用开源方式把它重新铺了一遍而且铺得更宽——不再绑死 NVIDIA不再依赖 GeForce Experience不再需要 NVIDIA 账户在线验证。这整个替代过程在我看来是典型的技术社区自救案例也解释了为什么它能积累到 4 万颗 Star。如果让我给一个上手建议那就是别一上来就追求 4K 120 帧那些极限参数。先把 1080p/60fps 跑通摸清楚自己网络环境的底线再一步步加码。我在实际使用中最常用的场景其实是“躺在床上用平板接着打电脑上的 RPG”延迟几乎感知不到画面和键位手感都接近原生。这个小需求听起来不算什么但真要用串流方案实现它Sunshine 是目前几乎没有对手的选择。最后分享一个小技巧如果你同时有室内和室外串流需求建议在路由器上给 Sunshine 主机配置固定 IP并开启 UPnP 或手动端口转发。公网串流时延迟会高一些但配合低码率和合适的帧率设置大多数回合制、养成类游戏完全能玩。这个扩展方向很值得折腾也是自托管云游戏最爽的部分——你的游戏真的可以跟着你走到哪玩到哪。