Como instalar o Adminer no Saplo: painel para bases MySQL e PostgreSQL sem SSH

Precisas de consultar uma tabela, corrigir um erro de digitação num registo ou exportar dados, e a única coisa que tens é o Painel Saplo e o endereço da aplicação. Na Box S não tens acesso SSH, e instalar um cliente de base de dados no teu computador só para, de vez em quando, dar uma vista de olhos na base de dados é um exagero. O Adminer resolve esse problema: é um painel administrativo para bases de dados, tudo num só ficheiro PHP, acessível a partir do navegador, sob o teu próprio domínio ou subdomínio. Neste guia, vamos mostrar como configurar o Adminer no Saplo e conectá-lo a uma base de dados MySQL ou PostgreSQL na mesma Box.

O que é o Adminer e para quem é útil?

O Adminer é um painel de gestão de bases de dados leve e de código aberto, que funciona como uma aplicação PHP num contentor Docker. Suporta MySQL, MariaDB, PostgreSQL e vários outros motores. Ao contrário da maioria das aplicações do catálogo da Saplo, o Adminer não cria a sua própria conta de administrador ou sessão - inicias sessão com as credenciais da base de dados sempre que acedes à página, tal como num cliente de desktop. Esta é uma decisão consciente: o painel não armazena nada do seu lado, por isso não adiciona uma nova superfície de ataque à tua Box.

É útil se já tens um módulo MySQL/MariaDB ou PostgreSQL na mesma Box e queres geri-lo sem iniciar sessão via SSH. É especialmente útil na Box S, onde não há acesso SSH, mas também em planos maiores - muitas vezes é mais rápido abrir o navegador do que iniciar um cliente SQL local. Podes encontrar uma descrição da aplicação na página de alojamento do Adminer na Saplo.

Requisitos e custo do alojamento

O Adminer requer apenas 256 MB de RAM e 2 GB de espaço em disco, portanto, o plano mais barato que cumpre os requisitos de instalação é o Box S, por 27 € por ano. Esta é a aplicação do painel em si - a base de dados à qual te ligas é um módulo separado (MySQL/MariaDB ou PostgreSQL), que ocupa os seus próprios recursos no mesmo Box. Se ainda não a tens, instala-a antes do Adminer.

Para a instalação, basta o painel da Saplo no teu navegador. Não precisas de SSH, do teu próprio cliente de base de dados ou de ferramentas adicionais no teu computador.

Instalação passo a passo

1. Se o teu Box ainda não tiver uma base de dados, inicia sessão no Painel Saplo, abre o catálogo de aplicações e instala o módulo MySQL / MariaDB ou PostgreSQL.
2. Após a instalação da base de dados, abre a página de detalhes no Painel e anota os dados do separador Dados de ligação: host, porta, nome da base de dados, utilizador e palavra-passe.
3. Volta ao catálogo de aplicações, seleciona Adminer e inicia a criação da aplicação.
4. Atribui-lhe um nome, por exemplo baza-panel, e indica o mesmo Box onde o módulo da base de dados está a ser executado.
5. Escolhe o domínio ou subdomínio *.saploapp.pl. Guarda o endereço HTTPS exato apresentado no Painel.
6. Confirma a instalação e aguarda o estado da aplicação.

O Adminer não cria contas nem guarda palavras-passe, por isso, no catálogo de aplicações não encontrarás um ficheiro com os dados de início de sessão para o Painel - existe apenas um ficheiro ADMINER-SETUP.txt com um lembrete sobre como ligar à base de dados no mesmo Box.

Iniciar sessão na base de dados

Abre o endereço da aplicação Adminer no teu navegador. Vais ver o ecrã de início de sessão com quatro campos:

• Sistema - escolhe MySQL ou PostgreSQL, dependendo do módulo de base de dados que instalaste.
• Servidor - o campo está preenchido previamente com o valor 127.0.0.1, que é o endereço da base de dados na mesma Box. Não alteres isto se a base de dados estiver localizada localmente.
• Utilizador e Palavra-passe - os mesmos dados que encontras no separador "Dados de ligação" do módulo da base de dados no painel Saplo.

Depois de iniciares sessão, seleciona o nome da base de dados na lista ou introduz-o manualmente, se o Adminer te pedir. Cada entrada na página é uma nova sessão - o Adminer não se lembra de nada entre visitas, por isso terás de repetir o início de sessão na próxima visita, a menos que o navegador guarde os dados no seu gestor de palavras-passe.

O que podes fazer no Adminer

Depois de iniciares sessão, tens uma vista completa da estrutura da base de dados: uma lista de tabelas, pré-visualização e edição de linhas, as tuas próprias consultas SQL, exportação da base de dados ou de uma única tabela para um ficheiro SQL e importação de dados de um ficheiro. Também podes alterar a estrutura das tabelas - adicionar e remover colunas, índices ou chaves - sem te conectares ao servidor via SSH. Isso é suficiente para tarefas administrativas típicas: corrigir um erro de digitação no conteúdo, pré-visualizar registos guardados na base de dados ou verificar rapidamente se a aplicação realmente guardou um novo registo.

Segurança

O Adminer não tem uma conta própria, o que significa que a única linha de defesa é a palavra-passe da própria base de dados. Qualquer pessoa que saiba o endereço da aplicação e as credenciais de login da base de dados terá acesso ao painel. Guarda a palavra-passe da base de dados com o mesmo cuidado com que guardas a palavra-passe do painel Saplo - não a envies por canais não encriptados e não partilhes o endereço da aplicação com pessoas que não precisem de acesso à base de dados. Se planeias usar o Adminer raramente, é uma boa ideia fechar o separador do navegador após o trabalho, em vez de deixar uma sessão aberta e com sessão iniciada na base de dados de produção.

Perguntas Frequentes

Quanto custa o Adminer na Saplo?

O plano mais barato que cumpre os requisitos de instalação é o Box S por 27 € anuais. A base de dados, à qual o Adminer se conecta, usa os recursos do mesmo Box.

O Adminer cria a base de dados automaticamente?

Não. O Adminer é apenas um painel de administração - ele irá conectar-se a uma base de dados já existente. Instala primeiro o módulo MySQL/MariaDB ou PostgreSQL no mesmo Box.

Por que não consigo fazer login?

Verifica se no campo "Sistema" selecionaste o motor compatível com o módulo de base de dados instalado e se o utilizador e a palavra-passe correspondem ao cartão "Dados de conexão" no painel Saplo. O campo "Servidor" deve ficar como 127.0.0.1 se a base de dados estiver no mesmo Box.

Posso conectar o Adminer a uma base de dados noutro Box?

Por padrão, o módulo da base de dados apenas escuta em 127.0.0.1, ou seja, dentro do mesmo Box, e não está acessível externamente. A conexão a uma base de dados noutro Box exigiria uma configuração de rede separada, que a Saplo não oferece na instalação padrão.

Os dados de login são gravados em algum lugar?

Não no lado do servidor. O Adminer não guarda sessões nem palavras-passe - tens de introduzir o login sempre que acedes, a menos que o teu gestor de palavras-passe no navegador o memorize.

Abre a oferta do Adminer na Saplo, instala-o no mesmo Box da base de dados e faz login com os dados que já tens no painel do módulo da base de dados.