Skip to main content

Passaggi per reimpostare la password dell'amministratore di Portainer

Quando si dimentica la password dell'account amministratore di Portainer e non si riesce ad accedere a Portainer, il sistema TerraMaster TNAS supporta il ripristino della password dell'account tramite comandi terminale SSH. È possibile utilizzare questo metodo per reimpostare la password di accesso admin senza alcuna perdita, consentendo di accedere normalmente a Portainer senza dover reinstallare l'applicazione e perdere i dati di configurazione esistenti.

Prerequisiti​

  1. Aprire il terminale SSH del proprio TNAS.
  2. Assicurarsi che Portainer sia stato arrestato nel Centro applicazioni TNAS (deve essere arrestato, altrimenti il file del database è bloccato e la reimpostazione fallirà).

Passaggi​

1. Individuare la directory dei dati di Portainer​

Innanzitutto, trovare la cartella dei dati di Portainer che contiene portainer.db.

Eseguire il seguente comando:

find /Volume1/@apps/Portainer -name "portainer.db"

Dopo l'esecuzione, verrà visualizzato un output simile a:

/Volume1/@apps/Portainer/portainer.db

Prendere nota del percorso /Volume1/@apps/Portainer: questa è la propria directory dei dati.

2. Eseguire il comando di reimpostazione ufficiale​

Sostituire /path/to/portainer nel comando seguente con il percorso della directory dei dati trovato nel passaggio precedente, quindi copiarlo ed eseguirlo nel terminale:

docker run --rm -v /path/to/portainer:/data portainer/helper-reset-password

Ad esempio:

Se la directory dei dati è /Volume1/@apps/Portainer, il comando completo è:

docker run --rm -v /Volume1/@apps/Portainer:/data portainer/helper-reset-password

3. Ottenere la nuova password​

Dopo aver eseguito il comando, il terminale mostrerà qualcosa come:

2025/04/22 12:00:00 Password successfully updated for user: admin
2025/04/22 12:00:00 Use the following password to login:  aBcD1234!@#$
  • La prima riga indica che la reimpostazione è riuscita.
  • Il valore aBcD1234!@#$ nella seconda riga è la nuova password temporanea – copiarla!

4. Avviare Portainer e accedere​

  1. Tornare al Centro applicazioni TNAS e riavviare Portainer.
  2. Aprire la pagina web di Portainer (indirizzo predefinito: http://proprio_IP_TNAS:9000).
  3. Inserire admin come nome utente, incollare la password temporanea copiata nel passaggio precedente e sarà possibile accedere.

5. (Fortemente consigliato) Cambiare immediatamente la password dopo l'accesso​

  1. Dopo aver effettuato l'accesso a Portainer, fare clic sull'avatar utente nell'angolo in alto a destra.
  2. Selezionare My Account → Change Password.
  3. Inserire la password temporanea, impostare la propria nuova password e salvare.

Domande frequenti​

1. Perché è necessario arrestare Portainer prima?​

Perché Portainer blocca il file portainer.db durante l'esecuzione; lo strumento di reimpostazione non può modificarlo. Una volta arrestato, il file viene rilasciato e la reimpostazione può riuscire.

2. Dopo la reimpostazione, gli utenti e le configurazioni creati in precedenza andranno persi?​

Questa operazione reimposta solo la password dell'account amministratore. Non elimina né modifica altri utenti, ambienti di esecuzione, file di modello o qualsiasi parametro di configurazione di sistema.

3. Il comando restituisce docker: command not found?​

Ciò significa che Docker Engine non è abilitato sul proprio TNAS. Andare al Centro applicazioni TNAS, installare e abilitare Docker Engine, quindi eseguire di nuovo il comando.

4. Nessuna password visualizzata dopo l'esecuzione del comando?​

  • Verificare che il percorso della directory dei dati sia corretto.
  • Confermare che Portainer sia completamente arrestato.
  • Eseguire di nuovo il comando.