Files

T

Julius Joska 69687d0acf feat(relay): ephemeral delivery, call wake-ups and TURN credentials

Protocol and relay groundwork for typing indicators and 1:1 calls.

- ContentHint.EPHEMERAL: delivered only to an online recipient, never
  queued or pushed; the sender gets Receipt.STATUS_DROPPED otherwise.
- ContentHint.CALL: a call offer is queued like a normal message, but an
  offline recipient is woken immediately — a PushKit VoIP push on iOS
  (priority 10, 45 s expiry) or a short-lived FCM data message on
  Android. The relay learns that a device is being called, not by whom.
- RegisterPush.voip_token stores the iOS VoIP token next to the regular
  APNs token (migration 0004).
- TurnRequest/TurnCredentials: logged-in devices receive time-limited
  coturn credentials (use-auth-secret REST scheme, HMAC-SHA1), so the
  TURN server is never an open relay. Configured with SEPOT_TURN_URLS and
  SEPOT_TURN_SECRET or SEPOT_TURN_SECRET_FILE; without them calls fall
  back to direct connections and STUN.

2026-10-03 22:43:53 +02:00

2.9 KiB

Raw Blame History

sepot-relay — self-hosting

Relay je „hloupý" doručovací server: přijímá a doručuje opaque sealed-sender obálky, drží offline frontu (TTL) a šifrované bloby příloh. Nevidí obsah ani odesílatele, neváže identitu na telefon/e-mail a neloguje IP.

Stack: sepot-relay (Rust/axum) + PostgreSQL + volitelný Tor onion.

Rychlý start

cd deploy/relay
cp .env.example .env
# vyplň POSTGRES_PASSWORD, např.:  openssl rand -base64 24
docker compose build
docker compose up -d

TLS/WSS neterminuje relay sám — postav před něj reverzní proxy (Caddy, Traefik, nginx…) s platným certifikátem, která forwarduje na sepot-relay:8470. Uvnitř sítě jede plain WS (proxy dělá TLS termination). Klient se pak připojuje na wss://<tvoje-doména>.

Ověření

curl -s http://127.0.0.1:8470/v1/health        # {"status":"ok"}
curl -s http://127.0.0.1:8470/v1/server-info    # capabilities + trust_root

Tor onion (volitelné)

Compose obsahuje kontejner tor, který relay vystaví jako onion hidden service. Adresu zjistíš po startu:

docker exec sepot-relay-tor cat /var/lib/tor/sepot/hostname

Tuhle .onion adresu pak nastav v klientu (app/lib/core/constants/app_constants.dart, AppConstants.relayOnion) pro svůj vlastní build.

Konfigurace (`.env`)

Proměnná	Popis
`POSTGRES_PASSWORD`	heslo DB — povinné, nikdy necommituj
`SEPOT_APNS_*`	volitelné, jen pro iOS APNs push (Key ID, Team ID, cesta ke klíči)
FCM service account	volitelné, pro Android budíčky přes FCM (mimo repo)
`SEPOT_TURN_URLS`	volitelné, pro hovory: čárkou oddělené `turn:`/`turns:` adresy vašeho coturnu
`SEPOT_TURN_SECRET_FILE` / `SEPOT_TURN_SECRET`	sdílené tajemství coturnu (`use-auth-secret`, aspoň 32 znaků); bez něj relay TURN údaje nevydává a hovory jdou jen napřímo

Push je volitelný. Bez něj appka funguje přes UnifiedPush (degooglované) nebo si zprávy stáhne po otevření.

Persistentní data a zálohy

Zálohuj dvě volumes, obě obsahují kritické tajné klíče (chmod 600):

db-data — kromě dat drží relay_keys = trust root CA sealed senderu. Klienti si ho pinují. Jeho ztráta / regenerace = všichni klienti tvrdě odmítnou komunikovat („Trust root se změnil").
tor-keys — onion identita (hs_ed25519_secret_key). Ztráta = nová onion adresa pro všechny.

# DB dump:   docker exec sepot-relay-db pg_dump -U sepot sepot_relay | gzip > db.sql.gz
# Tor klíče: docker run --rm -v sepot-relay_tor-keys:/k -v "$PWD":/o alpine tar czf /o/tor-keys.tgz -C /k .

Privacy — Definition of Done

Relay neloguje obsah, odesílatele ani IP (vynuceno v kódu, ověřeno testem).
Access log reverzní proxy pro relay endpoint drž vypnutý.
Rate limity jsou in-memory token buckety — nikdy se nezapisují na disk.
DB nemá IP/PII sloupce; offline fronta má TTL, ACK = hard delete.

2.9 KiB Raw Blame History