Xbox 无线适配器 Linux 设置指南

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

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

---

目录

• [1. 概述](#1. 概述 "#1-%E6%A6%82%E8%BF%B0")
• [2. 安装](#2. 安装 "#2-%E5%AE%89%E8%A3%85")
• [3. 手柄配对](#3. 手柄配对 "#3-%E6%89%8B%E6%9F%84%E9%85%8D%E5%AF%B9")
• [4. 验证](#4. 验证 "#4-%E9%AA%8C%E8%AF%81")
• [5. 问题修复](#5. 问题修复 "#5-%E9%97%AE%E9%A2%98%E4%BF%AE%E5%A4%8D")
• [6. 卸载与更新](#6. 卸载与更新 "#6-%E5%8D%B8%E8%BD%BD%E4%B8%8E%E6%9B%B4%E6%96%B0")
• [7. 参考资料](#7. 参考资料 "#7-%E5%8F%82%E8%80%83%E8%B5%84%E6%96%99")

---

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. 手柄配对

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

一个适配器最多连接 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