Tutoriais de VPS
Metabase na VPS: Docker, fontes de leitura e recuperação
Implante Metabase com PostgreSQL e HTTPS, separando banco da aplicação e fontes de leitura. Revise licenças, permissões, cache, consultas, assinaturas e backups recuperáveis.

O Metabase conecta bancos a consultas, gráficos, dashboards e relatórios agendados. Uma VPS hospeda análises internas sem copiar tudo para uma plataforma BI gerenciada, embora consultas e exportações ainda movam dados. Use drivers e funções suportados pela edição; ClickHouse pode exigir um driver correspondente.
Este guia Ubuntu 24.04/Docker/PostgreSQL separa banco da aplicação e fontes analíticas. Teste permissões antes de convidar usuários.
| Uso | CPU | RAM | Disco | Abordagem inicial |
|---|---|---|---|---|
| Laboratório | 2 vCPU | 4 GB | 40 GB SSD | Fonte pequena e concorrência limitada |
| Equipe pequena | 4 vCPU | 8 GB | 80 GB NVMe | Banco da aplicação e espaço de backup separados |
| Várias fontes | 8 vCPU | 16 GB+ | 160 GB NVMe+ | Separar análise e limitar consultas |
Meça heap Java, resultados, tarefas e PostgreSQL; não são garantias de capacidade. Configure A/AAAA para bi.example.com, abra administração/80/443 necessários e mantenha bancos privados. Redis não é necessário neste exemplo. Veja dimensionamento.
sudo apt update
sudo apt install -y ca-certificates curl git openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/metabase
sudo chown -R "$USER":"$USER" /opt/metabase
cd /opt/metabase
mkdir -p backups
Revise o instalador root ou use pacotes suportados. Evite metabase/metabase:latest, fixe versões de aplicação/banco/plugins e registre digests. Proteja .env com chmod 600.
Ele guarda usuários, consultas, dashboards, permissões e conexões criptografadas. Precisa de escrita e migrações; somente fontes de relatórios são de leitura.
MB_DB_TYPE=postgres
MB_DB_DBNAME=metabase
MB_DB_PORT=5432
MB_DB_USER=metabase
MB_DB_PASS=change-a-long-password
MB_DB_HOST=postgres
MB_JETTY_PORT=3000
MB_ENCRYPTION_SECRET_KEY=replace-with-a-random-secret
Gere MB_ENCRYPTION_SECRET_KEY no formato suportado e preserve-o; trocar a chave pode impedir leitura de credenciais salvas.
services:
postgres:
image: postgres:16
restart: unless-stopped
environment:
POSTGRES_DB: metabase
POSTGRES_USER: metabase
POSTGRES_PASSWORD: ${MB_DB_PASS}
volumes:
- postgres_data:/var/lib/postgresql/data
metabase:
image: metabase/metabase:v0.56.0
restart: unless-stopped
depends_on:
- postgres
ports:
- "127.0.0.1:3000:3000"
env_file:
- .env
volumes:
postgres_data:
v0.56.0 é referência antiga, não a versão estável atual. Confira notas e caminho de atualização. Use proprietário dedicado com direitos de esquema necessários; POSTGRES_USER da inicialização é superusuário, não conta mínima de relatórios. Não o reutilize nas fontes de produção.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 metabase
Espere migrações e confira logs. depends_on sozinho não comprova disponibilidade do PostgreSQL; adicione healthcheck/dependência adequados se necessário. Não apague volumes por erros temporários de início.
Abra http://127.0.0.1:3000 por túnel SSH para configurar em privado e depois defina URL HTTPS final.
- Dê leitura apenas aos esquemas/tabelas necessários.
- Use rede privada e TLS quando a rota não for confiável.
- Identifique nome, responsável e finalidade de cada fonte.
- Leve análise pesada para réplica, data warehouse ou resumos.
Teste conexão, codificação, fuso e permissões com consulta pequena. Não guarde senhas/tokens nem dados pessoais desnecessários em SQL/comentários públicos. Uma réplica também pode conter dados sensíveis.
sudo apt install -y nginx certbot python3-certbot-nginx
sudo nano /etc/nginx/sites-available/metabase
server {
listen 80;
server_name bi.example.com;
client_max_body_size 20m;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 300s;
}
}
sudo ln -s /etc/nginx/sites-available/metabase /etc/nginx/sites-enabled/metabase
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d bi.example.com
Ative o site uma vez; confira links existentes antes de repetir ln -s. Valide DNS, renovação e URL pública. Caddy é outra opção. Para redirects/cookies/iframes, confira HTTPS e X-Forwarded-Proto, confiando só em proxies definidos. Configure embedding sem desativar globalmente cabeçalhos de segurança.
- Dê acesso a coleções/dashboards aprovados e dados protegidos.
- Permita consultas de analistas sem escrita em produção.
- Limite administradores e separe contas de análise diária.
- Use grupos/dashboards específicos para externos e teste acesso real.
Visibilidade de coleção não isola clientes/linhas por si só. Sandboxing, embedding avançado, auditoria e controles podem depender de licença/versão. Desative links públicos desnecessários, inventarie tokens compartilhados e restrinja credenciais API. Link público não autentica visitantes.
- Analise consultas lentas, varreduras e índices.
- Crie resumos/views materializadas quando justificado.
- Use cache/atualização disponíveis na edição, conferindo licença e dados sensíveis.
- Limite concorrência, tempo e linhas por controles suportados da aplicação/banco.
- Separe análise cara em réplica de leitura ou data warehouse adequado.
Escalone atualizações: cache frio pode disparar muitas consultas. Cache não substitui backup nem permissões.
Configure recuperação de senha, assinaturas e avisos. Confira SPF/DKIM/DMARC, PTR do IP real e porta/TLS do relay; o provedor normalmente controla PTR. Teste primeiro um destinatário administrativo.
docker compose logs --tail=200 metabase | grep -Ei "email|pulse|error"
Remova destinatários que saíram da equipe e confira quem recebe exportações sensíveis. Teste SMTP não confirma entrega agendada.
Copie o banco da aplicação separadamente de cada fonte que você mantém:
mkdir -p /opt/metabase/backups
docker compose exec -T postgres pg_dump -U metabase metabase | gzip > /opt/metabase/backups/metabase-$(date +%F).sql.gz
cp .env docker-compose.yml /opt/metabase/backups/
docker compose config > /opt/metabase/backups/compose-$(date +%F).yaml
Ative pipefail e valide exportação. Guarde nome real do Compose, ambiente, chave e plugins/drivers compatíveis. Criptografe .env e cópias externas. Pelo menos mensalmente, restaure a mesma versão isolada e teste login, conexões, consultas, dashboards, permissões e assinaturas sem relatórios reais. Veja recuperação.
- Registre digest, parâmetros Java, PostgreSQL e drivers.
- Copie banco da aplicação e configuração.
- Teste caminho de migração, consultas, dashboards, assinaturas e embedding.
- Agende manutenção e inicie a nova imagem fixada.
- Espere migrações, confira saúde/logs e reabra acesso.
docker compose pull
docker compose up -d
docker compose logs --tail=300 metabase
docker compose ps
Não conecte imagem antiga a banco migrado sem validar. Restaure o backup correspondente em isolamento e preserve chaves.
Confira logs Nginx/aplicação/PostgreSQL, 3000 privada, prontidão e credenciais.
Diferencie pressão web/Java, banco da aplicação e fonte. Confira conexões, linhas e cache suportado.
Confira SMTP, TLS, DNS, saída e logs. Separe erros do teste direto e de tarefas agendadas.
Examine WAL, logs, exportações, retenção e temporários. Valide cópia externa antes de limpar; nunca apague WAL ativo manualmente.
- Aplicação/PostgreSQL saudáveis e versões escolhidas.
- HTTPS, proxy, URL e cookies corretos.
- Fontes com leitura restrita e acesso privado.
- Permissões, links, embedding e tokens testados.
- SMTP, recuperação, assinaturas e avisos funcionando.
- Banco da aplicação, fontes mantidas, configuração e chaves com backup externo.
- Restauração isolada testada e cronometrada.
Comece com fonte restrita e poucos dashboards úteis; meça custo de consultas antes de automatizar.
Leituras relacionadas: