Cómo instalar la herramienta de administración de bases de datos Adminer en Debian 12

Adminer (anteriormente phpMinAdmin) es una herramienta de administración de bases de datos completamente funcional escrita en PHP que admite tanto RDBMS (Sistema de Gestión de Bases de Datos Relacional) como MySQL/MariaDB, PostgreSQL, SQLite, MS SQL y Oracle, así como NoSQL como MongoDB y otros (a través de un complemento).

Adminer es una alternativa a phpMyAdmin. Es una herramienta de gestión de bases de datos ligera, fácil de usar y de alto rendimiento que se puede utilizar fácilmente para gestionar tus bases de datos.

En esta guía, te mostraremos cómo instalar la herramienta de administración de bases de datos Adminer en el servidor Debian 12. También asegurarás Adminer a través del módulo basic_auth de Apache.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Debian 12.
• Un usuario no root con privilegios de administrador.
• Una base de datos MySQL/MariaDB instalada.

Instalando Adminer en Debian

Adminer es una alternativa a phpMyAdmin, pero también admite la base de datos PostgreSQL. También está escrito en PHP y puede ejecutarse en casi cualquier sistema operativo con servidor web Apache o Nginx.

En Debian, el paquete adminer está disponible por defecto, y puedes instalarlo fácilmente a través del repositorio. Te recomendamos que instales adminer en el servidor nuevo porque instalará automáticamente los paquetes de PHP y el servidor web Apache.

Antes de instalar adminer, actualiza el índice de paquetes de Debian con el siguiente comando.

sudo apt update

Encuentra el paquete adminer en el repositorio Debian por defecto con el siguiente comando.

sudo apt info adminer

Puedes ver a continuación que el paquete adminer está disponible en la sección web del repositorio Debian y requiere al menos PHP 8.2 y un servidor web Apache.

Ahora instala adminer con el siguiente comando. Esto también instala automáticamente los paquetes requeridos como PHP y Apache. Escribe y para confirmar la instalación.

sudo apt install adminer

Después de que la instalación esté completa, verifica el servicio de Apache con el siguiente comando. Asegúrate de que el servicio de Apache esté en funcionamiento.

sudo systemctl status apache2

Asegurando la instalación de Adminer

Ahora que has instalado adminer, el siguiente paso es configurar tu instalación de adminer. En este ejemplo, cambiarás la ruta de URL predeterminada para Adminer y agregarás autenticación adicional a través de basic_auth. De esta manera, tendrás dos capas de autenticación.

Además, debes saber que adminer genera nuevos archivos de configuración de Apache en /etc/apache2/conf-available/adminer.conf. Modificarás este archivo para configurar la instalación de adminer.

Antes de editar la configuración, ejecuta el siguiente comando para generar el archivo de contraseñas /etc/adminer/.htpasswd. Además, asegúrate de cambiar el nombre de usuario dbmanager por tu usuario.

El /etc/adminer/.htpasswd se utilizará como autenticación adicional a través del módulo basic_auth de Apache para Adminer.

sudo htpasswd -B -c /etc/adminer/.htpasswd dbmanager

Escribe tu contraseña cuando se te pida y repítela.

Ahora abre la configuración de Apache generada para adminer /etc/apache2/conf-available/adminer.conf usando el editor nano.

sudo nano /etc/apache2/conf-available/adminer.conf

En la primera línea, cambia la URL predeterminada de ‘/adminer ‘ a la nueva ruta de URL. En este ejemplo, adminer será accesible a través de la ruta de URL ‘ /dbmanager ‘.

Alias /dbmanager /etc/adminer  
  
  
Require all granted  
DirectoryIndex conf.php  

Inserta la configuración a continuación para habilitar basic_auth de Apache para la ruta ‘ /dbmanager ‘. Con esto, cada vez que accedas a la ruta ‘ /dbmanager ‘, se te pedirá autenticación adicional de Apache basic_auth.

  
 AuthType Basic  
 AuthName "Recurso Restringido"  
 AuthBasicProvider file  
 AuthUserFile /etc/adminer/.htpasswd  
 Require valid-user  

Guarda y cierra el archivo cuando termines.

A continuación, ejecuta el siguiente comando para activar la configuración adicional ‘adminer.conf’ en Apache y verificar la sintaxis general de Apache.

