简而言之：Proxmox 的蓝牙直通在 Intel 板载芯片（BE200，AX210，AX211 - 由于硬件设计，无法通过设置修复）上失败，并且在 ChimeraOS 和 Bazzite 等游戏发行版上不可靠。这个工具则通过网络与虚拟机共享主机的蓝牙 - 两个命令，适用于任何 Linux 支持的芯片，重启后依然有效。控制器、耳机和 Home Assistant 传感器均可正常工作。在你的游戏虚拟机（ChimeraOS、Bazzite、Home Assistant、普通 Linux）中配对你的 Xbox / PlayStation 控制器、耳机或传感器 - 即使是那些 "不能直通" 的蓝牙芯片。听起来很熟悉？你在 Proxmox 上构建了一个游戏虚拟机。一切正常……除了蓝牙。你的控制器只是在闪烁，闪烁，闪烁，然后就放弃了。你买了 Intel BE200 / AX210 卡，因为论坛上说可以。仍然没有任何反应。你尝试过 qm set ... -usb , 在虚拟机中看到了设备，但它仍然拒绝工作。每个主题的结尾总是有人说 "只需使用 USB 电缆"。这不是你的错，你的硬件没有坏。Intel 设计它们的蓝牙芯片，使得只有启动它们的机器才能驱动它们。当 Proxmox 将芯片交给虚拟机时，它就清空了自己。没有设置可以修复这一点。这是芯片的物理特性。首先：尝试简单的事情。普通 USB 直通在许多设置上都有效 - 一个普通的加密狗在正常的 Linux 发行版（Debian，Ubuntu）上通常可以正常工作：qm set < vmid > -usb0 host=< vendor:product > 如果这在你的虚拟机中获得了工作蓝牙，停止阅读 - 你不需要这个项目。这个项目存在于它无法工作的情况下：Intel 板载芯片（BE200 / AX2xx - 从未工作，由设计决定）、游戏发行版（ChimeraOS / Bazzite 内核 + 古怪的芯片固件）、修剪过的云内核，以及在几次虚拟机重启后卡住的加密狗。解决方法：不要交出芯片。共享它。芯片保持在你的 Proxmox 主机上，正常工作。一个小桥接通过本地网络将其流入虚拟机。你的虚拟机看到一个完全正常的蓝牙适配器。延迟低于控制器自己的无线延迟 - 你永远不会感受到它。两个命令。就这样。在 Proxmox 主机上：curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash 你会看到类似这样的内容：==> 此机器上的蓝牙适配器：[0] hci0 - 70:08:10:A4:F1:45 (USB) ==> 所有适配器正常。你可以开始使用了。==> 蓝牙 (hci0) 现在在 192.168.1.3:9700 上共享。现在在你的虚拟机内运行这个：curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash -s -- 192.168.1.3 要做什么：精确复制那最后一行（你的 IP 会不同），并在虚拟机内运行它。在虚拟机内，你会看到：==> 完成。这个虚拟机现在有正常工作的蓝牙。去配对你的控制器吧。要做什么：在虚拟机中打开蓝牙设置并正常配对。就这样。两侧在启动时自动启动并自动重新连接。一次设置，忘记它的存在。我的芯片能工作吗？如果你的 Proxmox 主机能看到它，你的虚拟机就能使用它。在主机上运行以下命令：curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash -s -- --check 如果它正常工作，你会看到：==> 此机器上的蓝牙适配器：[0] hci0 - 70:08:10:A4:F1:45 (USB) ==> 所有适配器正常。你可以开始使用了。要做什么：没什么 - 运行上述的安装命令。如果你的芯片是卡住的 Intel 芯片情况，你会看到：!! hci0 未响应（卡在引导加载程序中）。修复：关闭电源，关闭电源开关 15 秒，重启。重启或前面电源按钮是不够的。请参见 README。要做什么：按它所说的去做。这看起来很极端，但这是实际有效的唯一方法 - 有关原因，请参见下面的常见问题解答。由真实的人确认（用 PR 加入你的）：硬件状态 Intel BE200 ✅ 测试通过 - 该存储库正是因为它而存在 Intel AX200 / AX210 / AX211 ✅ 同一家族，行为相同 MediaTek MT7921 / MT7922 ✅ 标准 Linux 支持 通用 CSR / Realtek USB 加密狗 ✅ 任何你的主机 Linux 驱动的设备 UGREEN "BT 6.0" 加密狗（Barrot 芯片）❌ Linux 上的固件损坏，无论是桥接与否，避免使用。常见问题，以人类语言 Will my controller lag? 不会。桥接在同一机器上增加的延迟远低于一毫秒。蓝牙本身更慢。Does it work for headphones, keyboards, Home Assistant sensors? 是的 - 桥接是协议透明的（它转发原始蓝牙流量，它不理解或过滤）。任何在普通 Linux 蓝牙适配器上工作的东西都正常：控制器、音频、HID、BLE 传感器用于 Home Assistant。Can I pair several devices at once? 可以。在虚拟机中，它的行为完全像一个普通适配器 - 两个控制器加耳机没问题。一次连接的限制是关于 VMs（一个虚拟机拥有芯片），而不是设备。Do I need to buy anything? 不用。你已经拥有的卡是可以工作的。即使你更换的老卡也可能工作。我的整个虚拟机 "崩溃" - 黑屏，没有网络（ChimeraOS / Bazzite）。它没有崩溃 - 它进入了睡眠。游戏发行版在闲置后会自动挂起