Configuration Cloudflare Tunnel

Cloudflare Tunnel vous permet de vous connecter à votre Mac depuis n'importe quel réseau -- données cellulaires, un WiFi différent ou à l'autre bout du monde. Pas de redirection de port ni de modification du routeur nécessaire.

Quand l'utiliser

• Votre iPhone est sur un réseau différent de votre Mac (par ex. vous êtes en déplacement).
• Votre réseau bloque les connexions directes entre appareils.
• Vous voulez le chiffrement HTTPS/WSS par défaut.

Comment ça fonctionne

cloudflared crée un tunnel sortant uniquement depuis votre Mac vers la périphérie de Cloudflare. Votre iPhone se connecte à une URL Cloudflare, et le trafic est relayé vers votre Mac. Aucun port n'est ouvert sur votre routeur.

Option A : Quick Tunnel (temporaire)

C'est le moyen le plus rapide pour démarrer. Aucun compte Cloudflare requis. L'URL est aléatoire et change à chaque redémarrage.

Avec l'app Mac

Activez Cloudflare Tunnel dans les paramètres de l'app Mac. L'app exécute cloudflared en interne et affiche l'URL du tunnel.

En ligne de commande

Installez cloudflared :

brew install cloudflared

Démarrez un Quick Tunnel :

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

cloudflared affiche une URL comme https://random-words.trycloudflare.com. Utilisez cette URL dans l'app iPhone (définissez le mode de connexion sur Public / Cloudflare).

Option B : Tunnel nommé (URL persistante)

Pour un usage quotidien, un tunnel nommé vous donne une URL stable qui ne change pas.

Prérequis :

• Un compte Cloudflare gratuit.
• Un domaine géré par Cloudflare (peut être un domaine gratuit).

Étapes :

1. Authentifiez-vous :

   cloudflared tunnel login

2. Créez un tunnel :

   cloudflared tunnel create claude-remote

3. Configurez le DNS : pointez un sous-domaine vers votre tunnel :

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

4. Créez un fichier de configuration à ~/.cloudflared/config.yml :

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

5. Lancez :

   cloudflared tunnel run claude-remote

Votre URL persistante est maintenant wss://remote.yourdomain.com.

Se connecter depuis l'iPhone

1. Dans l'app iPhone, passez en mode de connexion Public (Cloudflare).
2. Entrez l'URL du tunnel (soit la *.trycloudflare.com aléatoire, soit votre domaine nommé).
3. Entrez la clé API (obligatoire pour l'accès public).
4. Tapez Connecter.

Important : toujours définir une clé API pour les tunnels publics

Quand votre serveur est joignable depuis internet, une clé API est obligatoire. Définissez-la comme variable d'environnement avant de démarrer le serveur :

export CLAUDE_REMOTE_API_KEY="your-secret-key"

Ou laissez l'app Mac en générer une pour vous (affichée dans le panneau de barre de menu).

Dépannage

• Le tunnel se connecte mais l'iPhone ne peut pas l'atteindre : vérifiez que le serveur local tourne sur le même port que celui vers lequel le tunnel pointe (par défaut : 8765).
• DNS ne résout pas : pour les tunnels nommés, vérifiez que l'enregistrement CNAME existe dans votre tableau de bord Cloudflare.
• L'URL aléatoire a changé : les Quick Tunnels génèrent une nouvelle URL à chaque redémarrage. Utilisez un tunnel nommé pour la persistance.