Xbox 无线适配器 Linux 设置指南文档涵盖 xone 驱动安装、配对、验证和常见问题修复，推荐 CachyOS

xone 驱动安装与配置，适用于 Xbox One / Xbox Series X|S 无线适配器（Dongle）。

本机实测（2026-06-07）： xone-dkms v0.5.8 + CachyOS 7.0.11 内核，挂起恢复后手柄自动重连正常。手柄唤醒系统不支持（适配器固件限制）。

1. 概述

xone 是 Xbox One / Series 配件的 Linux 内核驱动，替代老旧的 xpad。

项目	信息
仓库	dlundqvist/xone（v0.5.8，2026-03）
CachyOS 包	`sudo pacman -S xone-dkms xone-dongle-firmware`（需手动安装，非系统预装）
内核要求	≥ 5.13（实测兼容至 7.0）

不要安装 medusalix/xone（原版）。 该项目已停维护（最后 release 2022 年），6.11+ 内核无法编译，且存在挂起恢复缺陷。

适配器 USB 变体：045e:02fe（新版小号）、045e:02e6（初代大号）、045e:02f9、045e:091e（内置）。蓝牙手柄请使用 xpadneo。

2. 安装

CachyOS

sudo pacman -S xone-dkms xone-dongle-firmware

驱动和固件均由包管理，无需额外操作。

手动编译

git clone https://github.com/dlundqvist/xone.git
cd xone
sudo ./install.sh --release
sudo xone-get-firmware.sh --skip-disclaimer

Arch AUR

yay -S xone-dkms-git
sudo xone-get-firmware.sh --skip-disclaimer

Secure Boot

DKMS 模块需签名才能在内核加载。建议直接禁用 Secure Boot（BIOS 中关闭），省去每次内核更新后重签名的麻烦。如需保留 Secure Boot，手动签名：

sudo openssl req -new -x509 -newkey rsa:2048 \
  -keyout /var/lib/dkms/mok.key -out /var/lib/dkms/mok.crt \
  -nodes -days 3650 -subj "/CN=Secure Boot Module Signing/"
sudo mokutil --import /var/lib/dkms/mok.crt
sudo reboot  # MOK Manager → Enroll

3. 手柄配对

按下适配器配对按钮（指示灯闪烁）
按下手柄配对按钮（LB 旁小圆钮）
西瓜灯常亮即配对成功

一个适配器最多连接 8 个手柄。

4. 验证

lsmod | grep xone              # 模块已加载
sudo dmesg | grep xone         # 无固件加载错误
ls /dev/input/js*              # 手柄设备节点
jstest /dev/input/js0          # 按键测试

5. 问题修复

挂起恢复后手柄无法输入

v0.5.8 已修复。 确认版本：dkms status | grep xone。如果低于 v0.5.7，升级即可。

固件加载失败

dmesg: Direct firmware load for xone_dongle_02fe.bin failed with error -2

CachyOS：sudo pacman -S xone-dongle-firmware。手动编译/AUR：sudo xone-get-firmware.sh --skip-disclaimer。

编译失败

内核 6.11+ 与 medusalix 原版不兼容，使用 dlundqvist/xone。

手柄频繁断连

换主板背面 USB 口
xone v0.5.8 已默认禁用 USB 自动挂起，无需额外配置
Wi-Fi 切 5GHz，适配器远离路由器

6. 卸载与更新

dkms status | grep xone                        # 查看版本
sudo pacman -S xone-dkms xone-dongle-firmware  # CachyOS 更新
sudo dkms remove xone/<version> --all           # DKMS 卸载

7. 参考资料

资源	链接
dlundqvist/xone	github.com/dlundqvist/…
挂起恢复修复	dlundqvist/xone#156
xpad-noone（360 兼容）	github.com/medusalix/x…
Gamepad 在线测试	hardwaretester.com/gamepad

Xbox 无线适配器 Linux 设置指南

目录