Aller au contenu
CloudZH

Docs / Premiers pas

Accessibilité, CGNAT et DynDNS

L'accès à distance ne fonctionne que si ta ligne internet a sa propre adresse IPv4 publique. CloudZH le vérifie pour toi et tient ton enregistrement DNS à jour.

Vérifier ta ligne

L'installateur, System Health et Réglages → Accessibilité et DynDNS affichent le résultat. Sur le serveur :

zh reach

CloudZH compare l'adresse vue par internet, l'adresse WAN de ton routeur (UPnP ou NAT-PMP, s'ils sont activés) et un test depuis l'extérieur sur le port 443.

RésultatSignification
IPv4 publiqueTout va bien. Si le port 443 reste fermé, vérifie la redirection de ports de ton routeur.
CGNATTon routeur a une adresse de 100.64.0.0/10 ou une adresse privée : ton fournisseur partage une adresse publique entre de nombreux clients.
DS-LiteL'IPv4 passe par un tunnel de ton fournisseur, seule l'IPv6 t'appartient.
InconnuTon routeur ne l'indique pas. Cherche l'adresse internet sur sa page d'état : 100.64.x.x ou 192.0.0.x signifie CGNAT ou DS-Lite.

Ce qui fonctionne avec CGNAT

  • Tout à la maison : tableau de bord, apps, Plex et téléchargements.
  • Plex en déplacement, via le relais Plex avec une qualité réduite.
  • Impossible : accès direct depuis l'extérieur au tableau de bord, aux apps et au VPN.

Solutions

  • IPv6 : beaucoup de ces lignes ont une vraie IPv6. Autorise TCP 443 vers le serveur dans ton routeur et active l'IPv6 pour DynDNS. Fonctionne uniquement depuis des réseaux avec IPv6.
  • Demande à ton fournisseur une adresse IPv4 publique ou le dual stack. Certains le font sur demande, parfois contre paiement. La solution la plus propre.
  • Ton propre relais : un petit VPS avec une adresse IPv4 publique redirige le port 443 vers CloudZH via WireGuard. Fonctionne aussi pour la vidéo.
  • Tailscale : tes appareils joignent le serveur sans ports ouverts. Chaque appareil a besoin de l'app.
  • Cloudflare Tunnel : uniquement pour le tableau de bord et les apps d'administration, jamais pour Plex ou d'autres vidéos. Les conditions de Cloudflare n'autorisent pas à diffuser principalement de la vidéo via leur réseau.

DynDNS

Si ton adresse publique change de temps en temps, CloudZH le remarque en 5 minutes et met à jour tes enregistrements DNS avec les mêmes identifiants que le certificat.

  • Pris en charge : Cloudflare et Duck DNS. Autres fournisseurs DNS : utilise le DNS dynamique de ton routeur ou modifie l'enregistrement à la main.
  • Mis à jour : *.example.com et le nom du tableau de bord. Le domaine racine, www et vpn seulement s'ils pointaient déjà vers ce serveur. La messagerie et les autres enregistrements restent intacts.
  • Activé par défaut sur les nouvelles installations, désactivé sur les existantes jusqu'à ce que tu l'actives. Mis en pause automatiquement avec CGNAT et DS-Lite.
zh dyndns          # status
zh dyndns on       # turn on (--ipv6 also updates AAAA)
zh dyndns update   # update now