Como Instalar a Ferramenta de Administração de Banco de Dados Adminer no Debian 12

Adminer (anteriormente phpMinAdmin) é uma ferramenta de administração de banco de dados completa escrita em PHP que suporta tanto RDBMS (Sistema de Gerenciamento de Banco de Dados Relacional) como MySQL/MariaDB, PostgreSQL, SQLite, MS SQL e Oracle, quanto NoSQL como MongoDB e outros (via plugin).

Adminer é uma alternativa ao phpMyAdmin. É uma ferramenta de gerenciamento de banco de dados leve, amigável e de alto desempenho que pode ser usada facilmente para gerenciar seus bancos de dados.

Neste guia, mostraremos como instalar a ferramenta de administração de banco de dados Adminer no servidor Debian 12. Você também irá proteger o Adminer através do módulo basic_auth do Apache.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador.
• Um banco de dados MySQL/MariaDB instalado.

Instalando o Adminer no Debian

Adminer é uma alternativa ao phpMyAdmin, mas também suporta o banco de dados PostgreSQL. Também é escrito em PHP e pode ser executado em quase qualquer sistema operacional com servidor web Apache ou Nginx.

No Debian, o pacote adminer está disponível por padrão, e você pode instalá-lo facilmente via repositório. Recomendamos que você instale o adminer em um servidor novo, pois ele instalará automaticamente os pacotes PHP e o servidor web Apache.

Antes de instalar o adminer, atualize o índice de pacotes do Debian com o seguinte comando.

sudo apt update

Encontre o pacote adminer no repositório padrão do Debian com o comando abaixo.

sudo apt info adminer

Você pode ver abaixo que o pacote adminer está disponível na seção web do repositório Debian e requer pelo menos PHP 8.2 e um servidor web Apache.

Agora instale o adminer com o seguinte comando. Isso também instala pacotes necessários como PHP e Apache automaticamente. Digite y para confirmar a instalação.

sudo apt install adminer

Após a instalação ser concluída, verifique o serviço Apache com o comando abaixo. Certifique-se de que o serviço Apache está em execução.

sudo systemctl status apache2

Protegendo a Instalação do Adminer

Agora que você instalou o adminer, o próximo passo é configurar sua instalação do adminer. Neste exemplo, você mudará o caminho da URL padrão para o Adminer e adicionará autenticação adicional via basic_auth. Dessa forma, você terá duas camadas de autenticação.

Além disso, você deve saber que o adminer gera novos arquivos de configuração do Apache em /etc/apache2/conf-available/adminer.conf. Você irá modificar este arquivo para configurar a instalação do adminer.

Antes de editar a configuração, execute o comando abaixo para gerar o arquivo de senha /etc/adminer/.htpasswd. Além disso, certifique-se de mudar o nome de usuário dbmanager pelo seu usuário.

O /etc/adminer/.htpasswd será usado como autenticação adicional via o módulo basic_auth do Apache para o Adminer.

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

Digite sua senha quando solicitado e repita.

Agora abra a configuração do Apache gerada para o adminer /etc/apache2/conf-available/adminer.conf usando o editor nano.

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

Na linha superior, mude a URL padrão de ‘/adminer ‘ para o novo caminho da URL. Neste exemplo, o adminer será acessível via o caminho da URL ‘ /dbmanager ‘.

Alias /dbmanager /etc/adminer  

  
Require all granted  
DirectoryIndex conf.php  

Insira a configuração abaixo para habilitar o basic_auth do Apache para o caminho ‘ /dbmanager ‘. Com isso, toda vez que você acessar o caminho ‘ /dbmanager ‘, será solicitado uma autenticação adicional do Apache basic_auth.

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

Salve e feche o arquivo quando terminar.

Em seguida, execute o comando abaixo para ativar a configuração adicional ‘adminer.conf’ no Apache e verificar a sintaxe geral do Apache.

sudo a2enconf adminer.conf  
sudo apachectl configtest

Certifique-se de que você tem a sintaxe correta e obtenha uma saída como Syntax OK.

Por fim, execute o comando abaixo para reiniciar o serviço Apache e aplicar a nova configuração para o Adminer. Após executar o comando, sua instalação do Adminer deve estar pronta.

sudo systemctl restart apache2

Configurando o Servidor MySQL/MariaDB

Neste ponto, seu Adminer está pronto, mas você ainda precisa preparar seu servidor MySQL criando um novo usuário que será especificado para o login do Adminer. Não é recomendado usar o usuário root diretamente.

Nota: Se você estiver se conectando através de um host remoto, certifique-se de que está via tunelamento SSH para criptografar sua conexão. Se você estiver usando um único servidor (MySQL + Adminer no mesmo servidor), você está pronto para começar.

Faça login no servidor MySQL/MariaDB com o comando abaixo. Insira sua senha de root do MySQL quando solicitado.

sudo mysql -u root -p

Execute as seguintes consultas para criar um novo usuário dbmanager para seu servidor MySQL. Neste exemplo, este usuário será usado para fazer login no servidor MySQL via Adminer. Portanto, certifique-se de mudar a seguinte senha para uma nova senha.

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;

Agora, execute a seguinte consulta para verificar a lista de usuários em seu servidor MySQL. Você deve ver o usuário dbmanager com o host padrão 127.0.0.1.

SELECT user,host FROM mysql.user;

Por fim, digite quit para sair do servidor MySQL.

Fazendo Login no Servidor MySQL via Adminer

Abra seu navegador web e visite a URL de instalação do Adminer http://192.168.5.15/dbmanager. Se sua instalação for bem-sucedida, você deverá ser solicitado a autenticação basic_auth. Insira seu nome de usuário e senha que você criou e clique em Entrar.

Uma vez bem-sucedido, você deve ver a página de login do Adminer. Agora selecione o sistema de banco de dados como MySQL, em seguida, insira os detalhes do host e porta, nome de usuário e senha do seu servidor MySQL. Clique em Login para confirmar.

Se você tiver as credenciais corretas do banco de dados, você deve estar conectado ao MySQL via Adminer.

Criando um Novo Banco de Dados e Usuário via Adminer

Nesta seção, você aprenderá como criar um novo banco de dados e usuário no MySQL/MariaDB via Adminer. Em seguida, você também fará login no novo banco de dados via novo usuário.

No painel do Adminer, clique no link Criar Banco de Dados. Você será apresentado à seguinte página.

Insira o nome do seu novo banco de dados e clique em Salvar. Neste exemplo, você criará um novo banco de dados testdb.

Em seguida, para criar um novo usuário MySQL/MariaDB, clique em Privilégios no painel, depois clique em Criar usuário.

Insira o nome de usuário e senha do banco de dados, em seguida, insira o nome do seu banco de dados na seção de privilégios. Role para baixo e clique em Salvar.

No exemplo a seguir, você criará um novo usuário testuser e dará ao usuário privilégios para o banco de dados testdb.

Por fim, faça login no Adminer com o usuário testuser no banco de dados testdb.

Se bem-sucedido, você deve estar logado no testdb via Adminer.

Conclusão

Parabéns! Você agora instalou com sucesso o Adminer como a ferramenta de gerenciamento de banco de dados para MySQL/MariaDB e PostgreSQL no servidor Debian 12. Você também protegeu o Adminer ao mudar o caminho da URL padrão e habilitar uma camada adicional de autenticação via o módulo basic_auth do Apache. Ao final, você fez login no servidor MySQL via a ferramenta Adminer.