sudo a2enconf adminer.conf  
sudo apachectl configtest

Asegúrate de tener la sintaxis correcta y obtener una salida como Syntax OK.

Por último, ejecuta el siguiente comando para reiniciar el servicio de Apache y aplicar la nueva configuración para Adminer. Después de ejecutar el comando, tu instalación de Adminer debería estar lista.

sudo systemctl restart apache2

Configurando el servidor MySQL/MariaDB

En este punto, tu Adminer está listo, pero aún necesitas preparar tu servidor MySQL creando un nuevo usuario que esté especificado para el inicio de sesión de Adminer. No se recomienda usar el usuario root directamente.

Nota: Si te estás conectando a través de un host remoto, asegúrate de hacerlo a través de un túnel SSH para cifrar tu conexión. Si estás utilizando un solo servidor (MySQL + Adminer en el mismo servidor), estás listo para continuar.

Inicia sesión en el servidor MySQL/MariaDB con el siguiente comando. Ingresa tu contraseña de root de MySQL cuando se te pida.

sudo mysql -u root -p

Ejecuta las siguientes consultas para crear un nuevo usuario dbmanager para tu servidor MySQL. En este ejemplo, este usuario se utilizará para iniciar sesión en el servidor MySQL a través de Adminer. Así que asegúrate de cambiar la siguiente contraseña por una nueva contraseña.

CREATE USER 'dbmanager'@'127.0.0.1' IDENTIFIED BY 'dbpassword';  
GRANT ALL PRIVILEGES ON *.* TO 'dbmanager'@'127.0.0.1' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Ahora, ejecuta la siguiente consulta para verificar la lista de usuarios en tu servidor MySQL. Deberías ver al usuario dbmanager con el host predeterminado 127.0.0.1.

SELECT user,host FROM mysql.user;

Por último, escribe quit para salir del servidor MySQL.

Iniciando sesión en el servidor MySQL a través de Adminer

Abre tu navegador web y visita la URL de instalación de Adminer http://192.168.5.15/dbmanager. Si tu instalación es exitosa, deberías ser recibido con la autenticación basic_auth. Ingresa tu nombre de usuario y contraseña que has creado y haz clic en Iniciar sesión.

Una vez que hayas iniciado sesión con éxito, deberías ver la página de inicio de sesión de Adminer. Ahora selecciona el sistema de base de datos como MySQL, luego ingresa los detalles del host y puerto, nombre de usuario y contraseña de tu servidor MySQL. Haz clic en Iniciar sesión para confirmar.

Si tienes las credenciales de base de datos adecuadas, deberías estar conectado a MySQL a través de Adminer.

Creando una nueva base de datos y usuario a través de Adminer

En esta sección, aprenderás cómo crear una nueva base de datos y usuario en MySQL/MariaDB a través de Adminer. Luego, también iniciarás sesión en la nueva base de datos a través del nuevo usuario.

En el panel de control de Adminer, haz clic en el enlace Crear base de datos. Se te presentará la siguiente página.

Ingresa el nombre de tu nueva base de datos y haz clic en Guardar. En este ejemplo, crearás una nueva base de datos testdb.

A continuación, para crear un nuevo usuario de MySQL/MariaDB, haz clic en Privilegios en el panel de control, luego haz clic en Crear usuario.

Ingresa el nombre de usuario y la contraseña de la base de datos, luego ingresa el nombre de tu base de datos en la sección de privilegios. Desplázate hacia abajo y haz clic en Guardar.

En el siguiente ejemplo, crearás un nuevo usuario testuser y le darás privilegios a la base de datos testdb.

Por último, inicia sesión en Adminer con el usuario testuser en la base de datos testdb.

Si es exitoso, deberías estar conectado a testdb a través de Adminer.

Conclusión

¡Felicidades! Ahora has instalado con éxito Adminer como la herramienta de gestión de bases de datos para MySQL/MariaDB y PostgreSQL en el servidor Debian 12. También has asegurado Adminer al cambiar la ruta de URL predeterminada y habilitar una capa de autenticación adicional a través del módulo basic_auth de Apache. Al final, has iniciado sesión en el servidor MySQL a través de la herramienta Adminer.