リレーサーバー

概要

リレーサーバーは iPhone とエージェントを接続します。デフォルトでは、両方とも coding.btelo.com の公式パブリックリレーを使用します。公式リレーの使用を推奨します — 世界中に分散された 3 台のサーバーで動作するため、自宅のネットワークを離れた場所でも、どこからでも動作します。最大限のプライバシーを確保するため、LAN またはパブリックサーバーで独自のリレーを実行することもできます。

LAN リレー

完全なプライバシーが必要で、トラフィックをローカルネットワーク内に完全に保持したい場合は、LAN リレーを使用できます。LAN リレーは iPhone とコンピューターが同じネットワーク上にある場合にのみ動作することに注意してください — 日常的な使用には公式リレーの方が適しています。

TUI で w（Switch Relay）を押し、Local Relay (LAN) を選択します。エージェントは自動的にローカルリレーサーバーを起動し、それに接続します。その後 r を押して QR コードを更新し、iPhone で再スキャンして LAN リレー経由で再接続します。

セルフホスト型パブリックリレー

基本的には LAN リレーと同じですが、パブリックサーバーにデプロイするため、どのネットワークからでも動作します。

VPS に Btelo Coding をインストールし、リレーとして実行します:

curl -fsSL https://coding.btelo.com/install.sh | sh
vibe-remote relay

リレーはポート 24384（TCP）でリッスンします。

リバースプロキシによる HTTPS

本番環境では、TLS を備えたリバースプロキシの背後にリレーを配置します:

server {
    listen 443 ssl;
    server_name relay.example.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:24384;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

その後、エージェントと iOS アプリで https://relay.example.com を使用するように設定します。

セルフホスト型リレーの制限

Apple プッシュ通知はセルフホスト型リレーでは利用できません。プッシュ通知には、公式 Btelo Coding アプリに紐づく APNs 認証情報（Apple Developer キー）が必要です。セルフホスト型リレーではこれらの認証情報を取得できません。そのため、iOS アプリがバックグラウンドにあるときは、完了したタスクのプッシュ通知を受け取ることができません — アプリを開いたときにのみ更新されます。

他のすべての機能はセルフホスト型リレーでも通常どおり動作します。