Sunshine 虚拟手柄配置指南3 项检查加 1 份最小配置串流 PC 游戏【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/SunshineSunshine 是自托管游戏串流服务器为 Moonlight 客户端提供串流服务。它的虚拟手柄功能可以把手机、平板的触摸与陀螺仪输入转换为主机系统能识别的标准手柄信号。本文解决四个问题虚拟手柄驱动要求、最小配置写法、手柄类型选择以及延迟调优与常见故障排查。先搞清楚它做了什么信号流向很短Moonlight 客户端采集屏幕上的虚拟按键、陀螺仪等输入通过串流通道发给 SunshineSunshine 把这些输入转换为主机系统能识别的标准手柄信号虚拟手柄设备游戏收到的就是一只普通手柄。换句话说游戏不需要知道输入来自手机。配置前检查清单动手改配置之前逐项确认以下条件检查项要求操作系统Windows 10/11或主流 Linux 发行版虚拟手柄驱动Windows 需安装 ViGEmBus版本 1.17 及以上驱动安装入口Sunshine Web 界面「故障排除」页可直接一键安装Sunshine 服务服务进程正常运行Web 界面可访问客户端手机或平板已安装 Moonlight且能发现主机网络客户端与主机可互通同网段优先最小可运行配置配置只写两个字段就能跑通。Windows 配置文件位于%APPDATA%\sunshine\Linux 位于~/.config/sunshine\格式为 INI[input] controller enabled gamepad autocontroller enabled允许客户端发送手柄输入默认是禁用的这是虚拟手柄不生效的头号原因。gamepad auto由 Sunshine 根据客户端上报的设备类型自动选择要模拟的手柄。改完保存重启 Sunshine 服务后用 Moonlight 重新发起串流即可看到屏幕上的虚拟手柄界面。手柄类型怎么选自动 vs 手动先说自动模式的判定规则客户端上报了已知手柄类型时直接采用类型未知时设备带陀螺仪或触摸板就选 PlayStation 系否则选 Xbox 系。大多数设备停留在auto就够了按下表处理特殊情况设备特征推荐类型适用场景类型无法识别、带陀螺仪或触摸板ds4兼容 PS 系手柄的游戏类型无法识别、无上述特征x360兼容性最广的默认选择游戏只认指定手柄类型手动指定 ds4、ds5、x360、xone、switch、generic自动选择结果不满足时注意Windows 上使用 ViGEmBus 驱动时gamepad只支持auto、x360、ds4三个取值驱动版本 1.17 以上。手动指定的写法直接替换auto[input] controller enabled gamepad x360保存并重启服务后生效。把延迟降下来参数与网络调优输入延迟和画面延迟由两套因素决定串流参数、网络质量。按下表调整[stream] fps 60 bitrate 15000参数推荐值说明fps60客户端性能不足或网络较差时降到 30bitrate15000kbps出现丢帧、马赛克时降到 10000–15000packet_size1024跨网段传输时可适当调大网络侧三条原则优先有线无线用 5 GHz 频段。路由器开启 QoS为串流流量预留带宽。关闭其他设备的占带宽应用。局域网内还可用 UPnP 简化端口转发在 Web 界面 Configuration 页搜索Upnp即可开启出问题了故障速查表遇到异常时先开 debug 日志再对照下表[general] min_log_level debug现象最可能原因处理动作虚拟手柄无响应ViGEmBus 未装好controller仍为禁用权限不足重装驱动管理员权限配置页确认controller enabledLinux 确认/dev/uinput读写权限按键映射错误自动选错手柄类型游戏使用非标准布局手动指定gamepad在 Moonlight 里建自定义布局检查游戏内手柄设置延迟明显带宽不足编码参数过高客户端性能不足bitrate降到 10000–15000fps降到 30改用有线网络个别游戏不识别游戏要求特定手柄类型防作弊拦截虚拟输入换x360、ds4等类型逐一尝试确认 Sunshine 权限不低于游戏进程不同平台的差异要点Windows 服务端虚拟手柄依赖 ViGEmBusWeb 界面「故障排除」页可一键安装检查 Windows Defender 是否拦截了 Sunshine 进程以管理员权限运行的游戏需要 Sunshine 拥有不低于游戏的输入权限显卡驱动保持更新降低编码异常导致的卡顿。Linux 服务端最小必要命令把用户加入 input 组并写入 udev 规则sudo usermod -aG input $USER echo KERNELuinput, GROUPinput, MODE0660 | sudo tee /etc/udev/rules.d/99-sunshine-input.rules sudo udevadm control --reload-rules执行后重新登录虚拟手柄输入才能获得/dev/uinput的读写权限。客户端侧触摸板布局在 Moonlight 里配置按游戏单独保存陀螺仪类输入仅在设备支持且手柄类型为 ds4/ds5 时可用平板与主机之间保持低延迟网络输入体验才稳定。完整的配置项清单以官方文档docs/configuration.md为准遇到驱动版本或特殊设备问题可以到项目社区提问。【免费下载链接】SunshineSelf-hosted game stream host for Moonlight.项目地址: https://gitcode.com/GitHub_Trending/su/Sunshine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考