HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Proxmox -> ネットワーク経由でホストのBluetoothをVMと共有する

Show HN: Proxmox -> Share your host's Bluetooth with a VM over the network (github.com)

21 pointsby wmehanna8 コメント

要約

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はもちろんパッケージ化されていますが、そのパッケージにはこの特定のツールは含まれていません:

DistroShips btproxy?
Debian / Ubuntuno`dpkg -L bluez bluez-test-tools
Fedora (and Fedora Atomic: ChimeraOS, Bazzite)no`dnf repoquery -l bluez
Archyesbluez-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にのみリンクします:

Targetglibc
Proxmox 8 host (Debian 12)2.36クリーンに起動します
Proxmox 9 host (Debian 13)2.41完全なブリッジが実際のハードウェアでエンドツーエンドでテスト済み
Debian 12+ / Ubuntu 22.04+ guests2.35+クリーンに起動します
Fedora / ChimeraOS / Bazzite guests2.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であなたの情報も追加してください):

HardwareStatus
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。

CommandWhereWhat it does
install.shhostこのマシンのBluetoothを共有する
install.sh <host-ip>VM共有アダプターに接続する
install.sh --checkhostアダプターをリストし、スタックしたチップをフラグ付けする
install.sh --statuseither問題発生時はここから開始。 両側を表示する
install.sh --reporteitherバグレポート用のペースト可能な診断バンドルを出力する
install.sh --adapter Nhost複数のチップがある場合に1つを選択する
install.sh --allow <ip/cidr>hostポート9700を1つのアドレスに制限する
install.sh --allow-anyhostその制限を解除する
install.sh --buildeitherバイナリの代わりにBlueZソースからbtproxyをコンパイルする
install.sh --pausehostBluetoothを一時的にホストに戻す(再起動まで)
install.sh --resumehostVMに再度渡す
install.sh --lxc <ctid>hostLXCコンテナにホストBluetoothを共有する(フィルタリングされたD-Bus)
install.sh --lxc-remove <ctid>host1つのコンテナのLXC共有を元に戻す
install.sh --uninstalleitherすべてを削除し、通常のBluetoothを復元する
動作しない場合

まず--statusを実行してください。どちら側が壊れているかがわかります。次に:

SymptomLook 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の登録商標であり、その他の名称はそれぞれの所有者に帰属します。