Ir para o conteúdo
Promovaweb

O que é o Supabase e para que serve

O Supabase é uma plataforma de backend montada em volta de um banco Postgres completo, um por projeto. Em volta desse banco ficam serviços de código aberto que o frontend chama pela internet: uma API gerada a partir das tabelas, o login de usuários, o armazenamento de arquivos, as mensagens em tempo real e as funções em TypeScript.

Ficha e sumário da página

Referência técnica
Supabase CLI 3.1.0
Revisão
15 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Um banco Postgres no centro de tudo
  2. Os serviços em volta do banco
  3. O que chega com cada projeto
  4. Supabase Cloud ou self-hosted
  5. O ambiente local do CLI

Um banco Postgres no centro de tudo

A documentação do Supabase resume o produto numa frase: todo projeto recebe um banco Postgres completo, sem camada de abstração por cima. Isso significa tabelas, colunas tipadas, chaves estrangeiras, funções, triggers e extensões do próprio Postgres, como o pgvector para vetores e o pg_cron para tarefas agendadas. O SQL que você já escreve funciona igual no Supabase.

Os outros serviços do Supabase giram em volta desse banco. O login guarda os usuários num schema próprio do Postgres. O armazenamento de arquivos registra cada objeto numa tabela. A API lê as tabelas que você cria. Por isso, quase toda configuração de permissão acaba numa política escrita em SQL, assunto da página Segurança, RLS e chaves.

O painel do projeto, chamado Studio, oferece duas portas de entrada para o banco. O Table Editor mostra as tabelas como planilhas, com colunas e linhas editáveis. O SQL Editor recebe instruções SQL e executa cada uma com acesso administrativo, um detalhe que pesa quando você compara o que aparece no painel com o que a aplicação recebe.

Os serviços em volta do banco

A documentação de arquitetura lista as peças do Supabase e o projeto de código aberto por trás de cada uma. A maior parte foi escrita pela própria Supabase. Algumas vêm de comunidades independentes, como o PostgREST e o Deno.

  • projeto SupabaseUma URL própria, as chaves de API e o painel Studio.
  • Envoy (gateway)Recebe as chamadas da internet e encaminha cada uma ao serviço certo.
  • PostgRESTTransforma as tabelas do banco numa API REST, com o pg_graphql para GraphQL.
  • AuthCadastra usuários e emite os tokens de sessão.
  • StorageGuarda arquivos compatíveis com S3 e registra os metadados no banco.
  • RealtimeEnvia por WebSocket as mudanças nas tabelas, mensagens e presença.
  • Edge FunctionsExecuta funções em TypeScript no runtime do Deno.
  • SupavisorAgrupa as conexões diretas ao banco.
  • PostgresAs tabelas da aplicação e os schemas dos serviços.
As peças de um projeto Supabase, conforme a documentação oficial de arquitetura. Todos os serviços leem ou gravam no mesmo banco Postgres.

O frontend raramente conversa com o Postgres pela porta do banco. Ele chama a URL do projeto pelo HTTPS, com uma biblioteca cliente como a supabase-js. O gateway recebe a chamada e entrega ao serviço responsável: uma consulta vai para o PostgREST, um login vai para o Auth, um upload vai para o Storage. Conexões diretas, usadas por ferramentas de migração e por backends, passam pelo Supavisor.

A documentação registra os princípios por trás desse desenho. Cada peça precisa funcionar sozinha, apenas com um banco Postgres. As peças conversam por API e webhooks. O produto gerenciado precisa ser compatível com a versão self-hosted, para que um projeto entre e saia da plataforma com facilidade.

O que chega com cada projeto

Ao criar um projeto no painel, você escolhe a organização, o nome, a região e a senha do banco. A plataforma então provisiona o Postgres e os serviços. O projeto pronto expõe três itens que a aplicação usa: a URL da API, que aponta para aquele projeto, uma chave publishable, que pode ir para o navegador, além de uma chave secret, que fica só em servidores confiáveis.

As duas chaves têm papéis opostos. A publishable identifica a aplicação e respeita as políticas do banco. A secret entra com o papel service_role, que ignora essas políticas. Projetos antigos e tutoriais ainda mostram as chaves legadas anon e service_role, no formato de token. A documentação informa que elas seguem funcionando até você desativar cada uma no painel.

Um engano comum aparece aqui. Quando a aplicação aponta para a URL de um projeto e o painel mostra outro, a consulta chega a um banco válido sem as tabelas esperadas. O erro parece uma tabela ausente quando o problema está no endereço.

Supabase Cloud ou self-hosted

O Supabase existe em duas formas. No Supabase Cloud, a empresa opera a infraestrutura: servidores, sistema operacional, backups do Postgres e monitoramento. O modelo de responsabilidade compartilhada deixa com você o acesso à plataforma, o schema, as permissões das tabelas, os usuários e as chaves. O Cloud também traz recursos gerenciados, como backups diários e a recuperação até um ponto no tempo nos planos pagos. A documentação avisa que os backups cobrem o banco e deixam de fora os arquivos do Storage.

O self-hosted usa o mesmo código, com o Docker Compose como método recomendado pela documentação. A instalação própria roda um único projeto, configurado quase todo por variáveis de ambiente. Alguns recursos ficam de fora: branching, métricas avançadas, backups gerenciados com recuperação até um ponto no tempo, a Management API e os buckets de analytics e de vetores. Provisionar o servidor, atualizar os serviços, manter o Postgres, guardar backups e acompanhar a disponibilidade ficam com o administrador da instalação. O suporte vem da comunidade.

Para acompanhar as páginas deste portal, o Supabase Cloud concentra o trabalho nas tabelas, no login e nas permissões, sem um servidor para manter. O self-hosted faz sentido quando um requisito concreto de rede ou de infraestrutura exige essa liberdade e um profissional assume a administração contínua.

O ambiente local do CLI

O Supabase CLI sobe uma cópia da stack em containers no seu computador, com o mesmo Postgres e os mesmos serviços. Esse ambiente serve para desenvolver e testar migrations antes de aplicar as mudanças ao projeto no Cloud. A documentação é explícita: a stack local não recebeu o reforço de segurança de produção e não deve receber tráfego externo. As páginas deste portal usam como referência o Supabase CLI 3.1.0, publicado em 09/11/2026.

O banco é a primeira peça a conhecer, porque todas as outras dependem dele. A próxima página, Banco de dados e API, mostra como uma tabela criada em SQL vira uma rota da API.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.