Sunshine项目在Fedora 40系统中鼠标输入失效问题分析与解决

问题背景

近期在Fedora 40（KDE Plasma）系统上运行Sunshine项目的夜间构建版本时，用户报告了一个特殊的输入设备问题：从客户端设备通过Moonlight连接时，鼠标输入（包括移动和点击）无法在主机上正常响应，而键盘和游戏手柄输入则工作正常。该问题仅出现在新版本中，旧版v0.23.1工作正常。

技术分析

输入系统架构变更

通过代码提交历史追溯，发现该问题与Sunshine项目近期对输入系统的重大重构有关。新版本采用了基于/dev/uinput设备的虚拟输入实现方案，替代了旧版的部分输入处理逻辑。这种架构变更虽然提升了输入设备的兼容性和可维护性，但也引入了新的系统依赖。

Fedora系统特殊性

Fedora 40作为较新的Linux发行版，其输入设备管理机制有以下特点：

1. 默认情况下uinput设备需要特定的udev规则才能被普通用户访问
2. 系统对虚拟输入设备的权限管理更为严格
3. KDE Plasma桌面环境可能有额外的输入处理层

根本原因定位

经过测试验证，确认问题源于：

1. 缺少必要的udev规则，导致Sunshine无法访问uinput设备
2. 系统未自动加载uhid内核模块（虽然此模块主要用于PS5手柄模拟）
3. 新旧版本输入系统实现的差异导致兼容性问题

解决方案

完整修复步骤

1. 创建udev规则文件：

cat > /etc/udev/rules.d/60-sunshine.rules <<EOF
KERNEL=="uinput", SUBSYSTEM=="misc", OPTIONS+="static_node=uinput", TAG+="uaccess"
KERNEL=="uhid", TAG+="uaccess"
EOF

2. 确保uhid内核模块加载：

echo uhid > /etc/modules-load.d/sunshine.conf

3. 应用变更并重启服务：

sudo udevadm control --reload-rules
sudo udevadm trigger

验证方法

1. 检查模块加载状态：

lsmod | grep uhid
cat /proc/modules | grep uhid

2. 监控输入设备事件：

udevadm monitor

3. 使用evemu-record工具检测虚拟设备

经验总结

1. 系统兼容性：Linux发行版间的细微差异可能导致功能异常，特别是涉及设备权限时
2. 版本过渡：重大架构变更时，应提供详细的升级指南和依赖说明
3. 调试技巧：使用udevadm和evemu-record等工具是诊断输入问题的有效手段

后续建议

对于Linux用户，特别是使用较新发行版的用户，建议：

1. 仔细阅读项目的系统要求文档
2. 在升级前检查变更日志中的重大修改
3. 掌握基本的输入系统调试方法
4. 考虑在测试环境中先行验证新版本

该问题的自发消失也提示我们，某些系统级更新可能在不经意间解决了底层兼容性问题，因此保持系统更新也是预防此类问题的有效方法之一。