Serveur relais

Utilisez un relais LAN ou déployez votre propre serveur relais public.

Vue d'ensemble

Le serveur relais connecte votre iPhone à votre agent. Par défaut, les deux utilisent le relais public officiel à coding.btelo.com. Nous recommandons de conserver le relais officiel — il s'exécute sur 3 serveurs distribués à l'échelle mondiale, il fonctionne donc partout où vous vous trouvez, même lorsque vous quittez votre réseau domestique. Vous pouvez également exécuter votre propre relais pour une confidentialité maximale, sur votre LAN ou sur un serveur public.

Relais LAN

Si vous exigez une confidentialité totale et souhaitez que votre trafic reste entièrement dans votre réseau local, vous pouvez utiliser un relais LAN. Notez qu'un relais LAN ne fonctionne que lorsque votre iPhone et votre ordinateur sont sur le même réseau — le relais officiel est un meilleur choix pour un usage quotidien.

Appuyez sur w (Switch Relay) dans la TUI et sélectionnez Local Relay (LAN). L'agent démarrera automatiquement un serveur relais local et s'y connectera. Appuyez ensuite sur r pour rafraîchir le QR code et scannez-le à nouveau sur votre iPhone pour vous reconnecter via le relais LAN.

Relais public auto-hébergé

C'est essentiellement la même chose qu'un relais LAN, sauf que vous le déployez sur un serveur public afin qu'il fonctionne depuis n'importe quel réseau.

Installez Btelo Coding sur votre VPS, puis exécutez-le en tant que relais :

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

Le relais écoute sur le port 24384 (TCP).

HTTPS avec proxy inverse

En production, placez le relais derrière un proxy inverse avec 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;
    }
}

Configurez ensuite l'agent et l'application iOS pour utiliser https://relay.example.com.

Limitations d'un relais auto-hébergé

Les notifications push Apple ne sont pas disponibles sur les relais auto-hébergés. Les notifications push nécessitent des identifiants APNs (clés Apple Developer) liés à l'application officielle Btelo Coding. Les relais auto-hébergés ne peuvent pas obtenir ces identifiants. Par conséquent, lorsque l'application iOS est en arrière-plan, vous ne recevrez pas de notifications push pour les tâches terminées — l'application ne se mettra à jour que lorsque vous l'ouvrirez.

Toutes les autres fonctionnalités fonctionnent normalement sur les relais auto-hébergés.