La méthode actuelle la plus simple pour utiliser Twingate avec CasaOS consiste à exécuter un Connector Twingate dans un conteneur Docker sur l’hôte CasaOS ou sur une autre machine du même LAN. Le Connector établit des connexions sortantes avec Twingate : vous n’avez donc pas besoin de rediriger le port du tableau de bord CasaOS.
Le tutoriel du forum datant de 2023 précède le modèle Docker Compose actuel de Twingate. Utilisez les jetons du Connector actuel et les variables Compose officielles plutôt que de copier à l’aveugle un ancien paquet d’installation en un clic.
Créer un réseau distant et un Connector
Dans la console d’administration Twingate, créez un réseau distant et un Connector. Twingate génère un jeton d’accès et un jeton d’actualisation uniques pour ce Connector.
Utiliser le modèle Docker Compose actuel
Le guide Docker Compose actuel de Twingate indique les variables obligatoires suivantes :
services:
twingate-connector:
image: twingate/connector:latest
restart: always
environment:
- TWINGATE_NETWORK=YOUR_TENANT
- TWINGATE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
- TWINGATE_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
Ne montrez pas les jetons dans des captures d’écran publiques
Les jetons d’accès et d’actualisation authentifient le Connector de manière unique. Stockez-les dans la configuration de l’application CasaOS ou dans un fichier d’environnement qui n’est ni envoyé sur Git ni publié.
Ajouter CasaOS comme ressource Twingate
Dans la console d’administration Twingate, définissez l’adresse IP LAN ou le nom d’hôte de CasaOS, ainsi que le port web, comme ressource. Accordez l’accès uniquement aux utilisateurs et groupes qui en ont besoin.
Réseau en mode bridge ou host
Twingate indique que le mode bridge est le mode par défaut, tandis que le mode host peut faciliter la mise en réseau locale entre pairs. Commencez par le mode par défaut officiel, sauf si vous avez une raison précise de partager la pile réseau de l’hôte.
Aucune redirection de port sur le routeur n’est nécessaire
Le Connector se trouve derrière le pare-feu et établit une connexion sortante. N’ouvrez pas le port d’administration de CasaOS à l’ensemble d’Internet simplement pour accéder à distance.
Installer le client Twingate sur votre appareil distant
Le connecteur fonctionne sur votre réseau domestique ; le client Twingate fonctionne sur l’ordinateur portable ou le téléphone que vous utilisez à distance. Les deux s’enregistrent auprès du réseau Twingate avant que le trafic n’atteigne la ressource privée.
Vérifier l’accès avant d’ajouter d’autres ressources
Testez d’abord le tableau de bord CasaOS, puis ajoutez les autres applications NAS individuellement. Vous garderez ainsi une politique d’accès explicite au lieu d’exposer inutilement tout un sous-réseau.
Le guide sur l’accès privé à distance fournit davantage de contexte sur les serveurs domestiques.
Vérifier l’état du connecteur avant de tester CasaOS
docker ps | grep twingate
docker logs --tail 100 twingate-connectorLe connecteur devrait s’enregistrer correctement et rester en cours d’exécution. S’il redémarre à répétition, vérifiez le nom du locataire et les jetons avant de rechercher la cause du problème lié à la ressource CasaOS.
Utiliser la définition de ressource la plus restreinte
Si vous avez uniquement besoin du tableau de bord CasaOS, définissez l’adresse IP et le port Web exacts de CasaOS au lieu d’exposer tout le sous-réseau du réseau local. Ajoutez les autres applications comme ressources distinctes lorsque vous en avez réellement besoin.
Planifier les mises à jour du connecteur
Twingate publie les mises à jour des conteneurs indépendamment de CasaOS. Récupérez régulièrement l’image actuelle du connecteur et redémarrez-le pendant une période de maintenance, puis vérifiez que l’accès à distance fonctionne toujours.
FAQ
Dois-je ouvrir les ports CasaOS sur mon routeur ?
Non. Les connecteurs Twingate sont conçus pour fonctionner derrière le pare-feu et établir une connectivité sortante.
D’où viennent les jetons Twingate ?
La console d’administration les génère lors du déploiement d’un connecteur.
Dois-je utiliser le réseau de l’hôte ?
Uniquement si votre topologie ou le comportement pair-à-pair l’exige ; le mode bridge est utilisé par défaut.
Un connecteur peut-il exposer autre chose que CasaOS ?
Oui, mais définissez délibérément les ressources et les autorisations au lieu d’accorder par défaut un accès étendu au sous-réseau.
