CloudBeaver | Database | Docker
CloudBeaver: Gestor de bases de datos web con DBeaver en el navegador
Accede y administra múltiples bases de datos desde cualquier navegador. Interfaz web potente basada en el popular DBeaver con soporte para SQL, NoSQL y más.
¿Qué es CloudBeaver?
CloudBeaver Community es una aplicación web de código abierto que funciona como un
gestor de bases de datos universal accesible desde el navegador. Está basado en el popular DBeaver Desktop y permite conectar múltiples bases de datos sin instalar nada en el cliente.
Es una solución self-hosted ideal para equipos de desarrollo, DevOps, analistas de datos y administradores de bases de datos que necesitan acceso centralizado y compartido a sus bases de datos desde cualquier dispositivo.
Multi-plataforma: Funciona desde cualquier navegador moderno. No necesitas instalar clientes ni drivers. Solo necesitas acceso a la URL de tu servidor CloudBeaver.
Características principales
Múltiple soporte de bases de datos
MySQL, PostgreSQL, SQL Server, Oracle, MariaDB, SQLite, MongoDB, Redis, ClickHouse, DuckDB y muchas más.
Editor SQL completo
Autocompletado, resaltado de sintaxis, ejecución de scripts, historial de consultas y más.
Explorador de datos
Navega tablas, filtros avanzados, ordenación, edición inline y exportación de datos.
Diagramas ER
Visualiza las relaciones entre tablas de forma gráfica con diagramas de entidad-relación.
Gestión de usuarios
Sistema de autenticación integrado con control de acceso y permisos por roles.
Autenticación flexible
Soporta local, LDAP, Active Directory, OAuth, OpenID, SAML, Kerberos, AWS IAM y más.
API GraphQL
API completa para integración con otras aplicaciones y automatización de tareas.
Data transfer
Importa y exporta datos entre diferentes bases de datos y formatos (CSV, JSON, SQL, etc.).
Instalación rápida con Docker
Opción 1: Docker Run
docker run --name cloudbeaver --rm -ti \
-p 8978:8978 \
-v /var/cloudbeaver/workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
Accede a http://localhost:8978 y completa la configuración inicial.
Opción 2: Docker Run en background
docker run --name cloudbeaver -d --restart unless-stopped \
-p 8978:8978 \
-v /var/cloudbeaver/workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
Opción 3: Docker Compose (recomendado)
services:
cloudbeaver:
image: dbeaver/cloudbeaver:latest
container_name: cloudbeaver
ports:
- "8978:8978"
volumes:
- cloudbeaver-workspace:/opt/cloudbeaver/workspace
restart: unless-stopped
volumes:
cloudbeaver-workspace:
Configuración avanzada
Acceso a bases de datos en el host
Si necesitas que CloudBeaver se conecte a una base de datos que corre en la máquina host:
docker run --name cloudbeaver -d --restart unless-stopped \
--network host \
-v /var/cloudbeaver/workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
O especifica la IP del host:
docker run --name cloudbeaver -d --restart unless-stopped \
--add-host=host.docker.internal:TU-IP-HOST \
-p 8978:8978 \
-v /var/cloudbeaver/workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
Variables de entorno comunes
CB_SERVER_NAME=CloudBeaver Server
CB_SERVER_URL=http://localhost:8978
CB_ADMIN_NAME=cbadmin
CB_ADMIN_PASSWORD=admin
Tip: Después del primer login, configura un usuario administrador seguro. La contraseña por defecto se muestra en los logs del contenedor.
Actualizar CloudBeaver
Importante: realiza siempre un backup del workspace antes de actualizar. No se soportan downgrades.
docker stop cloudbeaver
docker rm cloudbeaver
docker pull dbeaver/cloudbeaver:latest
docker run --name cloudbeaver -d --restart unless-stopped \
-p 8978:8978 \
-v /var/cloudbeaver/workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
Despliegue offline
Si necesitas desplegar en un servidor sin acceso a internet:
Paso 1: Crear el archivo de imagen en máquina con internet
docker pull dbeaver/cloudbeaver:latest
docker save dbeaver/cloudbeaver:latest | gzip > cloudbeaver.tar.gz
Paso 2: Transferir al servidor destino
Usa scp, rsync o método equivalente para copiar cloudbeaver.tar.gz.
Paso 3: Cargar y ejecutar en el servidor offline
docker load < cloudbeaver.tar.gz
docker run --name cloudbeaver -d --restart unless-stopped \
-p 8978:8978 \
-v /var/cloudbeaver/workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
Backup y restore del workspace
Backup
docker run --rm \
-v cloudbeaver-workspace:/source \
-v $(pwd):/backup \
alpine tar czf /backup/cloudbeaver-backup-$(date +%Y%m%d).tar.gz -C /source .
Restore
docker stop cloudbeaver
docker run --rm \
-v cloudbeaver-workspace:/target \
-v $(pwd):/backup \
alpine tar xzf /backup/cloudbeaver-backup-YYYYMMDD.tar.gz -C /target
docker start cloudbeaver
Importante: Siempre detén el contenedor antes de restaurar. Restaurar sobre un contenedor en ejecución puede corromper datos y configuraciones.
Configurar HTTPS con Nginx (reverse proxy)
server {
listen 443 ssl;
server_name tu-dominio.com;
ssl_certificate /etc/nginx/ssl/cert.pem;
ssl_certificate_key /etc/nginx/ssl/key.pem;
location / {
proxy_pass http://127.0.0.1:8978;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
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_cache_bypass $http_upgrade;
}
}
Tip: CloudBeaver usa WebSockets para ciertas funciones. Asegúrate de incluir los headers Upgrade y Connection en tu configuración de Nginx o Apache.
Uso básico
Primer acceso y configuración
- Accede a
http://tu-servidor:8978
- Crea el usuario administrador (se muestra la contraseña temporal en logs si no se definió)
- Inicia sesión con las credenciales del administrador
- Ve a Administration para gestionar usuarios y conexiones
Crear una nueva conexión a base de datos
- Haz clic en New Connection
- Selecciona el tipo de base de datos (PostgreSQL, MySQL, etc.)
- Configura los parámetros de conexión (host, puerto, usuario, contraseña)
- Prueba la conexión con Test Connection
- Guarda la conexión
Ahora puedes explorar tablas, ejecutar consultas SQL, editar datos y generar diagramas ER.
Conexiones más populares
- PostgreSQL: Host, puerto 5432, nombre de base de datos
- MySQL/MariaDB: Host, puerto 3306, nombre de base de datos
- SQL Server: Host, puerto 1433, nombre de instancia
- SQLite: Ruta al archivo
.db o .sqlite
- MongoDB: Host, puerto 27017, nombre de base de datos
Gestión y mantenimiento
Ver logs
docker compose logs -f cloudbeaver
docker logs -f cloudbeaver
Logs de consultas SQL
Desde la interfaz web ve a Tools → Query History para revisar todas las consultas ejecutadas.
Ver información del servidor
docker exec cloudbeaver cat /opt/cloudbeaver/workspace/.metadata/.log
Reiniciar CloudBeaver
docker compose restart cloudbeaver
Detener CloudBeaver
docker compose down
Casos de uso
- Equipos de desarrollo: Acceso compartido y centralizado a bases de datos de desarrollo, staging y producción
- DevOps/DBAs: Gestión unificada de múltiples motores de bases de datos desde una única interfaz web
- Analistas de datos: Exploración de datos, ejecución de consultas SQL y exportación sin necesidad de instalar clientes
- Educación: Plataforma de enseñanza de SQL y administración de bases de datos accesible desde el navegador
- Consultorías TI: Acceso rápido y seguro a bases de datos de clientes sin exponer infraestructura
- Startups: Herramienta de gestión de datos con coste cero y despliegue sencillo en Docker
Sígueme en mis redes sociales
Comentarios
Publicar un comentario