Doména a HTTPS
V produkci musí být basedb obsluhován přes HTTPS: jeho cookies relace jsou Secure
a mají předponu __Host-, a prohlížeč je přes HTTP přijme jen na localhost.
Obraz už vše obsluhuje na jediné adrese – rozhraní, API pod /api, server MCP pod /mcp.
Zbývá ho jen umístit za proxy HTTPS: docker-compose.yml jednu dodává, Caddy, která si
sama získává a obnovuje certifikát Let’s Encrypt.
Nastavení
Sekce “Nastavení”-
Nasměrujte DNS své domény na server; otevřete porty 80 a 443.
-
V
.env:Terminál BASEDB_DOMAIN=basedb.example.comBASEDB_PUBLIC_URL=https://basedb.example.com -
Spusťte s profilem
https:Terminál docker compose --profile https up -d
Port 3000 zůstává publikován pouze na 127.0.0.1: veškerý vnější provoz prochází přes Caddy.
Proč tyto proměnné
Sekce “Proč tyto proměnné”BASEDB_DOMAIN: doména, pro kterou Caddy žádá certifikát.BASEDB_PUBLIC_URL: návratová adresa přihlášení OIDC, porovnávaná znak po znaku s adresou registrovanou u poskytovatele identity.- Caddy nastavuje
X-Forwarded-Forpodle skutečné adresy návštěvníka a basedb tuto hlavičku zachová, když přichází z privátní sítě: limity rychlosti API (přihlášení, sdílené formuláře) se pak počítají pro každého návštěvníka zvlášť.
Jiná proxy
Sekce “Jiná proxy”Vyhoví také Nginx, Traefik nebo nástroj pro vyrovnávání zátěže: posílejte veškerý provoz
domény na port 3000 kontejneru, bez ukládání odpovědí do vyrovnávací paměti (server MCP
a aktualizace v reálném čase streamují své odpovědi průběžně), a zajistěte, aby proxy
X-Forwarded-For nahrazovala, a ne doplňovala.
basedb je svobodný software od Eodia, softwarového studia stavějícího na AI.