Skip to content

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í:

yaml
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) ​

nginx
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 s KB_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í jako http:// a klienti typu Claude Code OAuth odmítnou (resource … does not match). Náhradní řešení: nastavit KB_PUBLIC_URL=https://killbottleneck.vase-domena.cz v .env.
  • X-Forwarded-Host — totéž pro doménu, když proxy běží na jiném hostiteli.
  • X-Forwarded-For + KB_TRUSTED_PROXY_HEADER=X-Forwarded-For v .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_for jako 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 zstd výš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řes http:// sáhne návod po API klíči (viz MCP)
Menu u jména → Připojit AI agenta. Jednořádková cesta přes OAuth funguje jen na HTTPS doméně — přesně proto stojí za to proxy dotáhnout.

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-redirect

Omezení

  • 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_TIMEOUT 45 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_PORT a KB_NAME a dejte jí vlastní blok v proxy.

Souvisí ​

Open source pod licencí MIT · © Tengo s.r.o.