Blog
Modes de connexion : Reseau local vs. Cloudflare Tunnel
Tactic Remote prend en charge deux modes de connexion : Reseau local avec une latence inferieure a 100ms sur le meme Wi-Fi, et Cloudflare Tunnel pour un acces securise depuis n'importe ou. Voici comment ils fonctionnent et quand utiliser chacun.
Suivez les mises à jour produit et ingénierie de cette catégorie.
Voir la catégorieL'une des questions les plus frequentes des nouveaux utilisateurs de Tactic Remote est : « Dois-je utiliser le mode Reseau local ou Cloudflare Tunnel ? » La reponse depend de comment et ou vous travaillez. Cet article explique les deux modes en detail — leurs differences architecturales, leurs caracteristiques de performance et de securite, et comment Tactic Remote gere les transitions entre les deux.
Deux modes, une interface
Avant d'entrer dans les details techniques, le point le plus important : l'application iPhone fonctionne de maniere identique quel que soit le mode de connexion utilise. Gestion de sessions, streaming de terminal, workflows d'approbation, notifications push — tout cela fonctionne de la meme maniere que votre telephone soit sur le meme Wi-Fi que votre Mac ou sur un reseau cellulaire a l'autre bout du pays.
Le mode de connexion n'affecte que la maniere dont votre iPhone atteint l'API de l'application Companion. Tout ce qui se trouve au-dessus de la couche de transport est identique.
Mode Reseau Local
Le mode Reseau local est la configuration par defaut et la plus simple. L'application Companion de votre Mac lie son serveur HTTP/WebSocket a un port sur votre reseau local, et votre iPhone se connecte directement a cette adresse IP et ce port.
Fonctionnement
- L'application Companion demarre son serveur integre sur le port 48736 (configurable).
- Le Mac annonce son adresse IP locale (ex.
192.168.1.42:48736). - L'iPhone se connecte a cette adresse via votre reseau Wi-Fi local.
- Toute la communication transite directement entre les deux appareils sur le reseau local — sans intermediaire.
Performances
Le mode Reseau local offre la meilleure latence possible car les paquets empruntent le chemin le plus court : iPhone vers routeur vers Mac (ou directement via Wi-Fi Direct dans certaines configurations reseau).
| Metrique | Plage typique |
|---|---|
| Etablissement de connexion | 30-80ms |
| Latence de mise a jour du terminal | 40-100ms |
| Aller-retour d'approbation | 60-120ms |
| WebSocket ping | 5-20ms |
| Reconnexion apres breve deconnexion | 0,5-1,5s |
Ces chiffres supposent un reseau Wi-Fi standard domestique ou de bureau. Les reseaux congestionnes (Wi-Fi de conference, par exemple) peuvent montrer une latence plus elevee, mais le mode Reseau local surpassera toujours les connexions par tunnel sur le meme reseau.
Profil de securite
La securite du mode Reseau local repose sur deux couches :
Isolation reseau. Votre reseau local agit comme perimetre. Seuls les appareils sur le meme reseau peuvent atteindre le port de l'application Companion. Cela suffit pour la plupart des environnements domestiques et de bureau.
Authentification par Token. Chaque requete API necessite un Bearer Token. Meme si un attaquant est sur votre reseau local, il ne peut pas interagir avec l'application Companion sans le Token.
Ce que le mode Reseau local ne fournit pas : une protection contre un appareil compromis sur votre reseau qui aurait obtenu votre Token. Pour les environnements ou vous ne pouvez pas faire confiance au reseau local (espaces de coworking partages, Wi-Fi d'hotel), le mode Cloudflare Tunnel est recommande.
Limitations
- Meme reseau requis. Votre iPhone et votre Mac doivent etre sur le meme reseau Wi-Fi (ou accessibles via le meme LAN). Des que vous quittez votre reseau domestique, la connexion est perdue.
- Changements d'adresse IP. Si l'IP locale de votre Mac change (renouvellement de bail DHCP, reconnexion au Wi-Fi), vous devez mettre a jour les parametres de connexion de l'iPhone. Le flux de code QR attenue ce probleme par re-scan, mais cela reste une etape manuelle.
- Pas d'acces depuis le cellulaire. Par definition, les donnees cellulaires ne sont pas routees vers votre reseau domestique.
Mode Cloudflare Tunnel
Le mode Cloudflare Tunnel cree une connexion sortante persistante de votre Mac vers le reseau edge mondial de Cloudflare. Votre iPhone se connecte a une URL Cloudflare, et Cloudflare achemine le trafic a travers le tunnel jusqu'a votre Mac.
Fonctionnement
- L'application Companion lance
cloudflaredcomme processus enfant gere avec vos identifiants de tunnel. cloudflaredetablit une connexion sortante vers le serveur edge Cloudflare le plus proche (generalement 2 a 4 connexions simultanees pour la redondance).- Votre tunnel est accessible a l'URL que vous avez configuree (ex.
claude.yourdomain.com). - L'iPhone se connecte a cette URL. Cloudflare achemine la requete a travers son reseau vers le processus
cloudflaredsur votre Mac. cloudflaredtransmet la requete au serveur local de l'application Companion.
La propriete architecturale cle : votre Mac n'accepte jamais de connexions entrantes depuis Internet. Le tunnel est exclusivement sortant, ce qui signifie aucun port a ouvrir, aucune regle de pare-feu et aucune exposition aux scanners de ports.
Performances
Cloudflare Tunnel ajoute une latence mesurable car le trafic transite par le reseau edge de Cloudflare :
| Metrique | Plage typique |
|---|---|
| Etablissement de connexion | 150-300ms |
| Latence de mise a jour du terminal | 100-250ms |
| Aller-retour d'approbation | 200-400ms |
| WebSocket ping | 40-120ms |
| Reconnexion apres breve deconnexion | 2-4s |
La latence varie en fonction de votre distance geographique au serveur edge Cloudflare le plus proche. Cloudflare opere dans plus de 300 villes, donc la plupart des utilisateurs en zone urbaine voient une latence vers le bas de ces plages. Les utilisateurs dans des regions avec moins de points de presence Cloudflare peuvent connaitre une latence plus elevee.
En pratique, cette latence est perceptible pendant les premieres minutes d'utilisation mais devient rapidement imperceptible. La sortie du terminal continue de defiler fluidement, et les interactions d'approbation restent suffisamment reactives pour que la plupart des utilisateurs les traitent dans les 15 secondes suivant la notification.
Profil de securite
Cloudflare Tunnel offre une posture de securite plus forte que le mode Reseau local sur plusieurs points :
Aucune surface d'attaque entrante. Votre Mac n'ecoute jamais les connexions Internet. Il n'y a rien a scanner, rien a attaquer par force brute de l'exterieur.
Chiffrement TLS. Tout le trafic entre votre iPhone et Cloudflare, et entre Cloudflare et votre Mac, est chiffre avec TLS. Combine a l'authentification par Token de Tactic Remote, cela fournit deux couches de securite independantes.
La protection DDoS et anti-bots de Cloudflare s'applique par defaut a votre point de terminaison du tunnel, ajoutant une protection contre les attaques automatisees.
Le compromis : le trafic transite par le reseau de Cloudflare. Bien que chiffre, cela signifie que Cloudflare est un intermediaire de confiance. Pour la plupart des developpeurs individuels, c'est un compromis acceptable compte tenu de la commodite. Pour les environnements sensibles, consultez notre guide Securite et renforcement reseau pour des mesures supplementaires.
Limitations
- Compte Cloudflare requis. Vous avez besoin d'un compte Cloudflare gratuit et d'un domaine gere par Cloudflare. Le tunnel lui-meme est gratuit, mais la configuration DNS initiale prend quelques minutes.
- Dependance a la disponibilite de Cloudflare. Si Cloudflare subit une panne, l'acces en mode tunnel est indisponible. C'est rare (le bilan de disponibilite de Cloudflare est excellent) mais merite d'etre mentionne.
- Latence plus elevee qu'en mode local. Comme detaille ci-dessus, chaque interaction ajoute 50-200ms par rapport au mode Reseau local.
Le flux de connexion par code QR
Les deux modes utilisent le meme flux de code QR pour l'appairage initial, mais le contenu du code QR differe :
Code QR Reseau local encode : http://<local-ip>:<port> plus le Token d'authentification.
Code QR Cloudflare Tunnel encode : https://<your-tunnel-domain> plus le Token d'authentification.
L'application iPhone detecte le mode de connexion en fonction du schema d'URL et des caracteristiques reseau. Si le code QR contient une adresse IP locale, l'application se configure en mode Reseau local. S'il contient un domaine HTTPS, elle se configure en mode Cloudflare Tunnel.
Pour changer de mode, vous generez un nouveau code QR depuis le menu deroulant de la barre de menus de l'application Companion et le scannez avec votre iPhone. L'application remplace la configuration de connexion precedente. Le changement de mode complet prend moins de 10 secondes.
Comparaison cote a cote
| Facteur | Reseau local | Cloudflare Tunnel |
|---|---|---|
| Complexite de configuration | Minimale (automatique) | Moderee (5-10 min) |
| Latence | 40-100ms | 100-250ms |
| Fonctionne hors reseau | Non | Oui |
| Compte Cloudflare requis | Non | Oui |
| Ports entrants requis | Aucun (LAN uniquement) | Aucun |
| Confiance envers un tiers | Aucune | Cloudflare |
| Cout | Gratuit | Gratuit (niveau gratuit Cloudflare) |
| Vitesse de reconnexion | 0,5-1,5s | 2-4s |
| Ideal pour | Travail au bureau maison/entreprise | Deplacements, voyages, teletravail |
Modes d'utilisation recommandes
Utilisez le mode Reseau local lorsque vous etes a votre bureau ou sur le meme reseau que votre Mac. La latence plus faible rend le streaming de terminal sensiblement plus fluide, et il n'y a aucune dependance tierce.
Utilisez le mode Cloudflare Tunnel lorsque vous avez besoin d'un acces depuis l'exterieur de votre reseau local — en deplacement, en voyage, en travaillant depuis un autre lieu, ou lorsque vous souhaitez demarrer une tache a la maison et la surveiller depuis le bureau.
Utilisez les deux en configurant Cloudflare Tunnel sur votre Mac mais en vous connectant via le mode Reseau local lorsque vous etes chez vous. L'application Companion peut servir les deux modes simultanement. Votre iPhone peut stocker les deux profils de connexion, et basculer entre eux se fait en un seul appui dans les parametres de connexion de l'application.
Beaucoup de nos utilisateurs configurent Cloudflare Tunnel une fois comme solution de secours et utilisent le mode Reseau local au quotidien. Lorsqu'ils quittent la maison, ils basculent vers le profil tunnel. Cela leur offre la meilleure latence lorsqu'elle est disponible et l'acces distant lorsqu'il est necessaire.
Perspectives
Nous explorons la selection automatique de mode qui detecte quand votre iPhone est sur le meme reseau que votre Mac et route localement, avec repli sur Cloudflare Tunnel lorsque vous partez. Cela eliminerait completement le changement manuel de mode. Les tests initiaux montrent une detection reseau fiable sur iOS, mais les cas limites autour des VPN et des configurations de tunnel divise necessitent encore du travail.
Pour les instructions de configuration, consultez Premiers pas pour le mode Reseau local et Configuration Cloudflare Tunnel pour la configuration de l'acces distant.
Essayez Tactic Remote
Pilotez vos agents de programmation depuis votre téléphone
Connectez-vous à Claude Code, Codex et aux autres agents sur votre Mac, PC Windows ou Linux. Consultez leur progression et envoyez la prochaine instruction depuis votre iPhone ou iPad.