Cloudflare Tunnel Einrichtung

Mit Cloudflare Tunnel verbindest du dich von jedem Netzwerk aus mit deinem Mac -- Mobilfunk, anderes WLAN oder von der anderen Seite der Welt. Keine Portweiterleitung oder Router-Änderungen nötig.

Wann verwenden

• Dein iPhone ist in einem anderen Netzwerk als dein Mac (z. B. unterwegs).
• Dein Netzwerk blockiert direkte Geräte-zu-Geräte-Verbindungen.
• Du möchtest standardmäßig HTTPS/WSS-Verschlüsselung.

So funktioniert es

cloudflared erstellt einen ausgehenden Tunnel von deinem Mac zu Cloudflares Edge-Netzwerk. Dein iPhone verbindet sich mit einer Cloudflare-URL, und der Datenverkehr wird an deinen Mac weitergeleitet. Auf deinem Router werden keine Ports geöffnet.

Option A: Quick Tunnel (temporär)

Der schnellste Einstieg. Kein Cloudflare-Konto erforderlich. Die URL ist zufällig und ändert sich bei jedem Neustart.

Mit der Mac-App

Aktiviere Cloudflare Tunnel in den Einstellungen der Mac-App. Die App führt cloudflared intern aus und zeigt die Tunnel-URL an.

Über die Kommandozeile

Installiere cloudflared:

brew install cloudflared

Starte einen Quick Tunnel:

cloudflared tunnel --url http://localhost:8765

cloudflared gibt eine URL wie https://random-words.trycloudflare.com aus. Verwende diese URL in der iPhone-App (Verbindungsmodus auf Public / Cloudflare setzen).

Option B: Named Tunnel (feste URL)

Für den täglichen Einsatz bietet ein Named Tunnel eine stabile URL, die sich nicht ändert.

Voraussetzungen:

• Ein kostenloses Cloudflare-Konto.
• Eine von Cloudflare verwaltete Domain (kann eine kostenlose Domain sein).

Schritte:

1. Authentifizieren:

   cloudflared tunnel login

2. Tunnel erstellen:

   cloudflared tunnel create claude-remote

3. DNS konfigurieren: eine Subdomain auf deinen Tunnel zeigen lassen:

   cloudflared tunnel route dns claude-remote remote.yourdomain.com

4. Konfigurationsdatei unter ~/.cloudflared/config.yml erstellen:

   tunnel: claude-remote
   credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
   ingress:
     - hostname: remote.yourdomain.com
       service: http://localhost:8765
     - service: http_status:404

5. Starten:

   cloudflared tunnel run claude-remote

Deine feste URL ist jetzt wss://remote.yourdomain.com.

Vom iPhone verbinden

1. Wechsle in der iPhone-App zum Verbindungsmodus Public (Cloudflare).
2. Gib die Tunnel-URL ein (entweder die zufällige *.trycloudflare.com oder deine eigene Domain).
3. Gib den API-Schlüssel ein (bei öffentlichem Zugriff erforderlich).
4. Tippe auf Verbinden.

Wichtig: API-Schlüssel bei öffentlichen Tunneln immer setzen

Wenn dein Server aus dem Internet erreichbar ist, ist ein API-Schlüssel Pflicht. Setze ihn als Umgebungsvariable, bevor du den Server startest:

export CLAUDE_REMOTE_API_KEY="your-secret-key"

Oder lass die Mac-App einen für dich generieren (wird im Menüleisten-Panel angezeigt).

Fehlerbehebung

• Tunnel verbindet, aber iPhone kann ihn nicht erreichen: Stelle sicher, dass der lokale Server auf dem gleichen Port läuft, auf den der Tunnel zeigt (Standard: 8765).
• DNS löst nicht auf: Prüfe bei Named Tunneln, ob der CNAME-Eintrag in deinem Cloudflare-Dashboard existiert.
• Zufällige URL hat sich geändert: Quick Tunnels generieren bei jedem Neustart eine neue URL. Verwende einen Named Tunnel für Beständigkeit.