Soluzione della community

Installa DDNS Updater su 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.

Cosa cercava di fare la configurazione DDNS della community

Il post della community condivideva un esempio di config.json per l’applicazione ddns-updater utilizzando DuckDNS. L’idea di base è ancora valida: l’updater richiede un provider, un dominio, una credenziale o un token e una policy per la versione IP; inoltre, la configurazione persistente deve essere salvata in un percorso che il container possa leggere dopo il riavvio.

Per una panoramica aggiornata orientata a ZimaOS, consulta la guida all’hardware e alla configurazione di DuckDNS e l’attuale directory dei requisiti del ZimaOS App Store.

Usa lo schema attuale di ddns-updater

Il progetto upstream documenta la configurazione specifica per ogni provider, quindi non copiare automaticamente un vecchio esempio quando lo schema del provider potrebbe essere cambiato. La documentazione attuale di DuckDNS richiede un dominio DuckDNS e un token e supporta opzioni per la versione IP. Il riferimento autorevole è la documentazione DuckDNS di ddns-updater. Anche il README principale del progetto documenta i provider supportati e il comportamento della configurazione persistente nella documentazione del progetto ddns-updater.

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

Sostituisci i segnaposto con i tuoi valori e non pubblicare mai il token reale in screenshot, post sui forum, repository Git o richieste di assistenza.

Dove trovare la configurazione su ZimaOS

Menu dell’app DDNS Updater di ZimaOS con le opzioni di configurazione e riavvio
Screenshot della community tratto dal tutorial di DDNS Updater, che mostra il menu dell’app utilizzato per accedere alle impostazioni e riavviare il servizio.
Icona dell’app File di ZimaOS utilizzata per individuare i dati dell’applicazione DDNS Updater
Screenshot della community che mostra l’app File utilizzata per raggiungere la configurazione persistente di DDNS Updater.
Interfaccia File di ZimaOS che mostra la cartella AppData sull’unità di archiviazione
Screenshot della community che mostra la cartella AppData sull’unità di archiviazione di ZimaOS prima di aprire la directory dei dati di DDNS Updater.
Directory AppData di ZimaOS con la cartella ddns-updater evidenziata
Screenshot della community che evidenzia la cartella ddns-updater all’interno di AppData, dove sono archiviati i file persistenti dell’applicazione.
Interfaccia File di ZimaOS che mostra il file config.json di DDNS Updater
Screenshot della community che mostra config.json all’interno della directory dei dati di DDNS Updater; l’autore originale del post consiglia di eseguire un backup prima di modificarlo.

Il thread originale faceva riferimento al percorso appdata/ddns-updater, ma il percorso esatto sull’host può dipendere da come è stata installata l’app e da come è stato mappato lo spazio di archiviazione. Invece di presumere un unico percorso fisso, apri le impostazioni dell’app in ZimaOS e individua il volume persistente associato alla posizione di configurazione del container. Esegui un backup del file attuale prima di modificarlo.

Come convalidare l’aggiornamento

  1. Verifica che il container si avvii senza errori di analisi JSON.
  2. Controlla i log dell’updater per individuare errori di autenticazione del provider o del dominio.
  3. Risolvi il nome host da un’altra rete o tramite un resolver DNS pubblico.
  4. Confronta il record A o AAAA restituito con il tuo attuale indirizzo pubblico.
  5. Riavvia l’app una volta per verificare che la configurazione sia persistente.

Il DDNS mantiene solo un nome host associato a un indirizzo; non crea di per sé un percorso sicuro per l’accesso remoto. Se l’obiettivo finale è accedere da remoto a un server domestico, confronta questa soluzione con il modello di connessione descritto in accesso remoto di Zima Client prima di esporre direttamente i servizi.

Modifiche dei provider e IPv6

Se utilizzi Cloudflare o un altro provider, rimuovi i campi specifici di DuckDNS e segui lo schema del provider in questione. Ad esempio, la configurazione attuale di Cloudflare utilizza campi come l’identificatore della zona e un token API; la documentazione del provider Cloudflare upstream è la fonte di riferimento.

Domande frequenti

Perché manca la cartella appdata/ddns-updater?

Il percorso persistente sull’host potrebbe essere diverso da quello utilizzato nell’esempio della community. Controlla la mappatura dei volumi dell’app invece di creare un percorso di sistema ipotetico.

Posso utilizzare IPv4 e IPv6?

Sì, ma configura l’opzione della versione IP in base alla documentazione aggiornata del provider e verifica che il tuo ISP fornisca effettivamente il tipo di indirizzo che intendi pubblicare.

Il DDNS equivale a una VPN?

No. Il DDNS associa un nome host a un indirizzo IP dinamico. Autenticazione, crittografia, regole del firewall e progettazione dell’accesso remoto sono aspetti separati.