Überblick
Der Relay-Server verbindet dein iPhone mit deinem Agenten. Standardmäßig verwenden beide das offizielle öffentliche Relay unter coding.btelo.com. Wir empfehlen, beim offiziellen Relay zu bleiben — es läuft auf 3 global verteilten Servern und funktioniert überall, auch wenn du dein Heimnetzwerk verlässt. Du kannst auch dein eigenes Relay betreiben, für maximale Privatsphäre, in deinem LAN oder auf einem öffentlichen Server.
LAN-Relay
Wenn du vollständige Privatsphäre benötigst und möchtest, dass dein Datenverkehr ausschließlich in deinem lokalen Netzwerk bleibt, kannst du ein LAN-Relay verwenden. Beachte, dass ein LAN-Relay nur funktioniert, wenn sich dein iPhone und dein Computer im selben Netzwerk befinden — das offizielle Relay ist für den täglichen Gebrauch die bessere Wahl.
Wechsle auf dem Agenten zum LAN-Relay:
- Desktop-App — öffne Einstellungen → Relay und wähle Lokales Relay (LAN).
- CLI-Agent — drücke w (Relay wechseln) und wähle Local Relay (LAN).
Der Agent startet automatisch einen lokalen Relay-Server und verbindet sich damit. Aktualisiere dann den Kopplungs-QR-Code und scanne ihn auf deinem iPhone erneut, um die Verbindung über das LAN-Relay herzustellen.
Selbst gehostetes öffentliches Relay
Dies ist im Wesentlichen dasselbe wie ein LAN-Relay, nur dass du es auf einem öffentlichen Server bereitstellst, sodass es aus jedem Netzwerk funktioniert.
Installiere Btelo Coding auf deinem VPS und führe es dann als Relay aus:
curl -fsSL https://coding.btelo.com/install.sh | sh
vibe-remote relay
Das Relay lauscht auf Port 24384 (TCP).
HTTPS mit Reverse Proxy
Für den Produktivbetrieb stelle das Relay hinter einen Reverse Proxy mit 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;
}
}
Konfiguriere dann Agent und iOS-App für die Verwendung von https://relay.example.com.
Einschränkungen des selbst gehosteten Relays
Apple Push Notifications sind nicht verfügbar auf selbst gehosteten Relays. Push-Benachrichtigungen erfordern APNs-Anmeldedaten (Apple-Developer-Schlüssel), die an die offizielle Btelo Coding-App gebunden sind. Selbst gehostete Relays können diese Anmeldedaten nicht erhalten. Daher erhältst du keine Push-Benachrichtigungen für abgeschlossene Aufgaben, wenn die iOS-App im Hintergrund ist — die App aktualisiert sich nur, wenn du sie öffnest.
Alle anderen Funktionen arbeiten auf selbst gehosteten Relays normal.