コンテンツにスキップ

Snap/Flatpak Linux でブリッジが接続できない

**要点:**サンドボックス化された(Snap または Flatpak の)Thunderbird は atbridge.ai のヘルパーを起動できないため、アドオンが接続できません。ヘルパーを バックグラウンドサービスとして実行し (atbridge bridge service install && atbridge bridge service start)、 atbridge bridge pair で得たトークンでアドオンをループバック経由でペアリング してください — または thunderbird.net から Thunderbird を再インストールします。

Linux で、atbridge.ai が 「動いていたのに止まった」、@bridge アドオンが 接続できない、あるいはアクティベーションが曖昧なエラーで失敗する (かつ ~/.atbridgelicense.json がない)場合、原因はほぼ確実に Thunderbird のインストール方法であって、ライセンスではありません。

atbridge.ai は小さなローカルヘルパー(ネイティブメッセージングホスト)を介して Thunderbird とやり取りします。通常、Thunderbird はそのヘルパーを自身で 起動します。SnapFlatpak は Thunderbird をセキュリティ サンドボックス内で実行し、外部プログラムの起動を禁止します — そのため ヘルパーが起動せず、アドオンが接続できません。これは特に Ubuntu ユーザーに 影響します:Ubuntu App Center は既定で Thunderbird を Snap として インストールします。

**朗報:**Thunderbird を再インストールする必要はありません。サンドボックス化 された Thunderbird でもローカルネットワーク接続は行えるため、atbridge.ai は ループバックフォールバックを用意しています — ヘルパーを自分で小さな バックグラウンドサービスとして実行し、アドオンは 127.0.0.1 経由で接続します。 一度設定すれば、そのまま使えます。

ステップ 1 — Thunderbird のインストール方法を確認する

Section titled “ステップ 1 — Thunderbird のインストール方法を確認する”
  1. ターミナルで次を実行します:

    Terminal window
    snap list 2>/dev/null | grep -i thunderbird
    flatpak list 2>/dev/null | grep -i thunder
    which thunderbird
  2. Thunderbird が snap または flatpak の下に表示される場合は、下記の ループバックフォールバックを使ってください。(ディストリビューションの パッケージや Mozilla の tarball による /usr/bin/thunderbird のような 通常のパスであれば、これらは一切不要です。)

ステップ 2 — ブリッジをバックグラウンドサービスとして実行する

Section titled “ステップ 2 — ブリッジをバックグラウンドサービスとして実行する”

これによりヘルパーが単独で(systemd --user サービスとして)実行され、 サンドボックス化された Thunderbird がヘルパーを起動せずともループバック経由で 到達できるようになります。

  1. サービスをインストールして起動します:

    Terminal window
    atbridge bridge service install
    atbridge bridge service start
  2. 起動していることを確認します:

    Terminal window
    atbridge bridge service status

    active になっていれば OK です。(ログイン時に自動でも起動します。)

ステップ 3 — アドオンをサービスとペアリングする

Section titled “ステップ 3 — アドオンをサービスとペアリングする”

アドオンはあなたのマシン上のファイルを読めないため、そのアドオンだけが サービスとやり取りできるよう、使い捨てのトークンを渡します(任意の Web ページが 接続することはできません)。

  1. トークンを表示します:

    Terminal window
    atbridge bridge pair

    表示された token の値をコピーします。

  2. Thunderbird で **atbridge.ai → 設定 → 詳細 → ローカルブリッジ (Snap/Flatpak)**を開きます。トークンを貼り付け、ループバック フォールバックを有効化にチェックを入れ、保存をクリックします。 (変更していない限り、ポートは 45678 のままにしてください。)

Terminal window
atbridge bridge ping
atbridge connect status

bridge ping からの応答は、Thunderbird と atbridge.ai がループバック経由で やり取りできていることを意味します。まだであれば、次に プランをアクティベートしてください。

Was this page helpful?