La conclusion de cette source est simple : le changement des ports 80/443 de l’interface Web de ZimaOS a empêché la connectivité de Zima App 2.3.0 sur le ZimaBoard 2 de l’utilisateur, mais après la mise à jour de ZimaOS vers la version 1.5, l’utilisateur est revenu confirmer que le problème était résolu.
Cela signifie que la page ne doit pas apprendre aux utilisateurs actuels à configurer manuellement un « port ZimaClient » caché en se basant sur l’incident de 2025. Il s’agissait d’un problème historique de compatibilité entre le client et un port d’interface Web personnalisé, et la source elle-même établit que la mise à jour vers la version 1.5 a résolu le problème.
L’utilisateur a modifié les ports pour Nginx Proxy Manager
Nginx Proxy Manager a normalement besoin des ports hôtes 80 et 443 pour le trafic entrant HTTP/HTTPS. L’utilisateur a donc configuré ZimaOS comme suit :
[gateway]
port = 8080
[ssl]
enabled = true
port = 30443puis a redémarré le service de passerelle CasaOS/ZimaOS.
L’application Zima pour Windows n’a alors plus pu se connecter
L’environnement source était le suivant :
- ZimaBoard 2 1664 ;
- noyau ZimaOS 6.12.25 ;
- Zima App 2.3.0 sous Windows 11.
Après la modification du port de l’interface Web, le redémarrage de l’application Windows et la tentative de reconnexion ont échoué.
IceWhale a demandé des informations reproductibles plutôt que de suggérer une configuration de port au hasard
Zima-Giorgio a demandé à l’utilisateur de fournir une description précise du problème, les étapes de reproduction, les modifications précédentes, les solutions tentées, le matériel, la version du système d’exploitation et la version du client. Il s’agit d’une bonne méthode d’analyse, car une même erreur de connexion apparente peut être due à la découverte, à l’accès distant, au TLS, aux ports ou à la version du client.
La mise à jour vers ZimaOS 1.5 a résolu le problème de cette source
Trois jours plus tard, ThomasSpi a publié : « Après la mise à jour vers Zima OS 1.5, cela fonctionne. Problème résolu. »
Il s’agit de la conclusion la plus solide de la source et elle doit remplacer toute spéculation sur la configuration manuelle d’un port personnalisé dans Zima App.
Le ZimaClient actuel a continué d’évoluer
La documentation actuelle d’IceWhale décrit ZimaClient comme recherchant automatiquement la connexion utilisable la plus rapide vers l’interface Web sur le réseau local, le réseau externe, un point d’accès et d’autres chemins pris en charge.
Consultez le modèle actuel d’installation et de connexion de ZimaClient avant de tenter de reproduire une solution datant de l’ère de la version 2.3.0.
ZimaOS 1.7.1 a encore amélioré les URL Web de Docker et la gestion dynamique du réseau
Le journal des modifications de la version 1.7.1 mentionne une configuration plus flexible des ports des URL Web de Docker ainsi qu’une meilleure gestion des URL dans les environnements réseau dynamiques. Ces changements concernent les URL des applications et ne prouvent rien de précis au sujet de l’ancien problème de ZimaClient, mais ils montrent que la gestion des ports et des URL de la plateforme a continué d’évoluer.
Le proxy inverse et ZimaClient sont deux chemins d’accès distincts
Nginx Proxy Manager peut fournir des domaines HTTPS conviviaux pour les applications, voire pour le tableau de bord ZimaOS. ZimaClient utilise sa propre logique de découverte et d’accès distant. Il ne faut pas supposer qu’une modification du proxy inverse reconfigure automatiquement ZimaClient dans toutes les versions.
Si vous utilisez un proxy pour le tableau de bord ZimaOS, préservez les WebSockets
Un cas communautaire ultérieur, en 2026, a montré que le tableau de bord pouvait se charger visuellement via Nginx Proxy Manager alors que les widgets en temps réel et les boîtes de dialogue des applications échouaient jusqu’à l’activation de la prise en charge des WebSockets. Le conflit de ports et le proxy WebSocket sont deux couches distinctes.
Une méthode plus sûre pour modifier le port de l’interface Web
- Notez le port d’origine.
- Modifiez le port de l’interface Web via l’interface prise en charge, lorsqu’elle est disponible.
- Vérifiez l’accès direct dans le navigateur à la nouvelle adresse IP et au nouveau port.
- Redémarrez ou mettez à jour ZimaClient, puis confirmez la découverte.
- Attribuez seulement ensuite les ports 80/443 au proxy inverse.
- Conservez un moyen d’accès local pour récupérer le système si le proxy et le client échouent tous deux.
FAQ sur la modification du port de ZimaClient
L’utilisateur de la source a-t-il trouvé un réglage manuel de port personnalisé dans Zima App ?
Non. La discussion s’est terminée lorsque la mise à jour du système d’exploitation a résolu le problème.
Quelle version a résolu le problème de cette source ?
L’utilisateur a explicitement indiqué que ZimaOS 1.5 l’avait résolu.
Les utilisateurs actuels doivent-ils supposer que le comportement de ZimaClient 2.3.0 s’applique toujours ?
Non. La gestion des connexions de ZimaClient et de ZimaOS est aujourd’hui nettement plus récente.
