Você decide que serviços podemos ativar para análise, personalização e conteúdos externos.
Utilizamos cookies e tecnologias semelhantes no nosso site para personalizar conteúdos, integrar conteúdos externos e compreender melhor a uso de cada área.
Cookies necessários
Estas entradas asseguram funções essenciais, como segurança, estabilidade e processamento de formulários.
Seções opcionais
AnálisesMarketingPersonalizaçãoMídia externa
O tratamento de dados pode basear-se no seu consentimento ou em interesses legítimos. Nas configurações de cookies, pode rejeitar ou permitir cada categoria opcional.
Alguns serviços processam dados pessoais em outros países. Ao dar seu consentimento, você também aceita essa transferência. Encontre mais informações em nossa Política de Privacidade.
Pode voltar a abrir e ajustar sua seleção a qualquer momento. · 1.0.2
Configure o Supabase em um Windows Server: instale o WSL2 com Ubuntu, configure o Docker, inicie o Supabase e deixe-o acessível externamente → Saiba mais
10 de novembro de 20266 min de leitura4 visualizações0 útil
Introdução
O Supabase é uma plataforma de desenvolvimento de código aberto para Postgres que oferece um banco de dados Postgres completo, além de autenticação, APIs instantâneas, recursos em tempo real e armazenamento — uma alternativa de código aberto ao Firebase.
O Supabase é composto por vários contêineres Linux. Em um Windows Server, esses contêineres não são executados diretamente, mas em um sistema Linux que você configura com o Subsistema do Windows para Linux (WSL2). Neste guia, mostramos como instalar o WSL2 com Ubuntu, configurar o Docker nele e iniciar o Supabase.
Dica
É mais fácil com um VPS Linux
Em um VPS Linux (Debian ou Ubuntu), você instala o Supabase com apenas alguns cliques usando os Aplicativos com um clique na interface web do VPS ou manualmente, seguindo nosso guia Configurar o Supabase em um servidor Linux. Esse é o método que recomendamos: no Windows, o WSL2 também executa uma máquina virtual própria dentro do seu VPS, que consome memória e CPU e exige mais manutenção. Os Aplicativos com um clique não estão disponíveis em VPS Windows.
Requisitos
Antes de instalar o Supabase, verifique se o seu ambiente de hospedagem atende aos requisitos a seguir. O Windows e o ambiente WSL2 também precisam de recursos próprios, além dos usados pelo Supabase.
Hardware
Mínimo
Recomendação da ZAP-Hosting
CPU
2 núcleos vCPU
4 núcleos vCPU
RAM
8 GB
16 GB
Espaço em disco
60 GB
80 GB
Sistema operacional: Windows Server 2022 ou Windows Server 2025
Dependências:WSL2 com Ubuntu 24.04 e, dentro dele, Git e Docker (Engine and Compose)
Atenção
Não use Docker Desktop nem contêineres do Windows
O Docker Desktop não é compatível com o Windows Server. O Docker Engine do nosso guia Configurar o Docker em um Windows Server executa apenas contêineres do Windows e, por isso, não é adequado para o Supabase. Instale o Docker dentro do Ubuntu no WSL2, conforme descrito abaixo.
FAQ
Perguntas frequentes
O Supabase é executado como um conjunto de contêineres Linux. Em um Windows Server 2022 ou 2025, instale primeiro o WSL2 com Ubuntu, configure o Docker Engine e o Docker Compose e, em seguida, inicie o Supabase com docker compose. Os Aplicativos com um clique estão disponíveis apenas em VPS Linux.
O Supabase é uma plataforma de desenvolvimento de código aberto para Postgres que oferece um banco de dados Postgres completo, além de autenticação, APIs instantâneas, recursos em tempo real e armazenamento — uma alternativa de código aberto ao Firebase.
Como o Windows e o ambiente WSL2 também precisam de recursos, reserve pelo menos 2 núcleos vCPU, 8 GB de RAM e 60 GB de espaço em disco. A ZAP-Hosting recomenda 4 núcleos vCPU, 16 GB de RAM e 80 GB de espaço em disco.
Não. O Docker Desktop não é compatível com o Windows Server, e o Docker Engine para Windows executa apenas contêineres do Windows. Em vez disso, instale o Docker dentro do Ubuntu no WSL2.
Sim. Em um VPS Linux com Debian ou Ubuntu, você instala o Supabase com poucos cliques usando os Aplicativos com um clique na interface web do VPS. Esse é o método que recomendamos.
Feedback
Este artigo foi útil?
Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.
0 de 0 As avaliações consideraram este artigo útil.
Ajuda personalizada
As instruções não são suficientes?
A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.
Navegação
Software
Preparação
Instalar o WSL2 e o Ubuntu
Conecte-se ao seu servidor como administrador usando a Área de Trabalho Remota (RDP). Abra o PowerShell como administrador e instale o WSL2 junto com o Ubuntu 24.04:
Code
wsl --install -d Ubuntu-24.04
Em seguida, reinicie o servidor. Depois que ele reiniciar, abra o PowerShell novamente e inicie o Ubuntu uma vez com wsl -d Ubuntu-24.04. Na primeira inicialização, defina um nome de usuário e uma senha para o Linux.
Informações
A mensagem Nested virtualization is not supported on this machine pode aparecer durante a inicialização. Ela se aplica apenas a máquinas virtuais dentro do WSL e não afeta o Supabase.
Use wsl -l -v para verificar se o Ubuntu está em execução e usando a versão 2.
Atualizar o sistema
Execute todos os comandos a seguir no terminal do Ubuntu (wsl -d Ubuntu-24.04). Primeiro, atualize os pacotes e instale o Git:
Feche o terminal do Ubuntu com exit, execute wsl --shutdown no PowerShell e abra o Ubuntu novamente para que a associação ao grupo entre em vigor. Verifique a instalação com docker version e docker compose version.
Você encontra instruções detalhadas sobre como usar o Docker no Linux no nosso guia de Docker.
Instalação
Quando todos os requisitos forem atendidos, você poderá instalar o Supabase. No terminal do Ubuntu, baixe o repositório do Supabase, crie um diretório próprio para o projeto e copie para ele os arquivos do Docker e o arquivo de ambiente de exemplo:
Acesse o diretório do projeto, baixe as imagens atuais dos contêineres e inicie a stack em segundo plano:
Code
cd supabase-project
docker compose pull
docker compose up -d
Agora você pode acessar o Supabase Studio no próprio servidor, pelo navegador, em http://localhost:8000. Será solicitado um nome de usuário e uma senha. Por padrão, as credenciais são:
Credenciais padrão
Seu app está sendo executado com as credenciais padrão. Altere-as conforme descrito na seção Configuração antes de deixar o Supabase acessível externamente.
Deixar o Supabase acessível externamente
O WSL2 tem uma rede interna própria. Para acessar o Supabase Studio e a API pelo endereço IP do seu servidor, encaminhe a porta do Windows para o WSL. Primeiro, descubra o endereço IP interno do Ubuntu no PowerShell:
Code
wsl -d Ubuntu-24.04 hostname -I
Em seguida, configure o encaminhamento e uma regra de firewall. Substitua [WSL-IP] pelo primeiro endereço exibido:
Agora você pode acessar o Supabase Studio em http://[deine-ip]:8000.
Informações
O endereço IP interno do WSL pode mudar depois de uma reinicialização. Nesse caso, verifique-o novamente e ajuste o encaminhamento com netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP].
Manter o Supabase em execução
O WSL encerra o Ubuntu quando nenhuma janela ou comando está acessando-o. Para manter o Supabase em execução, crie no Windows o arquivo C:\Users\<Benutzername>\.wslconfig com o seguinte conteúdo:
Em seguida, execute wsl --shutdown no PowerShell e reinicie o Ubuntu. Os contêineres do Supabase serão iniciados automaticamente assim que o Docker estiver em execução no Ubuntu.
Para que o Supabase também inicie após a reinicialização do servidor, crie uma tarefa no Agendador de Tarefas para ser executada na inicialização do sistema com sua conta de administrador (opção Executar independentemente de o usuário estar conectado). Na ação, informe wsl.exe com os argumentos -d Ubuntu-24.04 -u root -- systemctl start docker.
Configuração
Nunca use valores padrão ou de exemplo em produção. Substitua todos os espaços reservados por secrets fortes e exclusivos, verifique se a configuração atende aos seus requisitos de segurança e reinicie todos os serviços para que as alterações entrem em vigor.
Gere chaves de API seguras antes de disponibilizar um serviço publicamente. Comece com um JWT Secret de 40 caracteres. Você pode usar o valor fornecido ou criar o seu próprio. Salve o secret localmente em um local seguro. Não compartilhe nem o envie para sistemas de controle de versão. Use o secret para gerar um JWT e, a partir dele, derive as chaves de API anon e service usando o formulário da documentação do Supabase: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys
Use o formulário duas vezes para gerar as duas chaves. Atualize o arquivo .env no diretório do projeto ~/supabase-project com:
ANON_KEY: chave anon
SERVICE_ROLE_KEY: chave service
Defina os secrets necessários no mesmo arquivo .env. Esses valores precisam ser configurados para que a instalação funcione:
POSTGRES_PASSWORD: senha da role postgres
JWT_SECRET: usado pelo PostgREST e pelo GoTrue
SITE_URL: URL base do seu site
SMTP_*: credenciais do seu servidor de e-mail
POOLER_TENANT_ID: ID do tenant usado pelo pooler Supavisor
Proteja o dashboard com novas credenciais antes de usar o sistema em produção. Para isso, edite também o arquivo .env:
DASHBOARD_USERNAME: nome de usuário do dashboard
DASHBOARD_PASSWORD: senha do dashboard
Você pode definir vários usuários do dashboard em volumes/api/kong.yml, no diretório do projeto:
Para usar todos os recursos do dashboard também fora de localhost, defina SUPABASE_PUBLIC_URL no arquivo .env com a URL ou o endereço IP pelo qual você quer acessar o dashboard.
Aplique as alterações de configuração reiniciando a stack no diretório do projeto:
Code
docker compose down
docker compose up -d
Conclusão e outros recursos
Parabéns! Você instalou e configurou o Supabase com sucesso no seu Windows Server usando o WSL2. Também recomendamos que você consulte estes recursos, que podem ajudar na configuração do servidor:
Fonte preferida no Google
