Solution communautaire

Installer DDNS Updater sur ZimaOS

A community member shared a DuckDNS configuration for ddns-updater and later added screenshots showing how to locate, edit, restore, and restart the persistent config.

Ce que la configuration DDNS de la communauté cherchait à faire

La publication de la communauté partageait un exemple de config.json pour l’application ddns-updater utilisant DuckDNS. L’idée principale reste valable : le programme de mise à jour a besoin d’un fournisseur, d’un domaine, d’un identifiant ou d’un jeton, ainsi que d’une politique de version IP, et la configuration persistante doit être stockée à un emplacement que le conteneur peut lire après un redémarrage.

Pour un aperçu actuel axé sur ZimaOS, consultez le guide du matériel et de la configuration DuckDNS ainsi que le répertoire actuel des exigences du ZimaOS App Store.

Utiliser le schéma actuel de ddns-updater

Le projet en amont documente une configuration propre à chaque fournisseur. Ne copiez donc pas aveuglément un ancien exemple lorsque le schéma du fournisseur est susceptible d’avoir changé. La documentation actuelle de DuckDNS exige un domaine et un jeton DuckDNS et prend en charge les options de version IP. La référence officielle est la documentation DuckDNS de ddns-updater. Le fichier README principal du projet documente également les fournisseurs pris en charge et le comportement de la configuration persistante dans la documentation du projet ddns-updater.

{
  "settings": [
    {
      "provider": "duckdns",
      "domain": "your-name.duckdns.org",
      "token": "YOUR_TOKEN",
      "ip_version": "ipv4"
    }
  ]
}

Remplacez les espaces réservés par vos propres valeurs et ne publiez jamais le véritable jeton dans des captures d’écran, des messages sur des forums, des dépôts Git ou des tickets d’assistance.

Où trouver la configuration sur ZimaOS

Menu de l’application DDNS Updater de ZimaOS affichant les options de configuration et de redémarrage
Capture d’écran de la communauté issue du tutoriel DDNS Updater, montrant le menu de l’application utilisé pour accéder aux paramètres et redémarrer le service.
Icône de l’application Fichiers de ZimaOS utilisée pour localiser les données de l’application DDNS Updater
Capture d’écran de la communauté montrant l’application Fichiers utilisée pour accéder à la configuration persistante de DDNS Updater.
Interface Fichiers de ZimaOS affichant le dossier AppData sur le disque de stockage
Capture d’écran de la communauté montrant le dossier AppData sur le disque de stockage de ZimaOS avant l’ouverture du répertoire de données de DDNS Updater.
Répertoire AppData de ZimaOS avec le dossier ddns-updater mis en évidence
Capture d’écran de la communauté mettant en évidence le dossier ddns-updater dans AppData, où sont stockés les fichiers persistants de l’application.
Interface Fichiers de ZimaOS affichant le fichier config.json de DDNS Updater
Capture d’écran de la communauté montrant le fichier config.json dans le répertoire de données de DDNS Updater ; l’auteur de la publication originale recommande d’en faire une copie de sauvegarde avant de le modifier.

Le fil de discussion d’origine faisait référence à un chemin appdata/ddns-updater, mais le chemin exact sur l’hôte peut varier selon la manière dont l’application a été installée et le mappage de son stockage. Au lieu de supposer qu’il existe un chemin unique, ouvrez les paramètres de l’application dans ZimaOS et identifiez le volume persistant associé à l’emplacement de configuration du conteneur. Sauvegardez le fichier actuel avant de le modifier.

Comment valider la mise à jour

  1. Vérifiez que le conteneur démarre sans erreur d’analyse JSON.
  2. Consultez les journaux du programme de mise à jour pour détecter d’éventuelles erreurs d’authentification du fournisseur ou de domaine.
  3. Résolvez le nom d’hôte depuis un autre réseau ou à l’aide d’un résolveur DNS public.
  4. Comparez l’enregistrement A ou AAAA renvoyé avec votre adresse publique actuelle.
  5. Redémarrez l’application une fois pour confirmer que la configuration est persistante.

Le DDNS ne fait que maintenir un nom d’hôte associé à une adresse ; il ne crée pas à lui seul un accès distant sécurisé. Si votre objectif final est d’accéder à un serveur domestique à distance, comparez cette solution au modèle de connexion décrit dans l’accès distant de Zima Client avant d’exposer directement des services.

Changement de fournisseur et IPv6

Si vous utilisez Cloudflare ou un autre fournisseur, supprimez les champs propres à DuckDNS et suivez le schéma de ce fournisseur. Par exemple, la configuration actuelle de Cloudflare utilise des champs tels que l’identifiant de zone et un jeton API ; la documentation du fournisseur Cloudflare en amont fait foi.

FAQ

Pourquoi mon dossier appdata/ddns-updater est-il introuvable ?

Le chemin persistant sur l’hôte peut différer de celui utilisé dans l’exemple de la communauté. Vérifiez le mappage des volumes de l’application au lieu de créer un chemin système supposé.

Puis-je utiliser IPv4 et IPv6 ?

Oui, mais configurez l’option de version IP conformément à la documentation actuelle du fournisseur et vérifiez que votre fournisseur d’accès fournit réellement la famille d’adresses que vous souhaitez publier.

Le DDNS est-il la même chose qu’un VPN ?

Non. Le DDNS associe un nom d’hôte à une adresse IP qui change. L’authentification, le chiffrement, les règles de pare-feu et la conception de l’accès distant sont des aspects distincts.