Alternativa ao DBeaver no navegador: como implantar LibreDB Studio com Docker ou Helm

LibreDB Studio é um gestor de banco de dados open source que funciona no navegador e é implantado no seu próprio servidor com um único comando do Docker. Todo o seu time trabalha a partir de uma única instância compartilhada, em vez de instalar um cliente desktop em cada máquina. A versão 0.16.0 foi lançada em 17 de setembro de 2026 com licença MIT e se conecta a 16 engines próprios, do PostgreSQL, MySQL e Oracle ao MongoDB, Redis e ClickHouse.

Antes de instalar: use a versão 0.16.2 ou posterior. Duas das correções da série 0.16 fecham falhas entre contas em instâncias compartilhadas. Os detalhes estão na seção de segurança, mais abaixo.

O que é LibreDB Studio?

LibreDB Studio é uma IDE SQL web (um web SQL IDE, ou self-hosted SQL client) construída sobre Next.js, com o editor Monaco, o mesmo engine do VS Code. O projeto se posiciona entre os clientes desktop pesados, como DataGrip ou DBeaver, e as ferramentas de linha de comando.

Cobre o que você espera de um cliente desktop:

  • autocompletar que conhece seu schema
  • planos EXPLAIN visuais
  • diagramas entidade-relacionamento interativos, exportáveis para PNG ou SVG
  • comparação de schemas com geração do SQL de migração
  • uma grade de dados virtualizada com edição em linha
  • exportação para CSV e JSON

E adiciona funcionalidades que fazem sentido apenas em um servidor compartilhado: login único com OIDC, um registro de auditoria de consultas e conexões que o administrador provisiona.

Também tem um painel de IA. Gera SQL a partir de linguagem natural, avisa antes de executar consultas destrutivas e explica os planos de execução. Funciona com Gemini, OpenAI ou um modelo local via Ollama. A IA é um painel dentro de uma IDE SQL convencional, não o propósito do produto, e nenhuma função de IA é ativada até que você configure uma chave de API.

O que mudou na 0.16.0 é a árvore de schemas. Cada engine agora declara seus próprios tipos de objeto, então as views, as materialized views, os dicionários do ClickHouse, os packages do Oracle e as bibliotecas de funções do Redis aparecem com o nome que cada engine usa. Antes, a árvore era uma lista plana de tabelas. Você pode abrir a definição de um objeto em uma aba somente leitura e, em funções e procedures do PostgreSQL, também editá-la e aplicá-la.

O LibreDB Studio é gratuito?

Sim. O código tem licença MIT e o repositório afirma que não há nada reservado por trás de um muro enterprise. SSO, RBAC, o registro de auditoria e o painel de monitoramento estão todos na versão open source. O projeto é financiado com GitHub Sponsors.

Quais bancos de dados ele suporta?

Na versão 0.16, tem providers próprios para esses engines:

  • SQL: PostgreSQL, MySQL, Oracle, SQL Server, SQLite, libSQL/Turso, DuckDB, ClickHouse
  • Analítica e busca: Apache Druid, Elasticsearch, OpenSearch, Trino
  • Documentais e colunares: MongoDB, Couchbase, Cassandra
  • Chave-valor: Redis

Mais de vinte engines adicionais se conectam através de um desses drivers porque falam o mesmo protocolo, como MariaDB, TiDB, Valkey, CockroachDB, TimescaleDB ou YugabyteDB.

Aqui o projeto faz algo incomum: testa cada engine compatível contra uma instância real e publica um nível de suporte (Full, Partial ou Query editor only). Também documenta as imprecisões conhecidas. Por exemplo, no Citus a contagem de linhas descreve a tabela vazia do coordinador, não os shards. Revise essa tabela antes de confiar em um número em um engine compatível. A lista cresce quase a cada versão, então considere esses números como vigentes na data de publicação desta nota.

Como instalar LibreDB Studio com Docker ou Helm?

O caminho mais rápido é com Docker:

docker run -d -p 3000:3000 ghcr.io/libredb/libredb-studio:0.16.2

Abra http://localhost:3000. No primeiro arranque, o servidor gera a senha do administrador e o segredo JWT, e imprime a senha uma única vez no log do container (docker logs <container>).

A documentação do projeto usa a tag :latest. Nós fixamos 0.16.2 porque saíram versões de patch em 19 e 21 de setembro, poucos dias depois da 0.16.0, e uma delas é uma correção de segurança. A partir da 0.16.1, cada tag é publicada também em variantes -alpine e -alpine-slim. A -alpine-slim é a imagem menor, mas não inclui o driver do DuckDB.

Sem Docker, você pode executá-lo com Node.js 20.9 ou posterior:

npx @libredb/studio

Em Kubernetes, fixe a versão do chart:

helm repo add libredb https://libredb.org/libredb-studio/
helm repo update
helm install libredb libredb/libredb-studio --version 0.1.68

O chart 0.1.68 implanta por padrão a versão 0.16.2 da aplicação. O README também documenta Homebrew, pacotes deb/rpm com serviço systemd, Snap e winget.

Como preparar um gestor de banco de dados compartilhado para seu time?

O arranque sem configuração serve para um teste local, não para um time. Quatro ajustes fazem a diferença.

