Show HN: Proxmox -> ネットワーク経由でホストのBluetoothをVMと共有する
Show HN: Proxmox -> Share your host's Bluetooth with a VM over the network (github.com)
要約
Proxmox仮想マシン(VM)でBluetoothが利用できない問題に対する解決策を提供するツールが公開されました。特にIntel製オンボードチップや特定のゲーミングOS環境で発生するBluetoothパススルーの失敗や不安定さを回避するため、ホストのBluetoothアダプターをネットワーク経由でVMに共有する仕組みです。このツールは、わずか2つのコマンドで設定でき、Linuxがサポートするあらゆるチップで動作し、再起動にも対応します。
全文翻訳
Proxmox Linux VM で Bluetooth を利用可能に。ついに。
[画像: Ko-fi] [画像: Buy Me a Coffee] [画像: GitHub Sponsors] [画像: License: MIT] [画像: Binary builds clean from BlueZ source]
要点: BluetoothアダプターをVMにUSBパススルーすると、チップがファームウェアをクリアしてしまい、ゲストが正しいドライバーとファームウェアブロブを持っていないと復旧できません。フルディストリビューションは通常これを管理しますが、Home Assistant OS、ChimeraOS、Bazziteなどの軽量またはイミュータブルなゲストではしばしば失敗し、Intelのオンボードコンボチップ(BE200、AX210、AX211)が最も深刻な問題を引き起こします。このツールはハンドオフを完全にスキップします。アダプターはホストに留まり、ネットワーク経由でVMに共有されます。2つのコマンドで、再起動にも対応します。まず通常のUSBパススルーを試してください。これはよりシンプルで、多くのセットアップで機能します。
Xbox / PlayStationコントローラー、ヘッドフォン、センサーなどを、Bluetoothチップが「パススルーできない」とされている場合でも、ゲーミングVM(ChimeraOS、Bazzite、Home Assistant、通常のLinux)の内部でペアリングできます。LXCコンテナも、別のトリック(フォーラムで不可能と言われているもの)を通じてサポートされます。
[画像: Steamでついに接続されたXboxコントローラー]
聞き覚えがありますか?
- ProxmoxでゲーミングVMを構築した。すべてうまくいく… Bluetooth以外は。
- コントローラーが点滅し続け、諦めてしまう。
- フォーラムで勧められたIntel BE200 / AX210カードを購入した。それでも何も起こらない。
qm set ... -usbを試したが、VMでデバイスは認識されたものの、それでも動作しなかった。- すべてのスレッドが「USBケーブルを使えばいい」という誰かのコメントで終わる。
あなたのせいでも、ハードウェアの故障でもありません。
ほとんどのBluetoothアダプターは、USBで再列挙されるときにファームウェアをクリアするため、パススルー後にゲストがゼロから再度ロードする必要があります。これはゲストが対応するドライバーとファームウェアブロブを持っている場合に機能するため、フルなDebianやArch VMが正常にパススルーできることが多いのです。しかし、ゲストがそれを持っていない場合に問題が発生します。Home Assistant OSやゲーミングディストリビューションは、軽量化されたカーネルと不完全なlinux-firmwareを出荷しており、IntelのCNViコンボチップ(BE200、AX2xx)は特に容赦がなく、ゲストが対応できないブートローダー状態になります。
したがって、これは「パススルーは決して機能しない」ということではありません。「パススルーは、ゲストがファームウェアのハンドシェイクを正しく行うかに依存し、一部のゲストはそれができない」ということです。このツールは、チップをまったく引き渡さないことで、その依存関係を排除します。
まず:簡単な方法を試してください
通常のUSBパススルーは多くのセットアップで機能します。通常のLinuxディストリビューション(Debian、Ubuntu)への通常のドングルは、しばしばそのまま機能します。
qm set <vmid> -usb0 host=<vendor:product>
これでVMでBluetoothが機能するようになったら、読むのをやめてください。このプロジェクトは必要ありません。安価なUSBドングルを試す価値もあります。フルディストリビューションに渡されたプレーンなドングルは、最もシンプルなセットアップであり、ゲストがファームウェアを持っていれば、そのまま機能します。
パススルーが機能しなかった場合、諦める前にこれをチェックしてください
アダプターはUSBで再列挙されるときにファームウェアをクリアするため、ゲストが再度ロードする必要があります。ほとんどのパススルーの失敗は、単にゲストがそのファームウェアを欠いているだけで、これはこのすべてなしで修正可能です。VM内で実行してください:
dmesg | grep -i -A2 bluetooth | grep -i "firmware\|failed"
Direct firmware load for ... failedのようなメッセージが表示されたら、ゲストはブロブを欠いているだけです。それをインストールしてVMを再起動してください:
# Debian (non-free-firmwareコンポーネントの有効化が必要)
sudo apt install firmware-iwlwifi # Intelチップ; 他のチップの場合は firmware-realtek, firmware-atheros など
# Ubuntu
sudo apt install linux-firmware # 注意: このパッケージはDebianには存在しません
# Fedora / ChimeraOS / Bazzite
sudo rpm-ostree install linux-firmware # 通常は既に存在します
これだけでも多くのケースが解決します。もしあなたのケースがこれで解決したなら、通常のパススルーを使用し、このプロジェクトはスキップしてください。
これは、それが利用できない場合や役に立たない場合のためのツールです:ゲストが対応できないブートローダー状態になるIntelオンボードコンボチップ(BE200/AX2xx)、ゲーミングディストリビューション(ChimeraOS/Bazziteの軽量カーネル+特殊なチップファームウェア)、Home Assistant OSやファームウェアパッケージをまったくインストールできないその他のアプライアンスイメージ、軽量化されたクラウドカーネル、およびVMの再起動後にスタックするドングル。
解決策:チップを引き渡さず、共有する。
チップは、正常に動作するProxmoxホストに残ります。小さなブリッジがローカルネットワーク経由でVMにストリーミングします。VMは完全に通常のBluetoothアダプターとして認識されます。レイテンシはコントローラー自体の無線遅延よりも低いため、感じることはありません。
BlueZ上に構築。 ブリッジ自体は、公式のBlueZプロジェクト(GPL-2.0-or-later)の既存ツールであるbtproxyであり、ここでは再実装されていません。このプロジェクトは、そのためのインストール/systemdツールです。完全な帰属表示とライセンステキストについては、THIRD_PARTY_LICENSES.mdを参照してください。
CIはコミットごとにアップストリームソースから再ビルドし、1バイトでも異なれば失敗します。完全な来歴と、自分で実行できるワンコマンドチェックについては、以下の「バンドルされたバイナリについて」を参照してください。
2つのコマンド。それだけです。
[画像: インストール、両側:ホストがチップを共有し、VMがXboxコントローラーをペアリング]
Proxmoxホストで:
curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash
以下のような表示が出ます:
==> Bluetooth adapters on this machine:
[0] hci0 - 70:08:10:A4:F1:45 (USB)
==> All adapters healthy. You are good to go.
==> Downloading btproxy (BlueZ 5.66 build, GPL-2.0-or-later, not our code)...
==> Checksum verified against the hash pinned in this script.
==> Bluetooth (hci0) is now shared on 192.168.1.3:9700.
Now run this INSIDE your VM:
curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash -s -- 192.168.1.3
!! Port 9700 is open to your whole LAN and has no password.
Whichever machine connects first gets the Bluetooth chip.
Once you know your VM's IP, restrict it:
curl -fsSL .../install.sh | sudo bash -s -- --allow <vm-ip>
最後の警告は定型文ではなく、正直なデフォルトです。そのままにしておく前に、Is this secure? を読んでください。(スクリプトが単独で実行されるときに「Downloading」と「Checksum」の行が表示されます。gitクローンからは、ローカルのbin/コピーが使用されます。)
ルートにスクリプトをパイプしたり、自分でビルドしていないバイナリを実行したくないですか? 当然です。--buildは、公式BlueZソースからお使いのマシンでブリッジをコンパイルし、Four ways to install はそれと完全に手動のルートをカバーしています。
何をすべきか:最後の行を正確にコピーし(IPアドレスは異なります)、VM内で実行します。
VM内では、以下のような表示が出ます:
==> Done. This VM now has working Bluetooth. Go pair your controller.
何をすべきか:VMのBluetooth設定を開き、通常通りペアリングします。それだけです。
両側とも起動時に自動開始し、自動再接続します。一度設定すれば、存在を忘れることができます。
4つのインストール方法
4つの方法すべてが同じ結果につながります。信頼の度合いが異なるだけで、リストは少ない方から多い方へ並んでいます。上記のワンライナーは3番目です。
1. スクリプトなし、バイナリもなし。 MANUAL_INSTALL.md は、公式BlueZソースからbtproxyをビルドし、systemdユニットを手動で記述する方法を説明しています。すべて(VM再起動後にブリッジがスタックするのを防ぐ小さな再起動ラッパーを含む)に従えば、同じ結果が得られます。install.shはこれを自動化するだけです。
2. スクリプトあり、バイナリはなし。
curl -fsSL -O https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh
less install.sh # 読みやすいbash、最小化や難読化なし
sudo bash install.sh --build
--buildは、カーネル.orgのBlueZ 5.66 tarballからお使いのマシンでbtproxyをコンパイルし、tarball自体のSHA-256をbuild.shにピン留めしてインストールします。このリポジトリから事前にビルドされたものはダウンロードまたは実行されません。ツールチェーンのインストールが必要で、数分かかります。そのため、デフォルトではなくオプトインになっています。イミュータブルなゲスト(ChimeraOS、Bazzite)にはツールチェーンをインストールする方法がなく、事前にビルドされたバイナリしか使用できません。
既にbtproxyをお持ちですか? その場合は、これらは不要です。install.shはPATHにあるbtproxyを使用し、独自のコピーをインストールしないため、Archでのpacman -S bluez-utilsやステップ1からの手動ビルドで十分です。--uninstallはそれを触りません。
3. まず読んで、それから実行。 上記と同じですが、--buildなしです。スクリプトはbin/btproxy-x86_64を取得し、スクリプト自体にピン留めされたSHA-256と比較検証し、一致しないものはインストールを拒否します。そのバイナリは、ワンコマンドでreproducible from upstream sourceです。
4. クローンする。 すべてが開始前に存在し、スクリプトはダウンロードではなくローカルのbin/コピーを使用します:
git clone https://github.com/lucid-fabrics/proxmox-bluetooth
cd proxmox-bluetooth && sudo ./install.sh
バンドルされたバイナリについて
完全な来歴を4つのポイントで示します。
これは私たちのコードではありません。 bin/btproxy-x86_64は、BlueZ自体のbtproxyの変更されていないビルドです。このプロジェクトは、ブリッジではなく、そのためのインストールツールを作成しました。完全な帰属表示、3つのアップストリームライセンス(GPL-2.0-or-later、LGPL-2.1-or-later、BSD-2-Clause)、および書面によるソース提供の申し出は、THIRD_PARTY_LICENSES.mdにあります。
なぜapt installしないのか? これらのディストリビューションでは、btproxyはパッケージ化されていないためです。bluezはもちろんパッケージ化されていますが、そのパッケージにはこの特定のツールは含まれていません:
| Distro | Ships btproxy? | |
|---|---|---|
| Debian / Ubuntu | no | `dpkg -L bluez bluez-test-tools |
| Fedora (and Fedora Atomic: ChimeraOS, Bazzite) | no | `dnf repoquery -l bluez |
| Arch | yes | bluez-utils に含まれています |
ProxmoxはDebianであり、このツールが存在するゲストはDebian/UbuntuまたはFedora Atomicであるため、実際にはソースからのビルドが唯一のルートです。Archでは、単にpacman -S bluez-utilsを実行します。install.shはPATH上のbtproxyを見つけ、バイナリをインストールしません。または、このリポジトリを完全にスキップし、MANUAL_INSTALL.mdからsystemdユニットのみを取得することもできます。
実行環境。 これはx86_64のみです(ARMビルドはありません。arm64では自分でビルドする必要があります。詳細はMANUAL_INSTALL.mdを参照してください)。意図的にDebian 12上でコンパイルされているため、GLIBC_2.34より新しいものは必要なく、glibcにのみリンクします:
| Target | glibc | |
|---|---|---|
| Proxmox 8 host (Debian 12) | 2.36 | クリーンに起動します |
| Proxmox 9 host (Debian 13) | 2.41 | 完全なブリッジが実際のハードウェアでエンドツーエンドでテスト済み |
| Debian 12+ / Ubuntu 22.04+ guests | 2.35+ | クリーンに起動します |
| Fedora / ChimeraOS / Bazzite guests | 2.38+ | クリーンに起動します |
glibc 2.34以降を持つものはすべて実行できます。「クリーンに起動します」とは、その行のコンテナで検証されたことを意味します。Proxmox 9行のみが、実際のハードウェアに対してブリッジ全体を実行しました。CIは、要件がglibc 2.36を超えると、Proxmox 8をサイレントに壊すため、常に失敗します。
約1分で自分で検証してください。 期待されるハッシュはinstall.sh内にピン留めされているため、バイナリと同じ場所から取得するのではなく、既に読んだスクリプトの一部です:
grep BTPROXY_SHA256 install.sh # 期待されるハッシュ
sha256sum bin/btproxy-x86_64 # 実際にあるもの
install.shは一致しないものをインストールすることを拒否し、削除します。
バイト単位で再現可能です。 Debian 12上でBlueZ 5.66をビルドすると、コミットされたバイナリとまったく同じSHA-256が得られます。CIはコミットごとにこれをチェックします。カーネル.orgのtarballから再ビルドし、結果がbin/にあるものと異なる場合は失敗します。したがって、バッジは「いくつかのバイナリがコンパイルされる」ということではなく、「実行しようとしているファイルは、そのソースをコンパイルしたものである」ということです。ワンコマンドで自分で確認できます:
docker run --rm --platform linux/amd64 -v "$PWD":/w -w /w debian:bookworm bash -c \
'bash build.sh && cmp bin/btproxy-x86_64 build/btproxy-x86_64 && echo IDENTICAL'
(ARMホストでは--platform linux/amd64が重要です。これがないとDockerはarm64イメージをプルし、aarch64ビルドとx86_64ビルドを比較することになります。)
(再現性は、そのコンテナイメージにピン留めされています。異なるディストリビューションやコンパイラバージョンでは、同じソースから異なるバイトを生成する可能性があるため、出荷されたビルドとCIの両方でDebian 12が使用されています。)または、自分でビルドして代わりに実行してください。MANUAL_INSTALL.md がその方法を説明しています。
私のチップは動作しますか?
Proxmoxホストが認識できれば、VMでも使用できます。ホストでこれを実行してください:
curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash -s -- --check
正常であれば、以下のような表示が出ます:
==> Bluetooth adapters on this machine:
[0] hci0 - 70:08:10:A4:F1:45 (USB)
==> All adapters healthy. You are good to go.
何をすべきか:何もしない - 上記のインストールコマンドを実行します。
チップがスタックしたIntelチップの場合、以下のような表示が出ます:
!! hci0 is NOT responding (stuck in bootloader).
Fix: shut down, flip the power supply switch OFF for 15 seconds, boot.
A reboot or the front power button is NOT enough. See README.
何をすべきか:指示通りに実行してください。これは極端に見えますが、実際に機能する唯一の方法です。詳細は以下のFAQを参照してください。
実際のユーザーによって確認されています(PRであなたの情報も追加してください):
| Hardware | Status |
|---|---|
| Intel BE200 | ✅ テスト済み - このリポジトリはそれのおかげで存在します |
| Intel AX200 / AX210 / AX211 | ✅ 同じファミリー、同じ動作 |
| MediaTek MT7921 / MT7922 | ✅ 標準的なLinuxサポート |
| Generic CSR / Realtek USB dongles | ✅ ホストのLinuxが対応するものはすべて |
| UGREEN "BT 6.0" dongles (Barrot chip) | ❌ Linux上ではファームウェアが壊れています。ブリッジを使用しても無効です。避けてください。 |
すべてのコマンド
適用されるマシンでこれらのコマンドを実行してください。curl | bashの下に、-s --の後にコマンドを追加します。例:curl -fsSL <url>/install.sh | sudo bash -s -- --status。
| Command | Where | What it does |
|---|---|---|
install.sh | host | このマシンのBluetoothを共有する |
install.sh <host-ip> | VM | 共有アダプターに接続する |
install.sh --check | host | アダプターをリストし、スタックしたチップをフラグ付けする |
install.sh --status | either | 問題発生時はここから開始。 両側を表示する |
install.sh --report | either | バグレポート用のペースト可能な診断バンドルを出力する |
install.sh --adapter N | host | 複数のチップがある場合に1つを選択する |
install.sh --allow <ip/cidr> | host | ポート9700を1つのアドレスに制限する |
install.sh --allow-any | host | その制限を解除する |
install.sh --build | either | バイナリの代わりにBlueZソースからbtproxyをコンパイルする |
install.sh --pause | host | Bluetoothを一時的にホストに戻す(再起動まで) |
install.sh --resume | host | VMに再度渡す |
install.sh --lxc <ctid> | host | LXCコンテナにホストBluetoothを共有する(フィルタリングされたD-Bus) |
install.sh --lxc-remove <ctid> | host | 1つのコンテナのLXC共有を元に戻す |
install.sh --uninstall | either | すべてを削除し、通常のBluetoothを復元する |
動作しない場合
まず--statusを実行してください。どちら側が壊れているかがわかります。次に:
| Symptom | Look at |
|---|---|
| VMにアダプターが表示されない | VM内で journalctl -u btproxy-client -n 30 を確認 |
| ホストは共有していると言うが、VMが接続しない | IPアドレスが間違っているか、--allowルールがVMの実際のソースアドレスをブロックしている。VM内で ip route get <host-ip> で確認 |
| アダプターは表示されるが、ペアリングできない | VM内で bluetoothctl show を確認。Powered: no の場合は、bluetoothctl power on を実行 |
| 以前は動作していたが、VM再起動後に停止した | ホストで systemctl restart btproxy-server を実行 |
--check がチップがスタックしていると表示する | PSUスイッチを15秒間オフにしてから電源を入れ直してください。FAQを参照 |
VM側では、--statusはホスト自体をプローブし、「ホストで共有が一時停止されている」、「ホストの--allowルールがこのVMをブロックしている」、「IPアドレスが間違っているかホストがダウンしている」の違いを伝えます。したがって、ログを読む前にまずそこから始めてください。
それでも問題が解決しない場合は、両方のマシンで--reportを実行し、2つの出力を添えてイシューを開いてください。ステータス、ログ、アダプター、ファイアウォール状態を1つのペースト可能なブロックに収集します。
FAQ、分かりやすく
コントローラーに遅延はありますか?
いいえ。ブリッジは同じマシン上で1ミリ秒未満の遅延を追加します。Bluetooth自体の方が遅いです。
ヘッドフォン、キーボード、Home Assistantセンサーでも動作しますか?
はい。ブリッジはプロトコル透過的です(生のBluetoothトラフィックを転送し、理解したりフィルタリングしたりしません)。通常のLinux Bluetoothアダプターで機能するものはすべて機能します:コントローラー、オーディオ、HID、Home Assistant用のBLEセンサー。
複数のデバイスを同時にペアリングできますか?
はい。VM内では通常のアダプターとまったく同じように動作します。コントローラー2台とヘッドフォンでも問題ありません。一度に1台という制限はVM(1つのVMがチップを所有する)に関するもので、デバイスに関するものではありません。
何か購入する必要がありますか?
いいえ。既にお持ちのカードで動作します。交換した古いカードでさえ、おそらく動作したはずです。
VM全体が「クラッシュ」しました(ChimeraOS / Bazziteで、黒い画面、ネットワークなし)。
クラッシュしたのではなく、スリープ状態になりました。ゲーミングディストリビューションはSteam Deckのようにアイドル後に自動的にサスペンドしますが、GPUパススルーを備えたVMはそこから復帰しません。VM内でサスペンドを恒久的に無効にしてください:sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target
コントローラーはペアリングされるが、Steam(ChimeraOS / Bazzite)で何も応答しない。
これはBluetoothではなく、入力レイヤーの既知の不具合です。sudo systemctl restart inputplumberを実行し、コントローラーの電源をオフにしてからオンにしてください。これで解決します。
Intelカードが完全に無反応に見えます。アダプターなし、不気味なログ行。
ブランクのブート状態にスタックしています。マシンをシャットダウンし、電源供給スイッチを15秒間オフにしてから起動してください。再起動や前面の電源ボタンでは不十分です。この一つのトリックで丸一日かかりました。どういたしまして。
ホストに複数のBluetoothチップがあります。
--checkは、見つかったすべてのアダプター(hci0、hci1など)をMACアドレスとともにリストし、区別できるようにします。複数のアダプターが見つかった場合、推測せず、選択を求めます。1つを選択して共有するには ./install.sh --adapter 1 を使用します。同時に2つのチップを2つの異なるVMにブリッジすることはまだサポートされていません(現在、ホストあたり1つのインストール)。もし必要ならイシューを開いてください。これは小さな変更で済みます。
VMがクラッシュした / VMを再構築した / 別のVMでBluetoothを使いたい。
新しいVMでクライアントのワンライナーを実行するだけです。ホストは接続してきたVM(一度に1つ)にサービスを提供します。クラッシュしたVMの後にクリーンアップする必要はありません。古いVMがまだ実行中の場合は、まずクライアントを停止してください(そこで--uninstallを実行)。注意点:ペアリングはゲスト内に保存されるため、新しいVMでデバイスを一度ペアリングし直してください。
ChimeraOS / Bazziteのアップデートでも動作しますか?
はい。これらのディストリビューションはアップデート時にシステムイメージを置き換えますが、/etcと/varは保持します。これはまさにこのツールがインストールされる場所です。ブリッジとペアリングは自動的に復元されます。
ホスト自身のBluetoothは失われますか?
はい、共有中はそうです。クローゼットの中のサーバーでは、ほとんど気にならないでしょう。一時的に戻す必要がありますか? --pauseはチップをホストに戻し、--resumeはVMに再度渡します(VMは自動的に再接続します)。注意:--pauseは永続的ではありません。サービスは停止しますが、有効なままなので、ホストの再起動で共有が再開されます。--uninstallはすべてを完全に削除します。
これは安全ですか?
トレードオフを認識してください。btproxyはポート9700でプレーンな認証なしのTCPを話すため、デフォルトではLAN上のどのマシンが最初に接続してもBluetoothチップを取得できます。生のHCIアクセスは、そのマシンがラジオを読み取るだけでなく、操作できることを意味します。
VMにロックしてください:
./install.sh --allow 192.168.1.50 # 単一VM
./install.sh --allow 192.168.1.0/24 # または信頼できるサブネット
これにより、ポート9700をそのアドレスから受け入れ、それ以外からはドロップするnftablesルール(独自のproxmox-bluetoothテーブルにインストールされるため、pve-firewallを妨害しません)がインストールされます。これはサービスに紐付けられ、起動時にロードされます。ルールがロードに失敗した場合、保護なしで起動するのではなく、サービスは起動を拒否します。--uninstallはこれを削除し、設定は保持されるため、後でプレーンな再インストールでポートがサイレントに開かれることはありません(実際に開きたい場合は--allow-anyを使用してください)。
VMの実際のソースIPを使用してください。複数のインターフェースを持つマシンは、予期しないアドレスからホストに到達する可能性があります。VM内で ip route get <host-ip> で確認してください。
暗号化もありませんので、信頼できるLANツールとして扱ってください。ホストとそのVM間では問題ありませんが、制御できないネットワークを越えてルーティングするようなものではありません。
範囲が狭い? デバイスが近くでしかペアリングできない?
それはアンテナの問題であり、ブリッジではありません。M.2カードには2本の小さなアンテナケーブルを接続する必要があります。金属ケース内の裸のカードはほとんど届きません。USBドングル:前面ポートまたは短い延長ケーブルは、他のすべてのケーブルの隣にある背面ポートよりも優れています。
Windows VMはどうですか?
このブリッジはLinuxゲスト用です(LinuxのBluetoothスタックに依存します)。Windows VMは通常この問題を抱えません。qm set <vmid> -usb0 host=<id>でUSBドングルを直接パススルーすると、通常はそのまま動作します。このツールは、Windowsが平気な場所でLinuxゲストが問題を起こすために存在します。
LXCコンテナはどうですか?
サポートされており、VMとは異なる方法で動作します。カーネルは最初のネットワーク名前空間でのみBluetoothソケットを許可するため、BlueZは(フォーラムの「デバイスをバインドする/cgroupを許可する」レシピがすべて失敗する理由です)どんなに特権があってもコンテナ内で実行できません。代わりに、ホストがアダプターを保持し、bluetoothdを実行します。コンテナは、org.bluezのみを公開するフィルタリングされたD-Busプロキシを通じてそれに話しかけます:
curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/proxmox-bluetooth/main/install.sh | sudo bash -s -- --lxc <ctid>
特権および非特権コンテナで動作します。コンテナ内(Docker/Home Assistant用など)の環境変数または-vマウントとして、追加する1行を出力します。Home Assistant BLEセンサーに最適です。ペアリングはホストの/var/lib/bluetoothに保存されます。注意:ホストは、アダプターをVMにブリッジするか、コンテナと共有するか、どちらか一方のみです。VMブリッジは、ホストのbluetoothdを停止することで正確に機能します。
Proxmox専用ですか?
いいえ。KVM VMを持つ任意のLinuxホスト(または単に2つの別々のマシン)でも可能です。Proxmoxは問題が最も顕著な場所です。
好奇心旺盛な方へ:実際何が起こっているのか
Intel CNVi Bluetooth(BE200/AX2xx)は、ホストのbtusb/btintelドライバーが起動時にファームウェアをロードすることを要求します。USBリダイレクト、vfio、ドライバーアンバインドなどのパススルーハンドオフは、チップをROMブートローダーにリセットし、ゲストはファームウェアハンドシェイクを完了できません。
ブリッジは、公式BlueZソースツリーのbtproxyです(ディストリビューションパッケージには含まれていません)。ホストでは、HCIユーザーチャネルモードでアダプターを開き、TCP経由で生のHCIを提供します。ゲストでは、hci_vhciを介して仮想コントローラーを作成し、ストリームをそれにパイプします。ゲストのBlueZはそれを知らず、気にしません。
Systemdユニット:btproxy-server.service(ホスト、bluetooth.serviceを置き換える)とbtproxy-client.service(ゲスト、ドロップイン経由でbluetooth.serviceの前に順序付けられる)。
バンドルされたバイナリは、bluez 5.66のtools/btproxyをプレーンな-O2でビルドしたものです(autoconfのデフォルト-g -O2を置き換え、stripでデバッグ情報が残らないようにしています)。glibcにのみリンクします。詳細はbuild.shおよび、そのバイナリが持つ3つのアップストリームライセンスについてはTHIRD_PARTY_LICENSES.mdを参照してください。
このプロジェクトをサポートする
この修正には、丸一日の頭を悩ませ、3回の「デッド」再起動、そして電源スイッチへの実際のウォークが必要でした。これにより、他の誰もその一日を無駄にすることはありません。このようなツールが無料で維持される理由はただ一つ:助けられた人々が次の人を助けることを選ぶからです。もし今あなたがその一人なら、ありがとうございます。これは本当にこれを生かし続けています。
[画像: Support on Ko-fi] [画像: Buy Me a Coffee] [画像: GitHub Sponsors]
アンインストール
復元したい方のマシンで、同じスクリプトに--uninstallを付けて実行します。
ライセンス
このリポジトリ自体のコード(install.sh、build.sh、docs)はMITライセンスです。詳細はLICENSEを参照してください。バンドルされたbin/btproxy-x86_64バイナリは、変更されていないサードパーティのBlueZコードで、GPL-2.0-or-later(LGPL-2.1およびBSD-2-Clauseの部分を含む)ライセンスです。詳細はTHIRD_PARTY_LICENSES.mdを参照してください。install.shは、その通知とGPLソース提供の申し出をバイナリと共に/usr/local/share/doc/proxmox-bluetooth/に書き込みます。
Proxmox Server Solutions GmbHまたはBlueZプロジェクトとは提携しておらず、承認も受けていない独立したコミュニティプロジェクトです。「Proxmox」はProxmox Server Solutions GmbHの登録商標であり、その他の名称はそれぞれの所有者に帰属します。