Si ZimaClient sur macOS reste bloqué sur « Connexion en cours », déconnectez-vous du client, puis reconnectez-vous avant de réinstaller l’application ou de modifier votre serveur ZimaOS. Cette action précise a rétabli le fonctionnement dans le cas source vérifié en version 2.1.0, après plusieurs heures de blocage.
Toutefois, ne considérez pas la déconnexion/reconnexion comme une solution universelle à la cause première. Le même fil concernait des problèmes de connexion à la fois sur Mac et Android après des mises à niveau de ZimaOS, et IceWhale a spécifiquement posé des questions sur les pare-feu, les VPN, les proxys, les changements de FAI et la configuration réseau. Une bonne procédure de dépannage distingue l’état du compte/de la session de l’accessibilité réseau.
Étape 1 : Confirmer que le serveur fonctionne en local
Ouvrez directement le tableau de bord ZimaOS dans un navigateur en utilisant l’adresse IP du réseau local. Si le serveur fonctionne en local, mais que ZimaClient ne peut pas se connecter, concentrez-vous sur la couche client/session/accès distant.
Étape 2 : Se déconnecter, puis se reconnecter
L’utilisateur d’origine avait déjà réinstallé ZimaClient et redémarré ZimaOS sans succès. La déconnexion de ZimaClient, suivie d’une nouvelle authentification, a rétabli la connexion.
Cela laisse penser qu’un état obsolète du client ou de la session était impliqué, mais le fil n’a pas déterminé précisément quel jeton ou état réseau avait changé.
Étape 3 : Vérifier l’accès distant dans ZimaOS
Le guide actuel de l’accès distant de ZimaOS indique que l’accès distant peut être activé ou désactivé dans Réglages → Réseau.
Assurez-vous qu’il est activé si vous souhaitez que ZimaClient fonctionne lorsque vous êtes hors de chez vous.
Étape 4 : Tester sur le même réseau local
Les recommandations actuelles de prise en main de ZimaOS préconisent d’effectuer la première connexion sur le même réseau. Si ZimaClient ne peut même pas se connecter en local, la traversée NAT distante n’est pas le premier élément à examiner.
Étape 5 : Vérifier les VPN, proxys, pare-feu et changements réseau
Le support IceWhale a spécifiquement demandé si l’utilisateur avait modifié le pare-feu, le VPN ou le proxy, le FAI ou l’administration réseau avant l’apparition de la panne.
Désactivez temporairement les clients VPN ou proxy susceptibles d’interférer pendant le diagnostic et vérifiez que l’autorisation d’accès au réseau local de macOS permet à ZimaClient de détecter les appareils.
Étape 6 : Redémarrer les processus ZimaClient bloqués
Le guide d’installation de ZimaClient recommande d’utiliser le Moniteur d’activité pour fermer les processus liés à Zima lorsque l’application semble fonctionner, mais ne réagit pas correctement.
Étape 7 : Collecter les journaux avant de réinstaller à nouveau
La documentation actuelle indique que les journaux de ZimaClient sur macOS se trouvent dans :
~/Library/Application Support/Zima/logsCollectez-les immédiatement après avoir reproduit le problème afin que le support puisse distinguer les défaillances de détection, d’authentification et de réseau distant.
Utiliser des outils VPN standard comme solution alternative
ZimaOS prend également en charge Tailscale, WireGuard Easy, Firefly et NetBird comme solutions alternatives de réseau distant. Ils ne remplacent pas les fonctions de sauvegarde ou d’intégration au Finder de ZimaClient, mais peuvent fournir un chemin distinct via un réseau privé.
Le guide de connexion distante aide à comparer ces différentes couches.
Distinguer l’authentification de la connectivité
Si le Mac détecte le serveur, mais que l’authentification échoue, comparez le même compte ZimaOS dans l’interface web locale. Si le compte fonctionne dans le navigateur, mais pas dans ZimaClient, le problème vient probablement de l’état du client ou de la session, et non du mot de passe lui-même.
Si ni le navigateur ni le client ne peuvent joindre le serveur par son adresse IP, commencez par dépanner le serveur ou le réseau local.
Vérifier l’autorisation d’accès au réseau local de macOS
macOS peut limiter la capacité d’une application à détecter les appareils présents sur le réseau local. Si ZimaClient n’affiche pas un appareil ZimaOS proche, vérifiez l’autorisation Réseau local de l’application dans les réglages Confidentialité et sécurité de macOS, puis redémarrez le client après l’avoir modifiée.
Réinitialiser uniquement la couche défaillante
Ne réinitialisez pas simultanément le serveur ZimaOS, le Remote ID, le mot de passe et l’installation du client. Modifiez une seule couche à la fois afin de savoir précisément ce qui a résolu le problème.
Le cas source en est un bon exemple : le redémarrage du serveur et la réinstallation du client n’ont rien changé ; la déconnexion suivie d’une reconnexion a fonctionné. Ces éléments orientent vers un problème d’état de session plutôt que vers une installation du serveur endommagée.
Quand utiliser une autre méthode d’accès distant
Si ZimaClient reste indisponible, mais que le serveur lui-même fonctionne correctement, un accès Tailscale ou WireGuard configuré séparément peut permettre de continuer à administrer le serveur pendant que vous collectez les journaux. Utilisez-le comme chemin réseau indépendant, et non comme preuve que le problème de ZimaClient est résolu.
FAQ
Pourquoi la réinstallation de ZimaClient n’a-t-elle pas résolu le problème ?
Une réinstallation peut laisser inchangés l’état du compte ou de la session ainsi que les conditions réseau. Dans le cas source vérifié, c’est la déconnexion suivie d’une reconnexion qui a rétabli le service.
Pourquoi SMB peut-il fonctionner alors que ZimaClient échoue ?
SMB sur le réseau local et la connectivité distante/de session de ZimaClient correspondent à des couches différentes. L’une peut fonctionner tandis que l’autre est en panne.
Où se trouvent les journaux Mac de ZimaClient ?
La documentation officielle actuelle indique ~/Library/Application Support/Zima/logs.
Dois-je réinitialiser mon mot de passe ZimaOS ?
Pas simplement parce que ZimaClient affiche « Connexion en cours ». Vérifiez d’abord la connexion directe, déconnectez-vous puis reconnectez-vous, contrôlez l’état du réseau et consultez les journaux.
