Tunnels

Un tunnel est un lien public vers votre Varin, pour y accéder depuis un navigateur ordinaire sur un autre réseau. Utilisez varin tunnel pour en créer un pour une instance en cours d’exécution.

Connecter vos propres appareils (l’application mobile, un autre desktop) ne nécessite généralement pas de tunnel — associez-les plutôt et laissez le Relais privé, chiffré de bout en bout, gérer l’accès hors du domicile dès qu’un relais est configuré sur le serveur (VARIN_RELAY_URL).

Prérequis

Varin démarre la CLI du fournisseur de tunnel sur votre machine. Installez d’abord le fournisseur que vous voulez utiliser :

brew install cloudflared
brew install ngrok

Les tunnels rapides Cloudflare peuvent fonctionner avec cloudflared. Ngrok nécessite un compte ngrok et un authtoken depuis le dashboard ngrok :

ngrok config add-authtoken <your-ngrok-token>

Démarrage rapide

1. Démarrez Varin :

varin

Si vous sautez cette étape, varin tunnel start peut démarrer automatiquement un serveur CLI. Lors de l’auto-démarrage, vous pouvez passer des options serveur comme --port, --host, --lan, --ui-password et --api-only.

2. Démarrez un tunnel Cloudflare :

varin tunnel start --provider cloudflare --mode quick

Ou démarrez un tunnel Ngrok :

varin tunnel start --provider ngrok --mode quick

3. Vérifiez l’état :

varin tunnel status

Quand le tunnel est actif, status affiche une URL publique. Ouvrez-la, ou scannez le QR code, pour joindre Varin depuis n’importe où.

Par défaut, Varin affiche un QR code dans les sessions TTY interactives. Utilisez --qr pour forcer la sortie QR, ou --no-qr pour la désactiver.

Fournisseurs

• cloudflare : modes quick, managed remote et managed local
• ngrok : mode quick

Modes gérés

Managed remote

Utilisez un token + hostname gérés par Cloudflare :

varin tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com

Managed local

Utilisez une configuration cloudflared locale :

varin tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

Profils (managed-remote)

Enregistrez un profil réutilisable :

varin tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token

Démarrez avec le profil enregistré :

varin tunnel start --profile prod-main

Commandes utiles

varin tunnel providers
varin tunnel ready --provider cloudflare
varin tunnel ready --provider ngrok
varin tunnel doctor --provider cloudflare
varin tunnel doctor --provider ngrok
varin tunnel stop --port 3000

Notes de comportement

• un tunnel actif par instance Varin (port)
• démarrer un nouveau mode/fournisseur sur la même instance remplace le tunnel précédent
• générer un nouveau lien de connexion révoque le précédent lien inutilisé
• l’auto-démarrage du tunnel conserve les flags serveur comme --ui-password et --api-only dans les paramètres d’instance utilisés par les flux de redémarrage/mise à jour

Pages liées

• Connecter un appareil — associer vos propres appareils sans URL publique
• Sécurité — protéger l’UI avant de l’exposer
• Tunnels desktop — configuration des tunnels de l’application desktop sans démarrage CLI
• PWA et mobile — joindre Varin depuis votre téléphone
• Dépannage — si le lien de tunnel ne fonctionne pas