Repolode
投稿する
yetone

yetone/alma-relay

Almaのデスクトップアプリをスマートフォンアプリから、ポートフォワーディングやVPNなしでアウトバウンド接続経由で操作できるセルフホスト型リレー。

GitHub で見る公式サイト
スター
461
フォーク
58
未解決の Issue
0
最終コミット
4 日前

これは何？

Alma Relayは、Alma Remote Access向けのセルフホスト型リレーです。デスクトップアプリからリレーへ接続を開始して接続を維持し、スマートフォンからのリクエストをリレーが受け取り、その接続を通じてデスクトップへ転送します。HTTP、ストリーミング（SSE）、WebSocketのトラフィックをすべて中継するため、受信ポートを開放したりVPNを使ったりせずに、どこからでもデスクトップにアクセスできます。

エンドツーエンド暗号化が有効な場合（新規ペアリングではデフォルト）、リレーが扱うのは暗号文のみです。スマートフォンとデスクトップがECDHハンドシェイクを行ってAES-256-GCMセッションを確立し、リレーはディスクに何も保存しません。無料プランのDurable Objectsを使うCloudflare Worker、自動HTTPSに対応したCaddyを含むDocker Compose構成、または独自のリバースプロキシの背後で動作する通常のNodeプロセスとして実行できます。

任意の設定として、利用者を制限する登録キーまたはユーザーごとの署名付きトークン、WebRTC経由のブラウザーのライブ表示に使うTURN認証情報、スマートフォンへの通知に使うAPNsキーを指定できます。

主な機能

  • 01スマートフォンからデスクトップへのHTTP、SSEストリーミング、WebSocketのトラフィックを転送します。
  • 02デスクトップからアウトバウンド接続するため、ポートフォワーディングもVPNも不要です。
  • 03AES-256-GCMセッションによるエンドツーエンド暗号化に対応し、リレーが扱うのは暗号文のみです。
  • 04Cloudflare Workersの無料プラン、自動HTTPS対応のDocker、または通常のNodeで動作します。
  • 05共有登録キーまたはユーザーごとのJWTトークンで、任意のアクセス制御を設定できます。

ユースケース

  • 外出先から、自宅のデスクトップ上のAlmaをスマートフォンで操作する。
  • 自分に近いリージョンや、自分で管理するインフラ上でリレーを稼働させる。
  • チームでリレーを共有しながら、メンバーごとにアクセス権を取り消す。
  • ホスト型リレーに依存せず、Alma Remote Accessを運用する。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/yetone/alma-relay && cd alma-relay
  2. 2

    依存関係をインストールする

    npm install
  3. 3

    Cloudflare Workers（無料プラン）にデプロイする

    npx wrangler deploy
  4. 4

    または、Node版をローカルでポート8787で実行する

    npm start

使う前に知っておきたいこと

  • セルフホスト型リレーでは、公式のAlma iOSアプリにスマートフォン通知を送信できません。
  • ライブブラウザビューでTURNを設定するには、追加の設定とファイアウォールポートの開放が必要です。
  • エンドツーエンド保護を完全に機能させるには、デスクトップ版でAlma 0.4.329以降を実行する必要があります。

収録されている特集

セルフホスト型アプリ

トピック

#remote-access#relay#websocket#end-to-end-encryption#self-hosted#cloudflare-workers#docker

よくある質問

alma-relay とは？
Almaのデスクトップアプリをスマートフォンアプリから、ポートフォワーディングやVPNなしでアウトバウンド接続経由で操作できるセルフホスト型リレー。 Alma Relayは、Alma Remote Access向けのセルフホスト型リレーです。デスクトップアプリからリレーへ接続を開始して接続を維持し、スマートフォンからのリクエストをリレーが受け取り、その接続を通じてデスクトップへ転送します。HTTP、ストリーミング（SSE）、WebSocketのトラフィックをすべて中継するため、受信ポートを開放したりVPNを使ったりせずに、どこからでもデスクトップにアクセスできます。
alma-relay は無料で使えますか？ライセンスは？
alma-relay は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
alma-relay は今もメンテナンスされていますか？
活発にメンテナンス中。alma-relay の最終コミットは 2026年11月2日 です。
alma-relay は何に使えますか？
外出先から、自宅のデスクトップ上のAlmaをスマートフォンで操作する。 自分に近いリージョンや、自分で管理するインフラ上でリレーを稼働させる。 チームでリレーを共有しながら、メンバーごとにアクセス権を取り消す。 ホスト型リレーに依存せず、Alma Remote Accessを運用する。
alma-relay のインストール方法は？
リポジトリをクローンする: git clone https://github.com/yetone/alma-relay && cd alma-relay 依存関係をインストールする: npm install Cloudflare Workers（無料プラン）にデプロイする: npx wrangler deploy または、Node版をローカルでポート8787で実行する: npm start
alma-relay はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/yetone/alma-relay

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト