README_DE.md

🌐 Andere Sprachen: 中文 · English · 日本語 · 한국어 · Français · Русский · Español

Eine WeChat-ähnliche Ende-zu-Ende-verschlüsselte Instant-Messaging-App mit zustandslosem ECDH + XSalsa20-Poly1305 Pro-Nachricht-Verschlüsselung, Echtzeit-Videoanrufen, Cloudflare R2 Dateispeicher, Mehrsprachigkeit und iOS PWA-Bereitstellung.

---

📸 Screenshots (zum Erweitern klicken)

Funktionen

Funktion	Beschreibung
🔐 Ende-zu-Ende-Verschlüsselung	Zustandsloses ECDH + XSalsa20-Poly1305 — Einmalschlüssel pro Nachricht, Forward Secrecy, Signal-ähnliche Sicherheitsnummernverifizierung
🗝️ Zero-Knowledge-Server	Server speichert nur Chiffretext; private Schlüssel verlassen niemals das Gerät
📹 Video- & Audioanrufe	LiveKit-SFU für 1:1-Anrufe und Konferenzen (bis zu 100 Teilnehmer), Alle stummschalten und Vortragsmodus
🎙️ Stimmverzerrer	Echtzeit-Stimmeffekte für Sprachnachrichten, 1:1-Anrufe und Gruppenanrufe — 3 Modi (0.8x tief / 1.0x normal / 1.2x hoch), basierend auf Web Audio API
📱 Sitzungspersistenz	30-minütige Access Tokens mit automatisch verlängerten 90-Tage-Geräte-Refresh-Sitzungen; Netzwerk-, IP-, VPN- und Proxywechsel werden ohne Passworteingabe wiederhergestellt
📨 Zuverlässige Nachrichtensynchronisierung	Bidirektionaler Heartbeat, Erkennung halboffener Verbindungen, persistenter Postausgang, idempotente Nachrichten-IDs und Cursor-Nachsynchronisierung über Serversequenzen
📴 Offline-Zugriff	Kontogetrennter Cache für Kontakte, Gruppen, bis zu 2.000 Nachrichten je Unterhaltung, Momente, Timeline und Medien; Offline-Sendungen werden automatisch wiederholt
🔎 Unicode-Freundessuche	IME-Kompositionsschutz, NFC-Normalisierung und UTF-8-Abfragekodierung ermöglichen die zuverlässige Suche chinesischer Benutzernamen und Spitznamen
👥 Gruppenchat	Bis zu 2000 Mitglieder, umschaltbare Modi „Verschlüsselt" / „Unverschlüsselt" (nur Besitzer, Umschalten löscht den Chatverlauf). Verschlüsselter Modus verwendet das Signal-Sender-Key-Protokoll (XSalsa20-Poly1305 symmetrische Verschlüsselung + ECDH-Schlüsselverteilung) — nur Gruppenmitglieder können Nachrichten entschlüsseln; Bots sind im verschlüsselten Modus deaktiviert. Nicht-stören-Modus, Mitgliederverwaltung
👫 Freundesystem	Freundschaftsanfragen erfordern Genehmigung mit bis zu 512 Zeichen Nachricht; Spitznamen; Multi-Tag-Gruppierung
⏱️ Automatisches Löschen	5 Stufen (nie / 1 Tag / 3 Tage / 1 Woche / 1 Monat), von beiden Seiten in DMs einstellbar, nur Besitzer in Gruppen
🔔 Push-Benachrichtigungen	Web Push (VAPID) + FCM + OneSignal + ntfy + APNS Fünf-Kanal — Benachrichtigungen auch offline (iOS nativ + chinesische Android-Geräte ohne Google-Dienste)
🌐 Mehrsprachig	Chinesisch, Englisch, Japanisch, Koreanisch, Französisch, Deutsch, Russisch, Spanisch — Autoerkennung + manueller Wechsel
📱 iOS — Ohne Unternehmenszertifikat	PWA über Safari „Zum Home-Bildschirm hinzufügen", funktioniert dauerhaft ohne Apple-Signierung
📱 Android Native App	Verfügbar bei Google Play, mit FCM-Push-Unterstützung
📱 iOS Native App	Verfügbar im App Store, mit APNS-Push-Unterstützung
🖥️ Windows Desktop-Client	Native Windows-Desktopanwendung, hier herunterladen
🍎 Mac Desktop-Client	Native Mac-Desktopanwendung, hier herunterladen
💬 Rich-Messaging	Text, Bilder, Video, Dokumentdateien, Sprachnachrichten, 200+ Emojis, Telegram-Stickerpakete, Lesebestätigungen, Tippanzeigen
📤 Datei-Upload	Bis zu 500 MB pro Datei, Cloudflare R2 oder lokaler Speicher, mit Fortschrittsanimation
🌐 Momente	WeChat-ähnlicher sozialer Feed: Text + bis zu 9 Fotos oder 1 Video (≤ 10 Min.), Likes, Kommentare, Tag-basierte Sichtbarkeit
👤 Benutzerprofil	Kontaktprofilseite mit bidirektionalen Momente-Datenschutzkontrollen
📰 Timeline	Xiaohongshu-ähnlicher öffentlicher Feed — zweispaltiges Masonry-Layout, anonyme Beiträge, Likes & Kommentare
🏷️ Freund-Tags	Mehrere Tags pro Freund vergeben (12-Farben-Palette), Kontakte nach Tag filtern
🗂️ R2 Objektspeicher	Cloudflare R2 für Bild-/Sprachdateien — optionale öffentliche CDN-URL
🔑 Zwei-Faktor-Authentifizierung (2FA)	Google Authenticator–kompatibles TOTP, 8 Wiederherstellungscodes, erzwungen bei Anmeldung
📷 QR-Code scannen & teilen	QR-Codes scannen zum Hinzufügen von Freunden oder Beitreten von Gruppen mit konfigurierbarem Ablaufdatum
🏗️ Selbst-Hosting	Docker Compose, Zeabur One-Click oder Frontend auf Vercel
🌐 Proxy-Einstellungen	SOCKS5 / HTTP / HTTPS Proxy-Unterstützung — konfigurierbar auf Login- und Einstellungsseiten mit Serveradresse, Port, Benutzername und Passwort für eingeschränkte Netzwerkumgebungen
🛡️ Inhaltsmoderation	Benutzermeldungen (6 Kategorien) + Benutzer blockieren (sofortige Ausblendung von Beiträgen/Nachrichten) + Nutzungsbedingungen (EULA)
🔧 Admin-Panel	Eingebettetes Web-Admin-Dashboard (/admin, Pfad konfigurierbar), passwortgeschützt, Meldungen prüfen, Inhalte löschen, Benutzer sperren — 8 Sprachen

---

Neu in v2.3.9

• Alte einseitige Freundschaftseinträge führten zur Meldung „Bereits befreundet“, obwohl der Kontakt unsichtbar blieb und kein Chat möglich war. Beim erneuten Hinzufügen werden nun beide Richtungen automatisch repariert und die Kontaktliste sofort aktualisiert.

---

Neu in v2.3.8

• Die nicht reagierende Zurück-Schaltfläche nach dem Start der QR-Kamera wurde behoben; beim Schließen wird die Kamera nun sofort gestoppt und freigegeben.
• Doppelte Freundschaftsanfragen an bestehende Freunde beschädigen die Freundschaft nicht mehr; Suchergebnisse zeigen jetzt „Bereits befreundet“ an.
• Ausgehende Privatnachrichten werden direkt nach der Ende-zu-Ende-Verschlüsselung als Chiffretext im optimistischen Nachrichtenobjekt gespeichert; beim Warten auf die Serverbestätigung landet kein Klartext im Offline-Cache.
• Sprachnachrichten stoppen automatisch nach 120 Sekunden; die Ausgabe mit Stimmeffekt hat dasselbe Limit.
• Bei Aufnahmen und Anrufen bleibt der Bildschirm wach; beim Verlassen werden Aufnahmegeräte und Timer zuverlässig freigegeben.
• Android schützt Schlüssel und Chat-Caches zusätzlich mit Android Keystore und AES-256-GCM; der Web-Client verwendet weiterhin Browser-Speicher.

---

Sitzungswiederherstellung und Nachrichtenzuverlässigkeit

PaperPhonePlus behandelt lokalen Kontostatus, Echtzeitverbindung und Nachrichtensynchronisierung getrennt. Ein offener WebSocket gilt erst nach auth_ok als einsatzbereit. Bidirektionale ping/pong-Heartbeats erkennen halboffene Verbindungen nach VPN-/IP-Wechseln, WLAN-/Mobilfunkübergängen oder App-Unterbrechungen.

• Access Tokens gelten 30 Minuten. Geräte-Refresh-Tokens gelten 90 Tage und werden bei aktiver Nutzung verlängert, sodass die Erneuerung ohne Passworteingabe erfolgt.
• Bereits mit einer älteren Version angemeldete Geräte werden automatisch aktualisiert, solange ihr vorhandenes Token gültig ist. Ist es bereits abgelaufen, ist eine einmalige erneute Anmeldung erforderlich.
• Jede ausgehende Nachricht besitzt eine stabile client_msg_id. Nachrichten ohne Server-ACK bleiben im persistenten lokalen Postausgang und werden mit derselben ID erneut gesendet; eine Eindeutigkeitsbedingung verhindert doppelte Einträge.
• Jede gespeicherte Nachricht besitzt eine monoton steigende server_seq. Nach Anmeldung, Wiederverbindung und Rückkehr in den Vordergrund synchronisiert der Client per Cursor fehlende Nachrichten nach.
• Explizite Abmeldung und Gerätewiderruf machen die dauerhafte Serversitzung ungültig. Gewöhnliche Transportfehler und IP-Wechsel erhalten sie.

---

Technologie-Stack

Backend (server/)
  Rust (Axum 0.8) — Hochleistungs-Async-Web-Framework
  sqlx + MySQL 8.0 — Benutzer-/Nachrichtenpersistenz
  deadpool-redis + Redis 7 — Online-Präsenz + knotenübergreifendes Routing
  aws-sdk-s3 — Cloudflare R2 Dateispeicher (S3-kompatible API)
  argon2 + jsonwebtoken Authentifizierung

Frontend (client/)
  React 19 + TypeScript + Vite 6
  Zustand Zustandsverwaltung
  libsodium-wrappers-sumo (WebAssembly — Curve25519 / XSalsa20-Poly1305)
  WebRTC API — Video-/Sprachanrufe
  Web Audio API — Echtzeit-Stimmverzerrer (ScriptProcessorNode Audio-Kette)
  PWA: manifest.json + Service Worker

Kryptographische Schicht
  Zustandsloses ECDH + XSalsa20-Poly1305 — Einmal-Schlüsselpaar pro Nachricht
  Vierstufige Schlüsselpersistenz: Speicher → localStorage → sessionStorage → IndexedDB
  Alle privaten Schlüssel nur auf dem Gerät gespeichert — niemals an den Server gesendet

---

📖 Detaillierte Bereitstellungsanleitung (中文) | Deployment Guide (English) — Vollständige Schritt-für-Schritt-Anleitung für Zeabur + Vercel Hybrid-Bereitstellung, Docker Compose + Nginx lokale Bereitstellung und Client-Server-Adresskonfiguration.

Option 0: Zeabur One-Click Cloud-Bereitstellung

Zeabur-Netzwerkeinschränkung: Die Vorlage stellt LiveKit über WebSocket/API 7880 und ICE/TCP 7881 bereit. Zeabur unterstützt derzeit keine öffentlichen UDP-Dienstports; 1:1-Anrufe und Konferenzen verwenden daher TCP-Fallback. Für produktive Anrufe empfiehlt sich LiveKit Cloud oder eine VM mit UDP-Unterstützung.

Serverseitige Nginx-Konfiguration

Verwenden Sie die Zwei-Domain-Produktionskonfiguration deploy/nginx/paperphone-plus.conf. Ersetzen Sie api.example.com und meeting.example.com, beziehen Sie TLS-Zertifikate, kopieren Sie die Datei nach /etc/nginx/sites-available/paperphone-plus, aktivieren Sie sie und führen Sie sudo nginx -t && sudo systemctl reload nginx aus. Setzen Sie im Backend LIVEKIT_URL=wss://meeting.example.com. Nginx proxyt nur API und WebSocket; TCP 7881 und UDP 7882 müssen direkt in Host- und Cloud-Firewall geöffnet werden.

Option 1: Docker Compose (Empfohlen)

git clone <repo-url> && cd paperphone-plus
cp server/.env.example server/.env
# Bearbeiten: DB_PASS / JWT_SECRET / LIVEKIT_URL usw.
docker compose up -d
open http://localhost

Option 2: Frontend auf Vercel

# 1. Dieses Repository forken
# 2. In Vercel importieren: Root Directory = client/, Build = npm run build, Output = dist/
#    Keine Umgebungsvariablen erforderlich
# 3. Backend über Docker oder Zeabur bereitstellen
# 4. Vercel-Frontend öffnen, Backend-Serveradresse auf der Anmeldeseite eingeben
#    z.B. https://your-server.zeabur.app

Option 3: Lokale Entwicklung

# Backend (Rust)
cd server && cp .env.example .env && cargo run --release

# Frontend (React)
cd client && npm install && npm run dev

---

Stimmverzerrer

Sprachnachrichten, 1:1-Anrufe und Gruppenanrufe unterstützen Echtzeit-Stimmverzerrung mit 3 wählbaren Modi:

Modus	Geschwindigkeit	Effekt
🐢 Langsam	0.8x	Tiefere, dunklere Stimme — ideal für Anonymität
🔊 Normal	1.0x	Originalstimme, keine Verarbeitung
🐇 Schnell	1.2x	Höhere Stimme — lustig und verspielt

Funktionsweise: Verwendet die Web Audio API zum Aufbau einer Audio-Verarbeitungskette (AudioContext → MediaStreamSource → ScriptProcessorNode → MediaStreamDestination), die Tonhöhe/Geschwindigkeit des Mikrofoneingangs in Echtzeit anpasst.

• Sprachnachrichten: Stimmmodus während der Aufnahme wählen. Die exportierte .webm-Datei enthält bereits den Stimmeffekt — Empfänger können die Originalstimme nicht wiederherstellen, was echtes anonymes Messaging ermöglicht
• 1:1 / Gruppenanrufe: Tippen Sie während eines Anrufs auf die Stimmverzerrer-Taste, um durch die Modi zu wechseln. Die verarbeitete Audiospur ersetzt das Original über LiveKit LocalAudioTrack.replaceTrack()

Keine serverseitige Konfiguration erforderlich. Der Stimmverzerrer läuft vollständig clientseitig.

---

Umgebungsvariablen

Variable	Beschreibung	Standard
PORT	Server-Port	3000
JWT_SECRET	JWT-Signierungsschlüssel (in Produktion ändern)	dev_secret
DB_HOST / DB_PASS / DB_NAME	MySQL-Verbindung	—
REDIS_HOST / REDIS_PASS	Redis-Verbindung	—
R2_ACCOUNT_ID	Cloudflare Account-ID	—
R2_ACCESS_KEY_ID	R2 API Token Access Key	—
R2_SECRET_ACCESS_KEY	R2 API Token Secret Key	—
R2_BUCKET	R2 Bucket-Name	—
R2_PUBLIC_URL	Öffentliche R2-Basis-URL (optional)	—
LIVEKIT_URL	Öffentliche LiveKit-WebSocket-Adresse für alle Anrufe	—
LIVEKIT_API_KEY	Gemeinsamer API-Schlüssel für Server und LiveKit	—
LIVEKIT_API_SECRET	Gemeinsames API-Secret für Server und LiveKit	—
VAPID_PUBLIC_KEY	Web Push VAPID Public Key (optional)	—
VAPID_PRIVATE_KEY	Web Push VAPID Private Key (optional)	—
VAPID_SUBJECT	VAPID Kontakt-E-Mail (optional)	mailto:admin@paperphoneplus.app
FCM_PROJECT_ID	Firebase Projekt-ID (optional, Capacitor Android)	—
FCM_CLIENT_EMAIL	Firebase-Dienstkonto-E-Mail (optional)	—
FCM_PRIVATE_KEY	Firebase-Dienstkonto Private Key (optional, unterstützt sowohl \n-Escape als auch echte Zeilenumbrüche; siehe unten)	—
FCM_RELAY_SECRET	FCM Push-Relay-Geheimnis (optional, auf Relay-Host setzen)	—
FCM_RELAY_URL	FCM Push-Relay-URL (optional, selbstgehostete Server zeigen auf Relay-Host)	—
FCM_RELAY_KEY	FCM Push-Relay-Auth-Schlüssel (optional, muss mit FCM_RELAY_SECRET des Relay-Hosts übereinstimmen)	—
ONESIGNAL_APP_ID	OneSignal App ID (optional)	—
ONESIGNAL_REST_KEY	OneSignal REST API Key (optional)	—
ONESIGNAL_RELAY_SECRET	OneSignal Push-Relay-Geheimnis (optional, auf Relay-Host setzen)	—
ONESIGNAL_RELAY_URL	OneSignal Push-Relay-URL (optional, selbstgehostete Server zeigen auf Relay-Host)	—
ONESIGNAL_RELAY_KEY	OneSignal Push-Relay-Auth-Schlüssel (optional, muss mit ONESIGNAL_RELAY_SECRET des Relay-Hosts übereinstimmen)	—
NTFY_BASE_URL	ntfy Server-URL (optional, nutzt standardmäßig öffentlichen ntfy.sh-Dienst)	https://ntfy.sh
NTFY_TOKEN	ntfy Auth-Token (optional, für selbstgehostete Server)	—
APNS_TEAM_ID	Apple Developer Team ID (optional, iOS native Push)	—
APNS_KEY_ID	APNS Auth Key ID (optional)	—
APNS_PRIVATE_KEY	APNS .p8 Private Key Inhalt (optional, unterstützt \n-Escape)	—
APNS_BUNDLE_ID	iOS App Bundle Identifier (optional)	—
APNS_SANDBOX	APNS Sandbox-Modus (optional, true für Entwicklung/TestFlight)	false
APNS_RELAY_SECRET	Push-Relay-Geheimnis (optional, auf Relay-Host setzen)	—
APNS_RELAY_URL	Push-Relay-URL (optional, selbstgehostete Server zeigen auf Relay-Host)	—
APNS_RELAY_KEY	Push-Relay-Auth-Schlüssel (optional, muss mit APNS_RELAY_SECRET des Relay-Hosts übereinstimmen)	—
TELEGRAM_BOT_TOKEN	Telegram Bot Token (optional)	—
STICKER_PACKS	Benutzerdefinierte Stickerpakete (optional, Name:Label)	12 integrierte Standards
ADMIN_PATH	Admin-Panel URL-Pfad	/admin
ADMIN_PASSWORD	Admin-Panel Passwort (in Produktion ändern)	admin123

FCM Private Key Zeilenumbruch-Behandlung

Das private_key-Feld in der Firebase-Dienstkonto-JSON-Datei enthält einen RSA-Privatschlüssel im PEM-Format, der echte Zeilenumbrüche (\n, ASCII 0x0A) zwischen jeder 64-Zeichen-Zeile erfordert. Viele Bereitstellungsplattformen (Zeabur, Vercel, Railway, Docker) speichern Umgebungsvariablen jedoch als einzeilige Strings und konvertieren \n in die wörtliche Zwei-Zeichen-Sequenz \ + n.

Dies ist die häufigste Ursache für FCM-Push-Benachrichtigungsfehler — der PEM-Parser schlägt stillschweigend fehl und es werden keine Push-Benachrichtigungen gesendet, ohne Fehlerprotokolle.

Der Server behandelt dies automatisch: fcm.rs normalisiert wörtliche \n-Sequenzen zurück zu echten Zeilenumbrüchen vor dem Parsing. Beide Formate funktionieren:

• Einzeilig (empfohlen für Cloud-Plattformen): Den rohen private_key-Wert aus der JSON-Datei mit \n-Escapes einfügen:

  FCM_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nMIIEvQ...\n-----END PRIVATE KEY-----\n
  

• Mehrzeilig (für .env-Dateien): Den vollständigen PEM-Inhalt in Anführungszeichen mit echten Zeilenumbrüchen einschließen:

  FCM_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----
  MIIEvQ...
  -----END PRIVATE KEY-----"
  

Plattform	Empfohlenes Format	Hinweise
Zeabur	Einzeilig (\n escaped)	JSON-Wert direkt im Variables-Panel einfügen
Docker / docker-compose	Beides	YAML | für mehrzeilig; einzeilig in .env
Vercel / Railway	Einzeilig (\n escaped)	Eingabefelder unterstützen typischerweise keine echten Zeilenumbrüche
Linux .env-Datei	Mehrzeilig (in Anführungszeichen)	Sicherstellen, dass Anführungszeichen korrekt geschlossen sind

Fehlerbehebung: Wenn FCM-Variablen gesetzt sind, aber Android-Push nicht funktioniert, Serverprotokolle prüfen:

• [FCM] No access token available → Private Key Format-Fehler (Zeilenumbruch-Problem)
• [FCM] ✅ Push sent to user xxx → FCM-Versand funktioniert, Problem ist clientseitig
• Keine FCM-Protokolle → FCM_PROJECT_ID nicht gesetzt oder kein Token in der fcm_tokens-Tabelle

ntfy Push (Chinesische Android-Geräte ohne Google-Dienste)

Für Android-Geräte ohne Google Mobile Services (Huawei, Xiaomi, OPPO, vivo usw.) unterstützt PaperPhonePlus Push-Benachrichtigungen über ntfy.

Standard-Setup (Null-Konfiguration): Nutzt den öffentlichen ntfy.sh-Dienst. Keine zusätzliche Konfiguration erforderlich.

Optionale Konfiguration (für selbstgehostete ntfy-Server):

NTFY_BASE_URL=https://your-ntfy-server.com
NTFY_TOKEN=your_optional_auth_token

Benutzer-Setup:

1. ntfy App installieren (Google Play / F-Droid / Direktdownload)
2. PaperPhonePlus-Einstellungen öffnen und die „ntfy Push"-Karte finden
3. Den angezeigten Topic-Namen kopieren und in der ntfy App abonnieren
4. Auf „Push registrieren" tippen, um die Registrierung abzuschließen

Sicherheitshinweis: ntfy-Benachrichtigungen enthalten Benachrichtigungstitel und Zusammenfassungen im Klartext (nicht den eigentlichen Nachrichteninhalt). Für höhere Sicherheit einen selbstgehosteten ntfy-Server verwenden.

APNS Push (Native iOS App)

APNS (Apple Push Notification Service) sendet Push-Benachrichtigungen an native iOS-Apps, die mit Capacitor erstellt wurden. Es gibt zwei Konfigurationsmöglichkeiten:

Option A: Direkte Konfiguration (Server des App-Entwicklers)

1. Bei Apple Developer anmelden → Certificates, Identifiers & Profiles → Keys
2. + klicken, um einen neuen Key zu erstellen → Apple Push Notifications service (APNs) aktivieren → Register
3. .p8-Datei herunterladen (⚠️ kann nur einmal heruntergeladen werden!) und die Key ID notieren
4. Team ID von der Apple Developer Mitgliedschaftsseite notieren (10-stellig alphanumerisch)
5. In server/.env einfügen:

APNS_TEAM_ID=AB12CD34EF
APNS_KEY_ID=LH4Z9YN3P7
APNS_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIGTAgEA...(.p8-Dateiinhalt)...\n-----END PRIVATE KEY-----"
APNS_BUNDLE_ID=com.yourcompany.paperphoneplus
APNS_SANDBOX=false

APNS_SANDBOX: Auf true für Entwicklung/TestFlight-Builds, false für App Store-Produktion setzen.

Option B: Über Push Relay (Selbstgehostete Server)

Wenn Sie die iOS-App eines anderen verwenden (z.B. aus dem App Store heruntergeladen), haben Sie keine Apple-Zugangsdaten des Entwicklers und können keine APNS-Pushes direkt senden. Verwenden Sie stattdessen den Push Relay.

Funktionsweise:

┌──────────────────────┐       ┌─────────────────────────┐       ┌─────────┐
│  Selbstgehosteter     │  HTTP  │  Server des Entwicklers  │  APNS  │  Apple  │
│  Server               │──────→│  (hat .p8 Key + Relay)   │──────→│  ──→ 📱 │
│  (keine Apple-Creds)  │       │                          │       └─────────┘
│  APNS_RELAY_URL=...   │       │  APNS_TEAM_ID=...        │
│  APNS_RELAY_KEY=...   │       │  APNS_RELAY_SECRET=...   │
└──────────────────────┘       └─────────────────────────┘

Schritt 1: App-Entwickler aktiviert den Relay-Endpunkt

Auf dem Server des App-Entwicklers (der bereits APNS-Zugangsdaten hat) ein Relay-Geheimnis setzen:

# Server des App-Entwicklers .env (hat bereits APNS_TEAM_ID usw.)
APNS_RELAY_SECRET=ein_langer_zufälliger_gemeinsamer_Schlüssel

Dies aktiviert automatisch den Push-Relay-Endpunkt unter POST /api/push-relay/apns.

Schritt 2: Selbstgehosteter Benutzer konfiguriert den Relay

Selbstgehostete Server benötigen nur zwei Variablen — keine Apple-Zugangsdaten erforderlich:

# Selbstgehosteter Server .env
APNS_RELAY_URL=https://app-developer-server.com
APNS_RELAY_KEY=gemeinsamer_Schlüssel_aus_Schritt_1

Ablauf:

1. Selbstgehosteter Server empfängt eine Offline-Nachricht → fragt lokale apns_tokens-Tabelle nach iOS-Geräte-Tokens des Benutzers ab
2. Sendet Geräte-Tokens + Push-Titel/Inhalt per HTTP POST an den Relay
3. Relay validiert den Schlüssel und sendet dann mit eigenen APNS-Zugangsdaten an Apple
4. Relay gibt eine Liste abgelaufener Tokens zurück; der selbstgehostete Server bereinigt automatisch seine lokale Datenbank

Priorität: Lokale APNS-Zugangsdaten → Push Relay → Überspringen (still). Wenn beide konfiguriert sind, hat die lokale Direktverbindung Vorrang.

Sicherheitshinweis: Der Relay überträgt nur Push-Benachrichtigungstitel und Zusammenfassungen (z.B. „Jemand hat Ihnen eine Nachricht gesendet"), nicht den eigentlichen Nachrichteninhalt. Geräte-Tokens können nicht zum Lesen von Benutzerdaten verwendet werden.

Push Relay (Alle Kanäle)

Für selbstgehostete Server-Betreiber, die die veröffentlichte App eines anderen verwenden (z.B. aus dem App Store/Google Play), haben Sie keine Push-Zugangsdaten des Entwicklers (Apple .p8 Key / Firebase-Dienstkonto / OneSignal API Key).

Das Push-Relay-System bietet Relay-Fähigkeit für APNS, FCM und OneSignal Kanäle:

App-Entwickler aktiviert Relay-Endpunkte auf seinem Server:

# Server des App-Entwicklers .env
APNS_RELAY_SECRET=ein_langer_zufälliger_String
FCM_RELAY_SECRET=ein_langer_zufälliger_String
ONESIGNAL_RELAY_SECRET=ein_langer_zufälliger_String

Selbstgehostete Benutzer benötigen nur Relay-URL und Schlüssel — keine Push-Service-Zugangsdaten erforderlich:

# Selbstgehosteter Server .env
# APNS (iOS native Push)
APNS_RELAY_URL=https://app-developer-server.com
APNS_RELAY_KEY=gemeinsamer_Schlüssel

# FCM (Android native Push)
FCM_RELAY_URL=https://app-developer-server.com
FCM_RELAY_KEY=gemeinsamer_Schlüssel

# OneSignal (Median.co-verpackte Apps)
ONESIGNAL_RELAY_URL=https://app-developer-server.com
ONESIGNAL_RELAY_KEY=gemeinsamer_Schlüssel

Priorität: Lokale Zugangsdaten → Push Relay → Überspringen (still). Wenn beide konfiguriert sind, hat die lokale Direktverbindung Vorrang.

---

Offizieller Push Relay

Selbstgehostete Server-Betreiber können den offiziellen Push Relay verwenden, um iOS/Android Push-Benachrichtigungen ohne Konfiguration von Push-Zugangsdaten zu aktivieren:

# 2026-05-18
APNS_RELAY_URL=https://619.chat
APNS_RELAY_KEY=EzmpqftbsENaRUO6BTABxLV96q7RuEDyokXJr1DWdDjL54cLg7yXVUQqydCQvxrX
FCM_RELAY_URL=https://619.chat
FCM_RELAY_KEY=EzmpqftbsENaRUO6BTABxLV96q7RuEDyokXJr1DWdDjL54cLg7yXVUQqydCQvxrX
ONESIGNAL_RELAY_URL=https://619.chat
ONESIGNAL_RELAY_KEY=EzmpqftbsENaRUO6BTABxLV96q7RuEDyokXJr1DWdDjL54cLg7yXVUQqydCQvxrX

Diese Zeilen zur .env-Datei Ihres selbstgehosteten Servers hinzufügen.

---

Lizenz

Dieses Projekt ist unter der GNU Affero General Public License v3.0 (AGPL-3.0) lizenziert.