1. Desative os segredos autogenerados

Defina AUTH_BOOTSTRAP=off, que é o que o projeto recomenda em produção. Depois configure você mesmo JWT_SECRET (mínimo 32 caracteres; o README sugere openssl rand -base64 32) e ADMIN_PASSWORD.

2. Use SSO, não as contas locais

O provider local tem exatamente duas contas: um administrador e um user opcional. Todas as pessoas que conhecem a senha de user compartilham a mesma identidade. A identidade por pessoa vem de OIDC:

NEXT_PUBLIC_AUTH_PROVIDER=oidc
OIDC_ISSUER=https://seu-provedor.com
OIDC_CLIENT_ID=seu_client_id
OIDC_CLIENT_SECRET=seu_client_secret
OIDC_ROLE_CLAIM=realm_access.roles   # opcional: atribua o papel de admin a partir de um claim

Funciona com qualquer provedor OIDC, como Keycloak, Okta, Azure AD, Auth0, Zitadel ou Google.

Se você ficar com as contas locais, a 0.16.0 adicionou um segundo fator opcional: um código TOTP de 6 dígitos, que se ativa por conta com ADMIN_TOTP_SECRET e USER_TOTP_SECRET, ou com secrets.adminTotpSecret e secrets.userTotpSecret no chart. O segredo deve ser base32 válido e decodificar para pelo menos 128 bits. Um valor inválido bloqueia o login com um erro que nomeia a variável, em vez de desativar o fator silenciosamente.

3. Provisione as conexões para que ninguém tenha credenciais

Um arquivo YAML de seed connections define as conexões de forma centralizada. Cada conexão é restrita por função, e as senhas são injetadas a partir de variáveis de ambiente com a sintaxe ${ENV_VAR}, nunca escritas no arquivo. Monte-o e aponte SEED_CONFIG_PATH para ele. As conexões marcadas com managed: true são somente leitura para os usuários.

4. Escolha armazenamento persistente

O valor padrão, STORAGE_PROVIDER=local, salva os metadados de conexão no navegador de cada pessoa. Use sqlite ou postgres (com STORAGE_POSTGRES_URL) para salvá-los no servidor, por usuário.

Com isso, a aba de auditoria do administrador registra as consultas executadas a partir da aplicação. A partir de 0.16.0 você pode exportá-la filtrada.

O que revisar antes de abrir para sua equipe?

Na série 0.16 o projeto encontrou e corrigiu duas falhas que só aparecem em instâncias compartilhadas:

  • 0.16.0: em uma conexão compartilhada, uma conta podia reverter a transação não confirmada de outra conta. Agora cada transação pertence à conta que a abriu, com uma concessão de cinco minutos de inatividade.
  • 0.16.2: os mantenedores pontuaram com 8.8 o aviso GHSA-3wh2-8x78-jfw4. Uma solicitação podia nomear o identificador de conexão de outra sessão e receber aquela conexão viva, já autenticada. Uma conta user podia alcançar uma conexão restrita a administradores. As notas de versão recomendam atualizar se mais de uma conta acessa sua instância.

Ambas foram publicadas com todos os detalhes, e as reproduções ficaram como testes. É um bom sinal sobre o projeto, mas também te diz onde está o risco: não execute nada anterior à 0.16.2 em uma instância multiusuário.

Três limites que valem a pena conhecer antes de passá-lo por uma revisão de segurança:

  • O mascaramento de dados é apenas do lado do cliente. O README diz explicitamente: as respostas da API ainda incluem os valores completos. Funciona para compartilhar tela, não para proteger dados.
  • Reutilização de códigos TOTP entre réplicas. O registro de códigos usados vive na memória do processo, então com várias réplicas um código capturado pode ser reutilizado uma vez para cada réplica adicional. O projeto documenta isso em docs/SECURITY.md.
  • Servi-lo de uma subrota exige construir sua própria imagem. Atrás de um proxy (por exemplo, em /tools/libredb), BASE_PATH é definido na compilação, então a imagem publicada não pode ser realocada. Você precisa construir a sua com o argumento de build do Docker.

DBeaver ou LibreDB Studio?

A diferença é de arquitetura mais do que de funcionalidades.

  • Um cliente de desktop vive na máquina de cada desenvolvedor, e cada pessoa salva suas próprias credenciais de conexão.
  • LibreDB Studio é um único despliegue junto com seus bancos de dados. As pessoas fazem login com seu provedor de identidade, as credenciais ficam no servidor e cada consulta fica em um mesmo registro de auditoria.

Esse intercâmbio se encaixa com equipes que hoje compartilham senhas de banco de dados para que as pessoas possam consultar. Se você procura uma alternativa DBeaver para uma equipe, este é o argumento.

Se você trabalha sozinho, um cliente de desktop não precisa de servidor ou SSO. LibreDB agora também publica uma versão de desktop para Linux (AppImage, .deb e Flatpak) que executa o servidor como um processo local, sem tela de login. Seu roteiro público ainda lista como pendentes, na data de publicação desta nota, espaços de trabalho compartilhados, SAML 2.0 e mascaramento aplicado no servidor.

1 curtida