Tutoriales de VPS
Metabase en un VPS: Docker, fuentes de lectura y recuperación
Despliega Metabase con PostgreSQL y HTTPS, separando base de aplicación y fuentes de lectura. Revisa licencias, permisos, caché, consultas, suscripciones y copias recuperables.

Metabase conecta bases de datos con consultas, gráficos, paneles e informes programados. Un VPS permite alojar análisis interno sin copiar todo a una plataforma BI gestionada, aunque consultas y exportaciones siguen moviendo datos. Usa drivers y funciones compatibles con tu edición; ClickHouse puede necesitar un driver correspondiente.
Esta guía Ubuntu 24.04/Docker/PostgreSQL separa la base de la aplicación de las fuentes analíticas. Prueba permisos antes de invitar usuarios.
| Uso | CPU | RAM | Disco | Enfoque inicial |
|---|---|---|---|---|
| Laboratorio | 2 vCPU | 4 GB | 40 GB SSD | Fuente pequeña y concurrencia limitada |
| Equipo pequeño | 4 vCPU | 8 GB | 80 GB NVMe | Base de aplicación y espacio de copias separados |
| Varias fuentes | 8 vCPU | 16 GB+ | 160 GB NVMe+ | Separar análisis y limitar consultas |
Mide heap Java, resultados, tareas y PostgreSQL; no son garantías de capacidad. Configura A/AAAA para bi.example.com, abre administración/80/443 necesarios y mantén bases privadas. Redis no es necesario en este ejemplo. Consulta dimensionamiento.
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
Revisa el instalador root o usa paquetes soportados. Evita metabase/metabase:latest, fija versiones de aplicación/base/plugins y registra digests. Protege .env con chmod 600.
Guarda usuarios, consultas, paneles, permisos y conexiones cifradas. Necesita escritura y migraciones; solo las fuentes de informes son de lectura.
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
Genera MB_ENCRYPTION_SECRET_KEY en formato admitido y consérvalo; cambiarlo puede impedir leer credenciales guardadas.
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 es una referencia antigua, no la versión estable actual. Comprueba notas y ruta de actualización. Usa propietario dedicado con derechos de esquema necesarios; POSTGRES_USER de inicialización es superusuario y no sirve como cuenta mínima de informes. No lo reutilices en fuentes productivas.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 metabase
Espera migraciones y revisa logs. depends_on por sí solo no demuestra disponibilidad de PostgreSQL; añade healthcheck/dependencia adecuados si hace falta. No borres volúmenes por errores temporales de inicio.
Abre http://127.0.0.1:3000 mediante túnel SSH para inicializar en privado y después configura URL HTTPS final.
- Da acceso de lectura solo a esquemas/tablas necesarios.
- Usa red privada y TLS si la ruta no es confiable.
- Identifica nombre, responsable y propósito de cada fuente.
- Lleva análisis pesado a réplica, almacén analítico o resúmenes.
Prueba conexión, codificación, zona horaria y permisos con una consulta pequeña. No guardes contraseñas/tokens ni datos personales innecesarios en SQL/comentarios públicos. Una réplica también puede contener datos sensibles.
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
Activa el sitio una sola vez; comprueba enlaces existentes antes de repetir ln -s. Verifica DNS, renovación y URL pública. Caddy es otra opción. Para redirects/cookies/iframes, revisa HTTPS y X-Forwarded-Proto, confiando solo en proxies definidos. Configura embedding sin desactivar globalmente cabeceras de seguridad.
- Da acceso a colecciones/paneles aprobados y datos protegidos.
- Permite consultas de analistas sin escritura en producción.
- Limita administradores y separa cuentas de análisis diario.
- Usa grupos/paneles específicos para externos y prueba acceso real.
Visibilidad de colecciones no equivale a aislamiento por cliente/fila. Sandboxing, embedding avanzado, auditoría y controles pueden depender de licencia/versión. Desactiva enlaces públicos innecesarios, inventaría tokens compartidos y limita credenciales API. Un enlace público no autentica al visitante.
- Analiza consultas lentas, escaneos e índices.
- Crea resúmenes/vistas materializadas justificadas.
- Usa caché/refresco disponibles en tu edición, comprobando licencia y datos sensibles.
- Limita concurrencia, tiempo y filas mediante controles compatibles de aplicación/base.
- Separa análisis costoso en réplica de lectura o almacén adecuado.
Escalona refrescos: caché fría puede disparar muchas consultas. La caché no sustituye backups ni permisos.
Configura recuperación, suscripciones y avisos. Comprueba SPF/DKIM/DMARC, PTR del IP real y puerto/TLS del relay; su proveedor normalmente controla PTR. Prueba primero un destinatario administrativo.
docker compose logs --tail=200 metabase | grep -Ei "email|pulse|error"
Retira destinatarios que dejaron el equipo y revisa quién recibe exportaciones sensibles. Una prueba SMTP no confirma entrega programada.
Copia la base de aplicación separada de cada fuente que mantengas:
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
Activa pipefail y verifica exportación. Guarda nombre real de Compose, entorno, clave y plugins/drivers compatibles. Cifra .env y copias externas. Al menos mensualmente, restaura la misma versión aislada y prueba login, conexiones, consultas, paneles, permisos y suscripciones sin informes reales. Consulta recuperación.
- Registra digest, parámetros Java, PostgreSQL y drivers.
- Copia base de aplicación y configuración.
- Prueba ruta de migración, consultas, paneles, suscripciones y embedding.
- Programa mantenimiento e inicia imagen nueva fijada.
- Espera migraciones, revisa salud/logs y reabre acceso.
docker compose pull
docker compose up -d
docker compose logs --tail=300 metabase
docker compose ps
No conectes imagen antigua a una base migrada sin validar. Restaura la copia correspondiente en aislamiento y conserva claves.
Revisa logs Nginx/aplicación/PostgreSQL, 3000 privado, disponibilidad y credenciales.
Distingue presión web/Java, base de aplicación y fuente. Revisa conexiones, filas y caché compatible.
Comprueba SMTP, TLS, DNS, salida y logs. Separa errores de prueba directa y tareas programadas.
Revisa WAL, logs, exportaciones, retención y temporales. Valida copia externa antes de limpiar; nunca borres WAL activo manualmente.
- Aplicación/PostgreSQL sanos y versiones decididas.
- HTTPS, proxy, URL y cookies correctos.
- Fuentes con lectura restringida y acceso privado.
- Permisos, enlaces, embedding y tokens probados.
- SMTP, recuperación, suscripciones y avisos funcionan.
- Base de aplicación, fuentes mantenidas, configuración y claves con copia externa.
- Restauración aislada probada y cronometrada.
Empieza con una fuente restringida y pocos paneles útiles; mide coste de consultas antes de automatizar.
Lecturas relacionadas: