Installer l’application Tailscale et terminer le lien d’authentification de l’appareil ne garantit pas que le conteneur ZimaOS restera connecté. Dans ce fil marqué comme résolu en octobre 2025, l’appareil pouvait être ajouté à Tailscale, mais n’apparaissait jamais comme connecté dans la liste des appareils d’administration Tailscale.
La solution est venue d’autres membres de la communauté, et non d’un compte officiel du personnel d’IceWhale. Un utilisateur a identifié l’entrée Tailscale de l’App Store ZimaOS qui fonctionnait dans son environnement, a modifié la configuration de son interface Web et fourni une nouvelle clé d’authentification Tailscale. Une réponse ultérieure a ajouté une étape de récupération importante en cas de problème persistant : supprimer l’ancien dossier AppData de Tailscale avant de réinstaller l’application.
Le fil utilisait une entrée spécifique de Tailscale dans l’App Store
L’App Store ZimaOS affichait deux entrées liées à Tailscale. L’utilisateur de la communauté a indiqué que seule l’entrée mise en évidence à gauche avait fonctionné pour sa propre migration vers ZimaOS 1.5 à ce moment-là.
Il s’agissait d’une observation faite en 2025, et non d’un classement permanent des paquets actuellement disponibles dans l’App Store. Les définitions des applications peuvent changer : comparez les détails des paquets actuels avant de supposer que la même entrée est toujours requise.
Définir le chemin d’interface Web utilisé par la configuration de la communauté
L’utilisateur a modifié la cible de l’interface Web de l’application Tailscale afin qu’elle pointe vers le chemin d’administration de la connexion Tailscale :
login.tailscale.com avec le chemin /admin pour son raccourci d’interface Web.Ce paramètre contrôle le raccourci ouvert depuis ZimaOS. Il ne doit pas être confondu avec l’état réseau du démon Tailscale lui-même.
Utiliser votre propre clé d’authentification Tailscale actuelle
Le guide de la communauté récupérait ensuite une clé d’autorisation auprès de Tailscale et la plaçait dans la variable d’environnement TS_AUTHKEY de l’application. Ne copiez pas une clé d’authentification depuis une capture d’écran, une publication de forum, une sauvegarde ou une autre machine. Les clés d’authentification sont des identifiants : elles doivent être générées et gérées pour votre propre tailnet.
La documentation actuelle de Tailscale prend en charge les déploiements conteneurisés et les paramètres d’authentification pour Docker :
Documentation Docker de Tailscale
Si la réinstallation ne suffit pas, il est possible que l’ancien AppData soit toujours réutilisé
Un deuxième membre de la communauté avait une installation de Tailscale qui fonctionnait auparavant, puis s’était arrêtée. La mise à jour, le redémarrage, la suppression de l’application et sa réinstallation n’avaient pas permis de résoudre le problème dans un premier temps.
L’étape qui a finalement fonctionné pour cet utilisateur était la suivante :
- supprimer l’application Tailscale de ZimaOS ;
- accéder à l’emplacement AppData de ZimaOS ;
- supprimer l’ancien dossier de données d’application
tailscale; - réinstaller Tailscale depuis l’App Store ;
- répéter les étapes de configuration et d’authentification fonctionnelles.
Avertissement : la suppression d’un dossier AppData efface l’état persistant de l’application. Sauvegardez tout ce dont vous pourriez avoir besoin avant de le supprimer et vérifiez que vous supprimez bien le dossier Tailscale, et non les données d’une autre application.
Pourquoi supprimer uniquement l’application peut ne pas réinitialiser Tailscale
Les applications conteneurisées conservent généralement leur état en dehors du système de fichiers temporaire du conteneur. Cela permet aux paramètres de survivre aux mises à jour ou à la recréation du conteneur, mais signifie également qu’un état incorrect ou obsolète peut survivre à un cycle ordinaire de désinstallation et de réinstallation si le répertoire AppData persistant est conservé.
Le résultat rapporté dans ce fil permet donc de distinguer deux niveaux de récupération : commencer par réinstaller le conteneur et n’envisager l’effacement de l’état persistant que si une réinstallation normale continue de réutiliser la même configuration défectueuse.
Ce fil résolu concernait la connexion du nœud, et non le routage de sous-réseaux
Le problème était ici que le nœud Tailscale ne devenait jamais connecté. Il est différent d’une discussion ultérieure sur ZimaOS, dans laquelle Tailscale se connectait correctement, mais n’annonçait pas les routes de sous-réseaux. Si votre appareil est déjà en ligne dans Tailscale et que seuls les services du réseau local distant sont inaccessibles, recherchez un problème de routage de sous-réseaux au lieu de répéter cette procédure axée sur l’authentification.
FAQ sur la connexion de Tailscale à ZimaOS
Pourquoi mon appareil Tailscale apparaît-il comme enregistré, mais jamais comme connecté ?
Dans le cas résolu en 2025, la configuration fonctionnelle de la communauté reposait sur l’entrée appropriée de l’App Store, sa configuration d’interface Web et une clé d’authentification Tailscale valide.
Dois-je supprimer immédiatement l’AppData de Tailscale ?
Non. La suppression de l’AppData était une étape de récupération ultérieure, utilisée après l’échec des tentatives ordinaires de mise à jour, de redémarrage, de désinstallation et de réinstallation. Elle supprime l’état persistant : effectuez donc d’abord une sauvegarde.
La clé d’authentification visible dans une ancienne capture d’écran peut-elle être réutilisée sans risque ?
Non. Générez et gérez votre propre clé pour votre tailnet. Considérez les clés d’authentification comme des identifiants.
S’agissait-il d’une solution officielle d’IceWhale ?
Non. Le fil a été marqué comme résolu grâce au dépannage de la communauté. Il constitue un retour d’expérience pratique utile, mais ces étapes n’ont pas été publiées comme une procédure officielle d’assistance d’IceWhale.
