Sunshine项目中的周期性卡顿问题分析与解决方案

问题背景

在使用Sunshine项目的v2025.130.210222版本时，用户报告了一个周期性卡顿的问题。具体表现为渲染帧率从正常的60fps突然下降到约20fps，持续几秒后又恢复正常。这个问题在主机活动量增加时更为明显，但也会在空闲状态下发生。

环境配置

主机系统：

• 操作系统：Arch Linux 6.12.10-zen1-1-zen
• 架构：amd64/x86_64
• GPU：NVIDIA 4070 SUPER
• 驱动程序：NVIDIA 565.77，Mesa 1:24.3.4-1

客户端配置：

• 系统：Arch Linux 6.12.10-zen-surface（结合了linux-surface和linux-zen补丁集）
• 软件：Moonlight 6.1.0
• 网络连接：主机通过有线网络连接AP，客户端使用5GHz Wi-Fi无线连接

问题分析

从日志中可以观察到频繁的IDR关键帧请求（IDX_REQUEST_IDR_FRAME），这表明客户端可能因为网络问题或解码问题不断请求新的关键帧。这种频繁的关键帧请求会导致编码器重置，从而造成帧率下降。

用户尝试了多种解决方案但都未能彻底解决问题：

1. 切换X11和Wayland显示服务器
2. 从SDL3回退到SDL2
3. 更改捕获方法
4. 切换编码器（从NVENC到VA）

根本原因

经过深入排查，发现问题根源在于linux-surface内核补丁集对Wi-Fi驱动程序的支持存在问题。具体表现为：

• 使用5GHz频段时会出现不稳定的网络连接
• 导致客户端频繁请求关键帧
• 造成编码器频繁重置和帧率下降

解决方案

最终确认的解决方案是：

1. 回退到标准的linux-zen内核（不包含surface补丁）
2. 使用2.4GHz Wi-Fi频段替代5GHz频段

这个解决方案稳定了网络连接，消除了频繁的关键帧请求，从而解决了周期性卡顿问题。

技术建议

对于类似问题的排查，建议采取以下步骤：

1. 首先检查网络连接稳定性
2. 分析日志中的关键帧请求频率
3. 尝试不同的网络频段（2.4GHz vs 5GHz）
4. 考虑内核驱动程序的兼容性问题
5. 必要时回退到更稳定的内核版本

对于Sunshine项目的用户，特别是在Linux环境下，建议：

• 优先使用有线网络连接
• 如果必须使用无线，2.4GHz频段通常比5GHz更稳定
• 谨慎使用非标准内核补丁集