Risposta attuale: wg-easy v15 non ha una password predefinita universale
La domanda del 2024 su CasaOS chiedeva quale fosse la password predefinita dopo l'installazione di WireGuard Easy. Si riferiva a una generazione precedente dei pacchetti wg-easy. L'attuale wg-easy v15 avvia una configurazione iniziale esplicita, durante la quale crei personalmente nome utente e password. Non esistono credenziali universali sicure come «admin/admin» da pubblicare o riutilizzare.
In una nuova installazione di v15, crea il tuo account
L'attuale prima configurazione di wg-easy richiede nome utente, password e conferma durante la configurazione dell'utente, quindi le informazioni sull'host e sulla porta WireGuard.
Non usare i vecchi suggerimenti su PASSWORD o PASSWORD_HASH con v15
wg-easy v14 usava comunemente variabili d'ambiente come PASSWORD_HASH. La v15 ha modificato sostanzialmente la configurazione e il relativo percorso di migrazione importa la configurazione di v14 tramite il nuovo processo di configurazione. Se copi in v15 un file Compose di CasaOS vecchio di anni, le variabili di autenticazione possono essere fuorvianti o non supportate.
La pagina dei tag delle versioni di wg-easy avvisa gli utenti di abbinare le istruzioni alla versione dell'immagine e di evitare tag ambigui.
Controlla prima la versione dell'immagine del container
docker inspect wg-easy --format '{.Config.Image}'
docker logs --tail=100 wg-easySe usi la v14, segui la documentazione specifica per la migrazione e l'autenticazione della v14. Se usi la v15, utilizza il nuovo flusso di configurazione. Non modificare le impostazioni di autenticazione prima di conoscere la versione principale effettivamente in esecuzione.
Blocca una versione principale invece di usare un tag latest ambiguo
La documentazione attuale di wg-easy consiglia un tag con la versione principale, come :15, così gli aggiornamenti rimangono all'interno delle versioni v15 compatibili. In questo modo eviti modifiche incompatibili accidentali e rendi riproducibile la distribuzione su ZimaOS/CasaOS.
Proteggi l'interfaccia web come una console di amministrazione
La dashboard di wg-easy può creare e revocare client VPN, mostrare codici QR ed esporre la configurazione dei peer. Quando possibile, limita l'interfaccia alla LAN o alla VPN. Se deve essere pubblica, proteggila con HTTPS e un'autenticazione robusta.
L'accesso remoto Tailscale è un'alternativa quando ti serve soltanto l'accesso remoto al NAS, invece di gestire personalmente i peer WireGuard.
Rendi persistente /etc/wireguard prima di ricreare il container
Gli esempi Compose attuali di wg-easy rendono persistente la configurazione WireGuard. Esegui un backup di questi dati prima della migrazione o del recupero della password, così i peer esistenti non andranno persi semplicemente perché il container web viene sostituito.
Il backup di ZimaOS copre il livello di ripristino.
Se hai ereditato una vecchia password sconosciuta
Non cercare su Internet una credenziale «predefinita» e non esporre l'interfaccia mentre fai tentativi. Identifica la versione dell'immagine, conserva la configurazione, segui la procedura di reimpostazione o migrazione prevista per quella versione e cambia la password dopo aver ripristinato l'accesso.
Le chiavi WireGuard sono più importanti della password dell'interfaccia
La password della dashboard protegge l'amministrazione, mentre le chiavi private dei peer autenticano i client VPN. Se i file di configurazione o i codici QR sono stati esposti, cambiare soltanto la password web non revoca quei peer. Rimuovi e ricrea i client interessati.
Recupera l'accesso senza eliminare tutti i peer esistenti
Se non conosci la vecchia password web ma il servizio WireGuard sta ancora gestendo traffico, esegui un backup della configurazione persistente prima di ricreare qualsiasi elemento. Una reimpostazione della password o una migrazione da v14 a v15 non dovrebbe trasformarsi automaticamente nella reimpostazione delle chiavi VPN di ogni telefono e laptop. Conserva le definizioni dei peer esistenti, segui il processo di migrazione corrispondente alla versione principale e verifica ogni client dopo aver creato il nuovo account amministratore.
Inoltre, verifica la VPN dall'esterno della rete domestica dopo qualsiasi migrazione dell'autenticazione. Una pagina di amministrazione funzionante dimostra soltanto che l'interfaccia di gestione è operativa; non dimostra che l'inoltro UDP, le chiavi dei peer, le route o il DNS siano ancora configurati correttamente.
Domande frequenti
Qual è la password predefinita di wg-easy?
L'attuale v15 utilizza la creazione dell'account al primo avvio e non dispone di una password predefinita universale.
PASSWORD_HASH funziona ancora?
Appartiene al vecchio modello di configurazione della v14; la v15 utilizza un flusso di configurazione e migrazione diverso.
Come faccio a sapere quale versione di wg-easy utilizzo?
Controlla il tag dell'immagine del container e i log prima di seguire istruzioni di autenticazione specifiche per la versione.
Devo esporre l'interfaccia di wg-easy su Internet?
Preferisci l'accesso limitato alla LAN o alla VPN. Se l'esposizione pubblica è necessaria, usa HTTPS e un'autenticazione robusta.
La reimpostazione della password dell'interfaccia revocherà i client VPN?
No. Le chiavi dei peer WireGuard sono separate; revoca e ricrea ogni peer la cui configurazione è stata esposta.
