Přejít na obsah

Nastavení Supabase ve Windows

Nastav Supabase na Windows serveru: nainstaluj WSL2 s Ubuntu, nastav v něm Docker, spusť Supabase a zpřístupni ho zvenčí → Zjisti víc

17. listopadu 20265 Min. doba čtení27 Zobrazení0 užitečné

Úvod

Supabase je open-source vývojová platforma pro Postgres, která nabízí kompletní databázi Postgres a také ověřování, okamžitá API, funkce v reálném čase a úložiště – open-source alternativu k Firebase.

Supabase se skládá z několika linuxových kontejnerů. Na Windows serveru tyto kontejnery neběží přímo, ale v linuxovém systému, který nastavíš pomocí Subsystému Windows pro Linux (WSL2). V tomto návodu ti ukážeme, jak nainstalovat WSL2 s Ubuntu, nastavit v něm Docker a spustit Supabase.

Tip

Jednodušší je to s Linuxovým VPS Na Linuxovém VPS (Debian nebo Ubuntu) nainstaluješ Supabase několika kliknutími přes One-Click Apps ve webovém rozhraní VPS serveru nebo ručně podle našeho návodu Jak nastavit Supabase na Linux serveru. Tuto možnost doporučujeme: Ve Windows běží pro WSL2 ve tvém VPS navíc vlastní virtuální stroj, který využívá paměť RAM a CPU a vyžaduje více péče. One-Click Apps nejsou na Windows VPS serverech dostupné.

Požadavky

Než Supabase nainstaluješ, ujisti se, že tvoje hostingové prostředí splňuje následující požadavky. Windows a prostředí WSL2 potřebují kromě Supabase i vlastní prostředky.

HardwareMinimumDoporučení ZAP-Hosting
CPU2 jádra vCPU4 jádra vCPU
RAM8 GB16 GB
Místo na disku60 GB80 GB

Operační systém: Windows Server 2022 nebo Windows Server 2025

Závislosti: WSL2 s Ubuntu 24.04, v něm Git a Docker (Engine und Compose)

Pozor

Žádný Docker Desktop ani kontejnery Windows Docker Desktop není podle Dockeru ve Windows Serveru podporován. Docker Engine z našeho návodu Jak nastavit Docker na Windows serveru spouští pouze kontejnery Windows, a proto se pro Supabase nehodí. Nainstaluj Docker podle následujících pokynů přímo v Ubuntu ve WSL2.

Příprava

Instalace WSL2 a Ubuntu

Připoj se k serveru přes Vzdálenou plochu (RDP) jako správce. Otevři PowerShell jako správce a nainstaluj WSL2 společně s Ubuntu 24.04:

Code
wsl --install -d Ubuntu-24.04

Potom server restartuj. Po restartu znovu otevři PowerShell a jednou spusť Ubuntu pomocí wsl -d Ubuntu-24.04. Při prvním spuštění vytvoř uživatelské jméno a heslo pro Linux.

Informace

Při spuštění se může zobrazit zpráva Nested virtualization is not supported on this machine. Týká se pouze virtuálních strojů uvnitř WSL a Supabase nijak neovlivňuje.

Pomocí wsl -l -v zkontroluješ, jestli Ubuntu běží a používá verzi 2.

Aktualizace systému

Všechny následující příkazy spusť v konzoli Ubuntu (wsl -d Ubuntu-24.04). Nejdřív aktualizuj balíčky a nainstaluj Git:

Code
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl

Instalace Dockeru

Nainstaluj Docker Engine včetně Docker Compose pomocí oficiálního instalačního skriptu Dockeru:

Code
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

Ukonči konzoli Ubuntu příkazem exit, v PowerShellu spusť wsl --shutdown a potom znovu otevři Ubuntu, aby se změna členství ve skupině projevila. Instalaci ověříš pomocí docker version a docker compose version.

Podrobný návod k používání Dockeru v Linuxu najdeš v našem návodu Docker.

Instalace

Jakmile splníš všechny požadavky, můžeš nainstalovat Supabase. V konzoli Ubuntu stáhni repozitář Supabase, vytvoř vlastní projektovou složku a zkopíruj do ní soubory Dockeru a ukázkový soubor prostředí:

Code
cd ~
git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env

Přejdi do projektové složky, stáhni aktuální obrazy kontejnerů a spusť celý stack na pozadí:

Code
cd supabase-project
docker compose pull
docker compose up -d

Přímo na serveru teď otevřeš Supabase Studio v prohlížeči na adrese http://localhost:8000. Zobrazí se výzva k zadání uživatelského jména a hesla. Výchozí přihlašovací údaje jsou:

  • Uživatelské jméno: supabase
  • Heslo: this_password_is_insecure_and_should_be_updated
Pozor

Výchozí přihlašovací údaje Aplikace teď běží s výchozími přihlašovacími údaji. Než Supabase zpřístupníš zvenčí, změň je podle pokynů v části Konfigurace.

Zpřístupnění Supabase zvenčí

WSL2 má vlastní interní síť. Aby bylo možné Supabase Studio a API používat přes IP adresu serveru, přesměruj port z Windows do WSL. Nejdřív v PowerShellu zjisti interní IP adresu Ubuntu:

Code
wsl -d Ubuntu-24.04 hostname -I

Potom nastav přesměrování a pravidlo firewallu. Nahraď [WSL-IP] první zobrazenou adresou:

