Soluzione più probabile: Duplicati in Docker usa DUPLICATI__WEBSERVICE_PASSWORD, con due caratteri di sottolineatura, per la password dell’interfaccia. SETTINGS_ENCRYPTION_KEY cripta le impostazioni sensibili nel database; non è la password da inserire nel browser.
Usa le due variabili per scopi diversi
environment:
SETTINGS_ENCRYPTION_KEY: "long-random-key"
DUPLICATI__WEBSERVICE_PASSWORD: "your-ui-password"La documentazione di Duplicati sulle variabili dei secret Docker descrive questa separazione.
Ricrea il container dopo aver modificato l’ambiente
Un container in esecuzione conserva l’ambiente con cui è stato avviato. Ricrealo dopo aver modificato i valori di Compose:
docker compose up -d --force-recreateQuindi verifica i nomi delle variabili senza esporre i relativi valori segreti:
docker inspect duplicati --format '{{range .Config.Env}}{{println .}}{{end}}' | grep -E 'DUPLICATI|SETTINGS'Controlla la protezione del nome host
Se l’accesso tramite IP diretto funziona ma quello tramite nome host o proxy inverso non funziona, configura gli host consentiti:
DUPLICATI__WEBSERVICE_ALLOWED_HOSTNAMES=backup.example.comUn carattere jolly * disabilita la protezione e non è l’impostazione predefinita consigliata.
Non confondere la crittografia con l’autenticazione
SETTINGS_ENCRYPTION_KEY protegge le credenziali archiviate nel database di Duplicati. Esegui un backup sicuro di questa chiave, perché perderla può rendere indisponibili le impostazioni crittografate dopo una migrazione.
Se l’accesso continua a non funzionare
- controlla la presenza di una vecchia variabile della password in conflitto;
- leggi i log del container dopo averlo ricreato;
- prova l’indirizzo IP diretto della LAN prima del proxy;
- verifica che il browser raggiunga il container e la porta previsti;
- non eliminare il database di Duplicati come primo tentativo.
Il flusso di lavoro per backup e sincronizzazione aiuta a distinguere il backup dalla sincronizzazione. Il catalogo delle app di ZimaOS aiuta a confrontare gli strumenti di backup.
Per l’archiviazione dei backup su più unità, ZimaCube 2 è una piattaforma hardware adatta.
Perché sono importanti i due caratteri di sottolineatura
Duplicati converte le opzioni della riga di comando in variabili d’ambiente sostituendo il prefisso dell’opzione con DUPLICATI__. Una variabile apparentemente simile con un solo carattere di sottolineatura non indica la stessa impostazione. È un problema comune nei container, perché l’interfaccia continua a caricarsi anche quando l’opzione di autenticazione desiderata non è mai stata applicata.
Verifica il container attivo, non solo il modulo di CasaOS
CasaOS può mostrare i valori inseriti, ma la prova decisiva è l’ambiente all’interno del container creato. Ispeziona la configurazione in esecuzione e riavvia o ricrea il container solo dopo che compare il nome di variabile previsto.
Controlla i log durante il tentativo di accesso
docker logs -f duplicatiProva ad accedere una volta e controlla la presenza di rifiuti del nome host, errori di autenticazione, errori del database o avvisi all’avvio. In questo modo puoi distinguere una password errata da un problema del proxy o dell’header dell’host.
Prova l’IP diretto prima del proxy inverso
Accedi temporaneamente a Duplicati tramite l’IP LAN dell’host CasaOS e la porta pubblicata. Se funziona mentre il dominio no, concentrati sui nomi host consentiti e sugli header del proxy inverso invece di reimpostare le credenziali.
Conserva la chiave di crittografia durante la migrazione
La chiave di crittografia protegge le impostazioni archiviate, come le credenziali del backend. Salvala in un gestore di password o in un altro backup sicuro, indipendente dal server. Un sistema di backup il cui segreto viene conservato solo sulla macchina che protegge crea un problema di ripristino.
Evita innanzitutto le correzioni distruttive della password
L’eliminazione del database di Duplicati può rimuovere la configurazione e la cronologia dei processi di backup. Verifica le variabili d’ambiente, lo stato del container attivo, i nomi host e i log prima di prendere in considerazione il ripristino del database o la reinstallazione.
Domande frequenti
SETTINGS_ENCRYPTION_KEY è la mia password di accesso?
No. Usa DUPLICATI__WEBSERVICE_PASSWORD per l’autenticazione nell’interfaccia web.
Perché la modifica della password non ha avuto effetto?
Il vecchio container potrebbe avere ancora l’ambiente precedente. Ricrealo.
