Solution communautaire

Client Linux ZimaOS v2.0.0 : installation et dépannage

A community developer released a rewritten Linux desktop client for ZimaOS with files, photos, apps, backups and integrated remote connectivity.

En résumé : Linux v2.0.0 est un client communautaire, pas la version officielle de ZimaClient

La distinction la plus importante concerne la distribution. Les pages actuelles de téléchargement et de configuration de ZimaSpace répertorient officiellement ZimaClient pour ordinateur sous Windows et macOS. Le paquet Linux v2.0.0 présenté dans ce fil provient du projet chicohaager/zima-linux-client, maintenu par la communauté. Il peut être réellement utile, mais les utilisateurs doivent le considérer comme un logiciel communautaire et ne pas supposer qu’il bénéficie du même niveau de support que le client officiel.

Panneau des fonctionnalités détectées du client Linux ZimaOS affichant la prise en charge de Files, Apps, Backup et Remote ID
Le fil consacré à la v2.0.0 inclut cette capture d’écran réelle du client, qui montre les fonctionnalités détectées Files, Apps, Backup et Remote ID, ainsi qu’une faute de frappe dans le libellé de la fonctionnalité Photos.

La page officielle de téléchargement de Zima présente la liste officielle des plateformes. Le code source du client Linux du projet communautaire constitue la référence pour les paquets Linux.

Ce que Linux v2.0.0 ajoute réellement

La réécriture couvre la détection des appareils locaux, le montage SMB, Files, la navigation dans Photos et les dossiers, l’accès aux applications, les tâches de sauvegarde, les commandes de redémarrage et d’arrêt, ainsi que Remote ID via une intégration ZeroTier incluse. La version corrige également un problème frustrant de fenêtre blanche : si l’interface web d’une application refuse la connexion, le client indique désormais l’application, l’adresse cible et l’erreur du navigateur au lieu de laisser une fenêtre vide indéfiniment.

C’est important sur le plan opérationnel. Auparavant, une fenêtre Electron vide ne permettait pas de savoir si l’application elle-même était arrêtée, si le port était inaccessible ou si le point de terminaison web renvoyait une erreur. L’affichage de ERR_CONNECTION_REFUSED oriente la vérification suivante vers l’application et le port ZimaOS plutôt que vers la réinstallation du client Linux.

Choisissez le paquet natif si vous avez besoin de Remote ID

Le projet publie des paquets DEB, RPM et Pacman, ainsi qu’une AppImage. Les paquets natifs exécutent la logique d’installation qui vérifie les dépendances et configure la fonctionnalité ZeroTier incluse. Les propres notes de version du projet précisent que l’AppImage ne bénéficie pas de la même intégration système ; il ne faut donc pas supposer que Remote ID y fonctionnera.

# après avoir téléchargé install.sh, les sommes de contrôle et un paquet correspondant
chmod +x install.sh
sudo ./install.sh

# examiner une installation existante
./install.sh --check

# réparer les problèmes pris en charge de l’installation
sudo ./install.sh --repair

Avant d’exécuter en tant que root un installateur téléchargé, examinez le script et vérifiez la somme de contrôle publiée. GitHub explique les concepts d’intégrité des fichiers de version dans sa page sur la sécurité de la chaîne d’approvisionnement logicielle.

Connaissez les limites des plateformes testées

Le fil fait état de vérifications des paquets et du démarrage sur les familles Ubuntu, Debian, Fedora, Arch et openSUSE, mais le mainteneur précise que les vérifications automatisées ou en conteneur ne constituent pas une validation étendue sur du matériel réel. La version v2.0.0 publiée reste exclusivement disponible pour x86_64. ARM64 n’est volontairement pas publié, car le démarrage de l’application sur du matériel ARM réel n’avait pas été démontré.

Si vous utilisez Wayland, SELinux, un gestionnaire de clés inhabituel ou une distribution dérivée, indiquez ces détails lors du signalement d’un bug. « Linux ne fonctionne pas » est trop général pour établir un diagnostic ; la distribution, la version, X11/Wayland et le format du paquet sont les informations utiles.

Comment diagnostiquer une application qui ne s’ouvre pas

  1. Vérifiez que la même application s’ouvre directement depuis le tableau de bord ZimaOS.
  2. Vérifiez l’URL et le port indiqués dans le message d’erreur du client Linux.
  3. Vérifiez que l’application est en cours d’exécution et que le port est accessible depuis l’ordinateur Linux.
  4. Si l’accès au réseau local fonctionne mais que Remote ID ne fonctionne pas, exécutez les diagnostics ZeroTier du client.
  5. Testez séparément l’accès direct à SMB/Files et l’affichage web intégré de l’application.

Les pages d’accès aux appareils via ZimaClient et d’accès à distance avec Tailscale proposent deux solutions de comparaison prises en charge côté ZimaOS.

Quand préférer les outils Linux standards

Si tout ce dont vous avez besoin est l’accès aux fichiers, Linux dispose déjà de solutions matures pour le montage SMB/CIFS ainsi que de clients Tailscale et WireGuard. Le client de bureau communautaire devient plus intéressant lorsque vous souhaitez réunir l’expérience ZimaOS — détection des appareils, applications, sauvegarde et identité distante — dans une seule interface. Pour un serveur ou une station de travail sans interface graphique, les protocoles standards peuvent être plus simples et plus faciles à automatiser.

La page consacrée à l’authentification SMB de ZimaOS constitue la solution la plus claire lorsque votre seul besoin est le stockage partagé.

Ne confondez pas les bugs du client Linux avec ceux des services ZimaOS

Testez toujours la même opération depuis l’interface web de ZimaOS ou avec un protocole standard. Si le tableau de bord web permet de parcourir les fichiers et que SMB fonctionne, mais que le client Linux échoue, signalez un problème au niveau du client. Si l’application ou le partage ZimaOS sous-jacent échoue également, corrigez d’abord ce service. Cette séparation évite de faire d’un client communautaire l’explication de tout problème NAS indépendant.

FAQ

ZimaClient est-il officiellement disponible pour Linux ?

Le parcours officiel actuel de téléchargement de ZimaSpace répertorie Windows et macOS pour ZimaClient sur ordinateur. L’application Linux v2.0.0 présentée dans ce fil communautaire est maintenue dans un dépôt GitHub communautaire distinct.

Linux v2.0.0 prend-il en charge ARM64 ?

Non, aucune version ARM64 n’est publiée dans le fil consacré à la v2.0.0, car le démarrage de l’application sur du matériel réel n’avait pas été vérifié.

Dois-je utiliser AppImage ou DEB/RPM ?

Utilisez un paquet natif si vous avez besoin de l’intégration système du projet et de la fonctionnalité Remote ID via ZeroTier incluse. L’AppImage est plus portable, mais ne bénéficie pas de toutes les fonctionnalités post-installation.

Pourquoi une application affiche-t-elle ERR_CONNECTION_REFUSED ?

Le navigateur intégré a atteint une adresse à laquelle l’application n’a pas accepté la connexion. Vérifiez l’état de l’application, le port cible, l’adresse de l’hôte et le pare-feu avant de réinstaller le client.

Puis-je simplement monter les partages ZimaOS avec SMB sous Linux ?

Oui. Si votre objectif est uniquement l’accès aux fichiers, les outils CIFS/SMB standards constituent une alternative valable au client de bureau communautaire.