HTTPS a reverzní proxy
killBottleneck sám mluví prostým HTTP. Abyste se k němu dostali zvenčí, dejte před něj VPN nebo reverzní proxy, která ukončí TLS. Na lokální síti to není nutné — ale i tam vám HTTPS odemkne mikrofon a připojení AI agentů (viz níž).
Caddy (certifikáty automaticky)
# Caddyfile
killbottleneck.vase-domena.cz {
encode gzip zstd
reverse_proxy 127.0.0.1:8090
}Caddy přidejte do sestavy přes docker-compose.override.yml — ten soubor aktualizace nepřepisují:
services:
caddy:
image: caddy:2
ports: ["80:80", "443:443"]
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile
- caddy_data:/data
volumes:
caddy_data:Caddy posílá hlavičky X-Forwarded-Proto a X-Forwarded-Host sám, takže instance ví, že běží na https://… — nic dalšího nastavovat nemusíte.
Jeden řádek do .env: KB_TRUSTED_PROXY_HEADER=X-Forwarded-For. Od v0.97 instance brzdí pokusy o přihlášení podle IP klienta (20 / 60 s). Za proxy by jinak viděla jen IP proxy a celá firma by sdílela jeden kbelík. Caddy do X-Forwarded-For zapisuje skutečnou adresu klienta sám a podvrženou nikdy nepropustí.
nginx (certifikát si obstaráte sami, třeba certbotem)
server {
listen 443 ssl http2;
server_name killbottleneck.vase-domena.cz;
ssl_certificate /etc/letsencrypt/live/killbottleneck.vase-domena.cz/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/killbottleneck.vase-domena.cz/privkey.pem;
gzip on;
gzip_types application/javascript text/css application/json;
client_max_body_size 50m; # hlasovky, fotky i import všech dat (50 MB)
location / {
proxy_pass http://127.0.0.1:8090;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
}
}Tři řádky, bez kterých to „skoro funguje“:
client_max_body_size— nginx má výchozí strop 1 MB a větší požadavek odmítne chybou 413. Hlasovky a fotky z telefonu v asistentovi mají až ~4,25 MB (strop roste sKB_CHAT_MAX_AUDIO_MB/KB_CHAT_MAX_IMG_MB), import JSON mapy 5 MB a import všech dat (Můj účet → Moje data) 50 MB. Caddy žádný takový strop nemá.X-Forwarded-Proto— od v0.79 si instance odvozuje svou veřejnou adresu z těchhle hlaviček pro OAuth AI agentů (/mcp) a pro návod/agent-setup.md. Bez ní se hlásí jakohttp://a klienti typu Claude Code OAuth odmítnou (resource … does not match). Náhradní řešení: nastavitKB_PUBLIC_URL=https://killbottleneck.vase-domena.czv.env.X-Forwarded-Host— totéž pro doménu, když proxy běží na jiném hostiteli.X-Forwarded-For+KB_TRUSTED_PROXY_HEADER=X-Forwarded-Forv.env— od v0.97 instance brzdí pokusy o přihlášení podle IP klienta; bez toho vidí jen IP proxy a celá firma sdílí jeden kbelík. Nechte$proxy_add_x_forwarded_forjako v ukázce — instance čte poslední adresu, tu, kterou připojil nginx.
Zapněte kompresi — je to úspora na třetinu
killBottleneck si odpovědi sám nekomprimuje. V PocketBase to nejde zapnout tak, aby se přitom nezměnilo chování API při odmítnutí příliš velkého těla, takže ta práce patří vaší proxy.
Hlavní soubor frontendu má (v0.87) zhruba 400 kB nekomprimovaně a 120 kB gzipem. Na mobilních datech je to ten rozdíl, kterého si při prvním otevření všimnete nejvíc.
- Caddy — řádek
encode gzip zstdvýše - nginx —
gzip on; gzip_types …výše - Cloudflare a spol. — děje se samo, není co nastavovat
Co HTTPS odemkne
Tyhle věci existují jen v zabezpečeném kontextu, protože je prohlížeče přes prosté HTTP odmítají (výjimka je localhost):
- Mikrofon — hlasovky a diktování v asistentovi
- Sdílet… u obrázku Můj den — nativní sdílecí dialog telefonu, bez cizí služby v cestě
- Přidání aplikace na plochu telefonu — service worker běží jen přes HTTPS (v prohlížeči telefonu: nabídka → Přidat na plochu)
- Připojit AI agenta přes OAuth — klienti posílají OAuth údaje jen na HTTPS nebo
localhost; na LAN přeshttp://sáhne návod po API klíči (viz MCP)
Ani jedno se nenastavuje. Na HTTPS doméně se prostě objeví.
Nezapomeňte na redirect URI
Pokud používáte přihlášení přes Google, musí autorizované redirect URI v Google Cloud Console odpovídat veřejné HTTPS adrese:
https://killbottleneck.vase-domena.cz/api/oauth2-redirectOmezení
- Administrace PocketBase (
/_/) jede po HTTP — za proxy ji buď nevystavujte (location /_/ { deny all; }), nebo ji otevírejte jen přes SSH tunel. - Časový limit proxy držte nad časovým limitem AI (přepis obrázku
KB_VISION_TIMEOUT45 s na pokus, Cloudflare utíná kolem 100 s). - Jedna doména = jedna instance. Druhou instanci na témže stroji pusťte na jiném
KB_PORTaKB_NAMEa dejte jí vlastní blok v proxy.
Souvisí
- Instalace —
docker-compose.override.yml, kam Caddy patří - MCP server — Připojit AI agenta, OAuth
- Proměnné prostředí → Automatizace —
KB_PUBLIC_URL - Telefon — aplikace na ploše