Code
netsh interface portproxy add v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP]
New-NetFirewallRule -DisplayName "Supabase" -Direction Inbound -Protocol TCP -LocalPort 8000 -Action Allow

Supabase Studio teď otevřeš na adrese http://[deine-ip]:8000.

Informace

Interní IP adresa WSL se může po restartu změnit. Znovu ji zkontroluj a uprav přesměrování pomocí netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP].

Jak nechat Supabase běžet nepřetržitě

WSL ukončí Ubuntu, jakmile k němu nemá přístup žádné okno ani příkaz. Aby Supabase běželo dál, vytvoř ve Windows soubor C:\Users\<Benutzername>\.wslconfig s následujícím obsahem:

Code
[general]
instanceIdleTimeout=-1

[wsl2]
vmIdleTimeout=-1

Potom v PowerShellu spusť wsl --shutdown a znovu spusť Ubuntu. Kontejnery Supabase se spustí automaticky, jakmile v Ubuntu poběží Docker.

Aby se Supabase spustilo i po restartu serveru, vytvoř v Plánovači úloh úlohu, která se spustí při spuštění systému pod tvým účtem správce (možnost Spustit bez ohledu na přihlášení uživatele). Jako akci zadej wsl.exe a jako argumenty -d Ubuntu-24.04 -u root -- systemctl start docker.

Konfigurace

Nikdy nespouštěj produkční provoz s výchozími nebo ukázkovými hodnotami. Nahraď všechny zástupné hodnoty silnými a jedinečnými tajnými údaji, zkontroluj, jestli konfigurace splňuje tvoje bezpečnostní požadavky, a restartuj všechny služby, aby se změny projevily.

Než službu zpřístupníš veřejnosti, vygeneruj bezpečné klíče API. Začni 40znakovým tajným klíčem JWT. Můžeš použít přednastavenou hodnotu nebo si vytvořit vlastní. Ulož tajný klíč lokálně na bezpečné místo. Nesdílej ho ani ho necommituj do systému správy verzí. Pomocí tohoto tajného klíče vygeneruj JWT a z něj odvoď klíče API anon a service pomocí formuláře v dokumentaci Supabase: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys

Formulář spusť dvakrát, aby se vygenerovaly oba klíče. Aktualizuj soubor .env v projektové složce ~/supabase-project a nastav:

  • ANON_KEY: klíč anon
  • SERVICE_ROLE_KEY: klíč service

Ve stejném souboru .env nastav požadované tajné údaje. Tyto hodnoty jsou pro funkční instalaci povinné:

  • POSTGRES_PASSWORD: heslo pro roli postgres
  • JWT_SECRET: používají ho PostgREST a GoTrue
  • SITE_URL: základní URL tvého webu
  • SMTP_*: přihlašovací údaje k tvému poštovnímu serveru
  • POOLER_TENANT_ID: ID tenanta používané poolerem Supavisor

Před nasazením do produkčního prostředí zabezpeč dashboard novými přihlašovacími údaji. Uprav také soubor .env:

  • DASHBOARD_USERNAME: uživatelské jméno k dashboardu
  • DASHBOARD_PASSWORD: heslo k dashboardu

V projektové složce můžeš v souboru volumes/api/kong.yml definovat více uživatelů dashboardu:

Code
basicauth_credentials:
  - consumer: DASHBOARD
    username: user_one
    password: password_one
  - consumer: DASHBOARD
    username: user_two
    password: password_two

Pokud chceš používat všechny funkce dashboardu i mimo localhost, nastav v souboru .env hodnotu SUPABASE_PUBLIC_URL na URL nebo IP adresu, přes kterou chceš dashboard otevřít.

Změny konfigurace použiješ restartováním stacku v projektové složce:

Code
docker compose down
docker compose up -d

Závěr a další zdroje

Gratulujeme! Supabase jsi úspěšně nainstaloval a nakonfiguroval na svém Windows serveru s WSL2. Doporučujeme ti také podívat se na následující zdroje, které ti pomohou s konfigurací serveru:

Máš konkrétní otázky, na které jsi tady nenašel odpověď? Náš tým je ti každý den k dispozici s dalšími informacemi a podporou – stačí se nám ozvat! 🙂

FAQ

Často kladené dotazy

Supabase běží jako linuxový kontejner. Na Windows Serveru 2022 nebo 2025 nejdřív nainstaluj WSL2 s Ubuntu, nastav v něm Docker Engine a Docker Compose a potom spusť Supabase pomocí docker compose. One-Click Apps jsou dostupné pouze na Linuxových VPS serverech.
Supabase je open-source vývojová platforma pro Postgres, která nabízí kompletní databázi Postgres a také ověřování, okamžitá API, funkce v reálném čase a úložiště – open-source alternativu k Firebase.
Protože Windows a prostředí WSL2 potřebují další prostředky, počítej alespoň se 2 jádry vCPU, 8 GB RAM a 60 GB místa na disku. ZAP-Hosting doporučuje 4 jádra vCPU, 16 GB RAM a 80 GB místa na disku.

Zpětná vazba

Pomohl ti tento článek?

Tvoje zpětná vazba nám pomáhá lépe určovat priority a upravovat obsah.

0 od 0 Uživatelé označili tento článek za užitečný.

Osobní pomoc

Návod nestačí?

Naše podpora ZAP zná tvůj produkt — stručně popiš, co potřebuješ, a osobně ti pomůžeme.

Zappy zná tento návod a odpoví ti přímo v chatu.