Skip to main content

Pasos para restablecer la contraseña del administrador de Portainer

Requisitos previos​

  1. Abra la terminal SSH de su TNAS.
  2. Asegúrese de que Portainer se haya detenido en el Centro de aplicaciones de TNAS (debe estar detenido; de lo contrario, el archivo de la base de datos estará ocupado y el restablecimiento fallará).

Pasos​

1. Localice su directorio de datos de Portainer​

Primero, busque la carpeta de datos de Portainer que contiene portainer.db.

Ejecute el siguiente comando:

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

Después de la ejecución, verá una salida similar a:

/Volume1/@apps/Portainer/portainer.db

Anote la ruta /Volume1/@apps/Portainer – este es su directorio de datos.

2. Ejecute el comando de restablecimiento oficial​

Reemplace /path/to/portainer en el siguiente comando con la ruta del directorio de datos que encontró en el paso anterior, luego cópielo y ejecútelo en la terminal:

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

Por ejemplo:

Si su directorio de datos es /Volume1/@apps/Portainer, el comando completo es:

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

3. Obtenga la nueva contraseña​

Después de ejecutar el comando, la terminal mostrará algo como:

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 primera línea indica que el restablecimiento fue exitoso.
  • El aBcD1234!@#$ de la segunda línea es la nueva contraseña temporal – ¡cópiela!

4. Inicie Portainer e inicie sesión​

  1. Vuelva al Centro de aplicaciones de TNAS y reinicie Portainer.
  2. Abra la página web de Portainer (dirección predeterminada: http://su_IP_TNAS:9000).
  3. Ingrese admin como nombre de usuario, pegue la contraseña temporal que copió en el paso anterior y podrá iniciar sesión.

5. (Muy recomendado) Cambie la contraseña inmediatamente después de iniciar sesión​

  1. Después de iniciar sesión en Portainer, haga clic en el avatar de usuario en la esquina superior derecha.
  2. Seleccione My Account → Change Password.
  3. Ingrese la contraseña temporal, establezca su propia nueva contraseña y guarde.

Preguntas frecuentes​

1. ¿Por qué necesito detener Portainer primero?​

Porque Portainer bloquea el archivo portainer.db mientras se ejecuta; la herramienta de restablecimiento no puede modificarlo. Una vez detenido, el archivo se libera y el restablecimiento puede realizarse correctamente.

2. ¿Se perderán mis usuarios y configuraciones creados anteriormente después del restablecimiento?​

Esta operación solo restablece la contraseña de la cuenta de administrador. No elimina ni modifica otros usuarios, entornos de ejecución, archivos de plantilla ni ningún parámetro de configuración del sistema.

3. ¿El comando devuelve docker: command not found?​

Esto significa que el motor de Docker no está habilitado en su TNAS. Vaya al Centro de aplicaciones de TNAS, instale y habilite Docker Engine, y luego vuelva a ejecutar el comando.

4. ¿No veo la salida de la contraseña después de ejecutar el comando?​

  • Verifique si la ruta del directorio de datos es correcta.
  • Confirme que Portainer se haya detenido por completo.
  • Vuelva a ejecutar el comando.