README_FR.md
August 11, 2026 · View on GitHub
đ Autres langues : äžæ · English · æ„æŹèȘ · íê”ìŽ Â· Deutsch · Đ ŃŃŃĐșĐžĐč · Español
Une application de messagerie instantanée chiffrée de bout en bout, style WeChat, avec chiffrement ECDH + XSalsa20-Poly1305 sans état par message, appels vidéo en temps réel, stockage de fichiers Cloudflare R2, support multilingue et déploiement PWA iOS.
đž Captures d'Ă©cran (cliquez pour agrandir)
Fonctionnalités
| Fonctionnalité | Description |
|---|---|
| đ Chiffrement de bout en bout | ECDH sans Ă©tat + XSalsa20-Poly1305 â clĂ©s Ă©phĂ©mĂšres par message, forward secrecy, vĂ©rification du numĂ©ro de sĂ©curitĂ© style Signal |
| đïž Serveur Ă connaissance nulle | Le serveur ne stocke que le texte chiffrĂ© ; les clĂ©s privĂ©es ne quittent jamais l'appareil |
| đč Appels vidĂ©o et audio | SFU LiveKit pour les appels 1:1 et les rĂ©unions (jusquâĂ 100 participants), mise en sourdine globale et mode cours |
| đïž Modificateur de voix | Effets vocaux en temps rĂ©el pour les messages vocaux, appels 1:1 et appels de groupe â 3 modes (0.8x grave / 1.0x normal / 1.2x aigu), basĂ© sur Web Audio API |
| đ± Persistance de session | Jetons dâaccĂšs de 30 minutes avec sessions de rafraĂźchissement dâappareil de 90 jours ; rĂ©cupĂ©ration automatique aprĂšs changement de rĂ©seau, IP, VPN ou proxy sans mot de passe |
| đš Synchronisation fiable | Heartbeat bidirectionnel, dĂ©tection des connexions semi-ouvertes, boĂźte dâenvoi persistante, identifiants idempotents et rattrapage par curseur de sĂ©quence serveur |
| đŽ AccĂšs hors ligne | Cache isolĂ© par compte pour contacts, groupes, jusquâĂ 2 000 messages par conversation, Moments, Timeline et mĂ©dias ; les envois hors ligne sont retentĂ©s automatiquement |
| đ Recherche Unicode dâamis | Protection de composition IME, normalisation NFC et encodage UTF-8 pour une recherche fiable des noms dâutilisateur et pseudonymes chinois |
| đ„ Chat de groupe | Jusqu'Ă 2000 membres, modes « ChiffrĂ© » / « Non chiffrĂ© » commutables (propriĂ©taire uniquement, le changement efface l'historique). Le mode chiffrĂ© utilise le protocole Sender Key de type Signal (chiffrement symĂ©trique XSalsa20-Poly1305 + distribution de clĂ©s ECDH) â seuls les membres du groupe peuvent dĂ©chiffrer les messages ; les bots sont dĂ©sactivĂ©s en mode chiffrĂ©. Mode Ne pas dĂ©ranger, gestion des membres |
| đ« SystĂšme d'amis | Les demandes d'amitiĂ© nĂ©cessitent une approbation avec jusqu'Ă 512 caractĂšres de message ; surnoms personnalisĂ©s ; regroupement par Ă©tiquettes |
| â±ïž Suppression automatique des messages | 5 niveaux (jamais / 1 jour / 3 jours / 1 semaine / 1 mois), configurable par les deux parties en DM, uniquement par le propriĂ©taire dans les groupes |
| đ Notifications push | Web Push (VAPID) + FCM + OneSignal + ntfy + APNS cinq canaux â atteint les utilisateurs mĂȘme hors ligne (iOS natif + Android chinois sans Google Services) |
| đ Multilingue | Chinois, anglais, japonais, corĂ©en, français, allemand, russe, espagnol â dĂ©tection automatique + changement manuel |
| đ± iOS â Sans certificat d'entreprise | PWA via Safari « Ajouter Ă l'Ă©cran d'accueil », fonctionne en permanence sans signature Apple |
| đ± App native Android | Disponible sur Google Play, avec support des notifications push FCM |
| đ± App native iOS | Disponible sur l'App Store, avec support des notifications push APNS |
| đ„ïž Client bureau Windows | Application de bureau Windows native, tĂ©lĂ©charger ici |
| đ Client bureau Mac | Application de bureau Mac native, tĂ©lĂ©charger ici |
| đŹ Messagerie enrichie | Texte, images, vidĂ©o, fichiers documents, messages vocaux, 200+ emojis, packs de stickers Telegram, accusĂ©s de rĂ©ception, indicateurs de saisie |
| đ€ TĂ©lĂ©versement de fichiers | Jusqu'Ă 500 Mo par fichier, Cloudflare R2 ou stockage local, avec animation de progression |
| đ Moments | Fil social style WeChat : texte + jusqu'Ă 9 photos ou 1 vidĂ©o (†10 min), likes, commentaires, visibilitĂ© par Ă©tiquettes |
| đ€ Profil utilisateur | Page de profil de contact avec contrĂŽles de confidentialitĂ© bidirectionnels des Moments |
| đ° Fil d'actualitĂ© | Fil public style Xiaohongshu â mise en page masonry Ă deux colonnes, publications anonymes, likes et commentaires |
| đ·ïž Ătiquettes d'amis | Attribuer plusieurs Ă©tiquettes par ami (palette de 12 couleurs), filtrer les contacts par Ă©tiquette |
| đïž Stockage d'objets R2 | Cloudflare R2 pour les fichiers image/audio â URL CDN publique optionnelle |
| đ Authentification Ă deux facteurs (2FA) | TOTP compatible Google Authenticator, 8 codes de rĂ©cupĂ©ration, obligatoire Ă la connexion |
| đ· Scanner et partager des QR codes | Scanner des QR codes pour ajouter des amis ou rejoindre des groupes avec expiration configurable |
| đïž Auto-hĂ©bergeable | Docker Compose, Zeabur en un clic, ou frontend sur Vercel |
| đ ParamĂštres de proxy | Support proxy SOCKS5 / HTTP / HTTPS â configurable sur les pages de connexion et de paramĂštres avec adresse serveur, port, identifiant et mot de passe pour les environnements rĂ©seau restreints |
| đĄïž ModĂ©ration de contenu | Signalements utilisateurs (6 catĂ©gories) + blocage d'utilisateurs (masquage instantanĂ© des publications/messages) + Conditions d'utilisation (EULA) |
| đ§ Panneau d'administration | Dashboard web d'administration intĂ©grĂ© (/admin, chemin configurable), protĂ©gĂ© par mot de passe, examiner les signalements, supprimer le contenu problĂ©matique, bannir des utilisateurs â 8 langues |
Nouveautés de la v2.3.9
- Correction des anciennes relations dâamitiĂ© Ă sens unique qui affichaient « DĂ©jĂ amis » alors que le contact restait invisible et indisponible pour discuter ; un nouvel ajout rĂ©pare dĂ©sormais les deux sens et actualise immĂ©diatement la liste des contacts.
Nouveautés de la v2.3.8
- Correction du bouton Retour inactif aprĂšs le dĂ©marrage de la camĂ©ra du scanner QR ; la fermeture arrĂȘte et libĂšre dĂ©sormais immĂ©diatement la camĂ©ra.
- Correction des demandes dâami rĂ©pĂ©tĂ©es Ă un ami existant qui endommageaient la relation ; les rĂ©sultats indiquent dĂ©sormais « DĂ©jĂ amis ».
- Les messages privĂ©s sortants placent le texte chiffrĂ© dans lâobjet optimiste dĂšs la fin du chiffrement de bout en bout, sans persister temporairement le texte en clair avant lâaccusĂ© du serveur.
- Les messages vocaux sâarrĂȘtent automatiquement Ă 120 secondes ; la sortie avec changement de voix suit la mĂȘme limite.
- LâĂ©cran reste actif pendant les enregistrements et appels, et les pĂ©riphĂ©riques ainsi que les minuteurs sont libĂ©rĂ©s en quittant la page.
- Android protÚge aussi les clés et caches avec Android Keystore et AES-256-GCM ; le client Web conserve le stockage du navigateur.
Récupération de session et fiabilité des messages
PaperPhonePlus sĂ©pare lâĂ©tat local du compte, la connexion temps rĂ©el et la synchronisation des messages. Un WebSocket ouvert nâest utilisable quâaprĂšs rĂ©ception de auth_ok. Les heartbeats bidirectionnels ping/pong dĂ©tectent les connexions semi-ouvertes causĂ©es par un changement de VPN/IP, un basculement Wi-Fi/mobile ou la suspension de lâapplication.
- Les jetons dâaccĂšs durent 30 minutes. Les jetons de rafraĂźchissement dâappareil durent 90 jours et sont prolongĂ©s pendant lâutilisation active, sans redemander le mot de passe.
- Les appareils dĂ©jĂ connectĂ©s avec une ancienne version sont mis Ă niveau automatiquement tant que leur jeton reste valide. Sâil a expirĂ©, une derniĂšre connexion manuelle est nĂ©cessaire.
- Chaque message sortant possĂšde une
client_msg_idstable. Sans ACK serveur, il reste dans la boĂźte dâenvoi locale persistante et est renvoyĂ© avec le mĂȘme ID ; une contrainte dâunicitĂ© empĂȘche les doublons. - Chaque message stockĂ© possĂšde une
server_seqcroissante. Le client rattrape les messages manquants par curseur aprĂšs authentification, reconnexion et retour au premier plan. - La dĂ©connexion explicite et la rĂ©vocation dâun appareil invalident la session durable. Les erreurs rĂ©seau ordinaires et changements dâIP la conservent.
Important
Lors dâune mise Ă niveau, dĂ©ployez dâabord le serveur, puis les clients. Le serveur applique et vĂ©rifie automatiquement la migration de fiabilitĂ© et refuse de dĂ©marrer si des colonnes critiques manquent. Sauvegardez MySQL avant toute mise Ă niveau de production.
Stack technique
Backend (server/)
Rust (Axum 0.8) â Framework web asynchrone haute performance
sqlx + MySQL 8.0 â Persistance des utilisateurs/messages
deadpool-redis + Redis 7 â PrĂ©sence en ligne + routage inter-nĆuds
aws-sdk-s3 â Stockage fichiers Cloudflare R2 (API compatible S3)
Authentification argon2 + jsonwebtoken
Frontend (client/)
React 19 + TypeScript + Vite 6
Gestion d'état Zustand
libsodium-wrappers-sumo (WebAssembly â Curve25519 / XSalsa20-Poly1305)
WebRTC API â appels vidĂ©o / audio
Web Audio API â modificateur de voix en temps rĂ©el (chaĂźne audio ScriptProcessorNode)
PWA : manifest.json + Service Worker
Couche cryptographique
ECDH sans Ă©tat + XSalsa20-Poly1305 â paire de clĂ©s Ă©phĂ©mĂšre par message
Persistance des clĂ©s Ă quatre niveaux : mĂ©moire â localStorage â sessionStorage â IndexedDB
Toutes les clĂ©s privĂ©es stockĂ©es uniquement sur l'appareil â jamais envoyĂ©es au serveur
đ Guide de dĂ©ploiement dĂ©taillĂ© (äžæ) | Deployment Guide (English) â Instructions Ă©tape par Ă©tape complĂštes pour le dĂ©ploiement hybride Zeabur + Vercel, le dĂ©ploiement local avec Docker Compose + Nginx, et la configuration de l'adresse du serveur client.
Option 0 : Déploiement cloud Zeabur en un clic
Limitation rĂ©seau des appels sur Zeabur : le modĂšle dĂ©ploie LiveKit avec WebSocket/API 7880 et ICE/TCP 7881. Zeabur nâexpose actuellement pas de ports UDP ; les appels 1:1 et les rĂ©unions utilisent donc le repli TCP. Pour les appels en production, utilisez LiveKit Cloud ou une VM prenant en charge UDP.
Configuration Nginx cÎté serveur
Utilisez la configuration de production Ă deux domaines deploy/nginx/paperphone-plus.conf. Remplacez api.example.com et meeting.example.com, obtenez les certificats TLS, copiez le fichier dans /etc/nginx/sites-available/paperphone-plus, activez-le, puis exĂ©cutez sudo nginx -t && sudo systemctl reload nginx. DĂ©finissez LIVEKIT_URL=wss://meeting.example.com. Nginx ne relaie que lâAPI et WebSocket ; exposez directement TCP 7881 et UDP 7882 dans les pare-feu.
Tip
AvancĂ© : DĂ©ploiement hybride Zeabur + Vercel AprĂšs le dĂ©ploiement sur Zeabur, vous pouvez supprimer manuellement le service client et dĂ©ployer le frontend sur Vercel Ă la place (voir Option 2 ci-dessous). Ainsi, server/MySQL/Redis sont hĂ©bergĂ©s sur Zeabur tandis que le frontend est accĂ©lĂ©rĂ© par le CDN mondial de Vercel. Le frontend ne nĂ©cessite aucune variable d'environnement sur Vercel â les utilisateurs saisissent simplement l'adresse du serveur backend sur la page de connexion.
Option 1 : Docker Compose (Recommandé)
git clone <repo-url> && cd paperphone-plus
cp server/.env.example server/.env
# Modifier : DB_PASS / JWT_SECRET / LIVEKIT_URL etc.
docker compose up -d
open http://localhost
Option 2 : Frontend sur Vercel
# 1. Forker ce dépÎt
# 2. Importer dans Vercel : Root Directory = client/, Build = npm run build, Output = dist/
# Aucune variable d'environnement requise
# 3. Déployer le backend via Docker ou Zeabur
# 4. Ouvrir le frontend déployé sur Vercel, saisir l'adresse du serveur backend sur la page de connexion
# ex. https://your-server.zeabur.app
Option 3 : Développement local
# Backend (Rust)
cd server && cp .env.example .env && cargo run --release
# Frontend (React)
cd client && npm install && npm run dev
Modificateur de voix
Les messages vocaux, les appels 1:1 et les appels de groupe supportent la modification de voix en temps réel avec 3 modes sélectionnables :
| Mode | Vitesse | Effet |
|---|---|---|
| đą Lent | 0.8x | Voix plus profonde et grave â idĂ©al pour l'anonymat |
| đ Normal | 1.0x | Voix originale, aucun traitement |
| đ Rapide | 1.2x | Voix plus aiguĂ« â amusant et ludique |
Fonctionnement : Utilise la Web Audio API pour construire une chaĂźne de traitement audio (AudioContext â MediaStreamSource â ScriptProcessorNode â MediaStreamDestination) qui ajuste la hauteur/vitesse de l'entrĂ©e microphone en temps rĂ©el.
- Messages vocaux : Sélectionner le mode vocal pendant l'enregistrement. Le fichier
.webmexportĂ© contient dĂ©jĂ l'effet vocal â les destinataires ne peuvent pas restaurer la voix originale, permettant une messagerie vĂ©ritablement anonyme - Appels 1:1 / Groupe : Appuyer sur le bouton modificateur de voix pendant un appel pour alterner entre les modes. La piste audio traitĂ©e remplace l'originale via
LiveKit LocalAudioTrack.replaceTrack()
Aucune configuration cÎté serveur requise. Le modificateur de voix fonctionne entiÚrement cÎté client.
Variables d'environnement
| Variable | Description | Défaut |
|---|---|---|
PORT | Port du serveur | 3000 |
JWT_SECRET | Clé de signature JWT (changer en production) | dev_secret |
DB_HOST / DB_PASS / DB_NAME | Connexion MySQL | â |
REDIS_HOST / REDIS_PASS | Connexion Redis | â |
R2_ACCOUNT_ID | ID de compte Cloudflare | â |
R2_ACCESS_KEY_ID | Access Key du jeton API R2 | â |
R2_SECRET_ACCESS_KEY | Secret Key du jeton API R2 | â |
R2_BUCKET | Nom du bucket R2 | â |
R2_PUBLIC_URL | URL de base publique R2 (optionnel) | â |
LIVEKIT_URL | URL WebSocket publique LiveKit pour tous les appels | â |
LIVEKIT_API_KEY | ClĂ© API partagĂ©e par le serveur et LiveKit | â |
LIVEKIT_API_SECRET | Secret API partagĂ© par le serveur et LiveKit | â |
VAPID_PUBLIC_KEY | ClĂ© publique VAPID Web Push (optionnel) | â |
VAPID_PRIVATE_KEY | ClĂ© privĂ©e VAPID Web Push (optionnel) | â |
VAPID_SUBJECT | Email de contact VAPID (optionnel) | mailto:admin@paperphoneplus.app |
FCM_PROJECT_ID | ID du projet Firebase (optionnel, Capacitor Android) | â |
FCM_CLIENT_EMAIL | Email du compte de service Firebase (optionnel) | â |
FCM_PRIVATE_KEY | ClĂ© privĂ©e du compte de service Firebase (optionnel, supporte l'Ă©chappement \n et les sauts de ligne rĂ©els ; voir ci-dessous) | â |
FCM_RELAY_SECRET | Secret du relay push FCM (optionnel, configurer sur l'hĂŽte relay pour activer le endpoint) | â |
FCM_RELAY_URL | URL du relay push FCM (optionnel, les serveurs auto-hĂ©bergĂ©s pointent vers l'hĂŽte relay) | â |
FCM_RELAY_KEY | ClĂ© d'authentification du relay push FCM (optionnel, doit correspondre au FCM_RELAY_SECRET de l'hĂŽte relay) | â |
ONESIGNAL_APP_ID | OneSignal App ID (optionnel) | â |
ONESIGNAL_REST_KEY | OneSignal REST API Key (optionnel) | â |
ONESIGNAL_RELAY_SECRET | Secret du relay push OneSignal (optionnel, configurer sur l'hĂŽte relay pour activer le endpoint) | â |
ONESIGNAL_RELAY_URL | URL du relay push OneSignal (optionnel, les serveurs auto-hĂ©bergĂ©s pointent vers l'hĂŽte relay) | â |
ONESIGNAL_RELAY_KEY | ClĂ© d'authentification du relay push OneSignal (optionnel, doit correspondre au ONESIGNAL_RELAY_SECRET de l'hĂŽte relay) | â |
NTFY_BASE_URL | URL du serveur ntfy (optionnel, utilise le service public ntfy.sh par défaut) | https://ntfy.sh |
NTFY_TOKEN | Jeton d'authentification ntfy (optionnel, pour les serveurs auto-hĂ©bergĂ©s) | â |
APNS_TEAM_ID | Apple Developer Team ID (optionnel, push natif iOS) | â |
APNS_KEY_ID | ID de clĂ© d'authentification APNS (optionnel) | â |
APNS_PRIVATE_KEY | Contenu de la clĂ© privĂ©e .p8 APNS (optionnel, supporte l'Ă©chappement \n) | â |
APNS_BUNDLE_ID | iOS App Bundle Identifier (optionnel) | â |
APNS_SANDBOX | Mode sandbox APNS (optionnel, true pour développement/TestFlight) | false |
APNS_RELAY_SECRET | Secret du relay push (optionnel, configurer sur l'hĂŽte relay pour activer le endpoint) | â |
APNS_RELAY_URL | URL du relay push (optionnel, les serveurs auto-hĂ©bergĂ©s pointent vers l'hĂŽte relay) | â |
APNS_RELAY_KEY | ClĂ© d'authentification du relay push (optionnel, doit correspondre au APNS_RELAY_SECRET de l'hĂŽte relay) | â |
TELEGRAM_BOT_TOKEN | Telegram Bot Token (optionnel) | â |
STICKER_PACKS | Packs de stickers personnalisés (optionnel, nom:label) | 13 packs intégrés par défaut |
ADMIN_PATH | Chemin URL du panneau d'administration | /admin |
ADMIN_PASSWORD | Mot de passe du panneau d'administration (changer en production) | admin123 |
Gestion des sauts de ligne de la clé privée FCM
Le champ private_key dans le JSON du compte de service Firebase contient une clé privée RSA au format PEM, qui nécessite des sauts de ligne réels (\n, ASCII 0x0A) entre chaque ligne de 64 caractÚres. Cependant, de nombreuses plateformes de déploiement (Zeabur, Vercel, Railway, Docker) stockent les variables d'environnement sous forme de chaßnes sur une seule ligne, convertissant \n en la séquence littérale de deux caractÚres \ + n.
C'est la cause la plus frĂ©quente d'Ă©chec des notifications push FCM â le parseur PEM Ă©choue silencieusement et aucune notification push n'est envoyĂ©e, sans journaux d'erreur.
Le serveur gÚre cela automatiquement : fcm.rs normalise les séquences littérales \n en sauts de ligne réels avant l'analyse. Les deux formats fonctionnent :
-
Ligne unique (recommandé pour les plateformes cloud) : Coller la valeur brute de
private_keydu fichier JSON avec les échappements\n:FCM_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nMIIEvQ...\n-----END PRIVATE KEY-----\n -
Multi-lignes (pour les fichiers .env) : Envelopper le contenu PEM complet entre guillemets avec des sauts de ligne réels :
FCM_PRIVATE_KEY="-----BEGIN PRIVATE KEY----- MIIEvQ... -----END PRIVATE KEY-----"
| Plateforme | Format recommandé | Notes |
|---|---|---|
| Zeabur | Ligne unique (\n échappé) | Coller la valeur JSON directement dans le panneau Variables |
| Docker / docker-compose | Les deux | Utiliser la syntaxe YAML | pour multi-lignes ; ligne unique dans .env |
| Vercel / Railway | Ligne unique (\n échappé) | Les champs de saisie ne supportent généralement pas les sauts de ligne réels |
| Fichier .env Linux | Multi-lignes (entre guillemets) | S'assurer que les guillemets sont correctement fermés |
Dépannage : Si les variables FCM sont configurées mais que le push Android ne fonctionne pas, vérifier les journaux du serveur :
[FCM] No access token availableâ Erreur de format de clĂ© privĂ©e (problĂšme de saut de ligne)[FCM] â Push sent to user xxxâ L'envoi FCM fonctionne, le problĂšme est cĂŽtĂ© client- Aucun journal FCM â
FCM_PROJECT_IDnon configuré ou aucun token dans la tablefcm_tokens
Push ntfy (Appareils Android chinois sans Google Services)
Pour les appareils Android sans Google Mobile Services (Huawei, Xiaomi, OPPO, vivo, etc.), PaperPhonePlus supporte les notifications push via ntfy.
Configuration par défaut (zéro configuration) : Utilise le service public ntfy.sh. Aucune configuration supplémentaire nécessaire.
Configuration optionnelle (pour les serveurs ntfy auto-hébergés) :
NTFY_BASE_URL=https://your-ntfy-server.com
NTFY_TOKEN=your_optional_auth_token
Procédure de configuration utilisateur :
- Installer l'application ntfy (Google Play / F-Droid / Téléchargement direct)
- Ouvrir les ParamÚtres de PaperPhonePlus et trouver la carte « ntfy Push »
- Copier le nom du topic affiché et s'y abonner dans l'application ntfy
- Appuyer sur « Enregistrer Push » pour terminer l'inscription
Note de sécurité : Les notifications ntfy contiennent les titres et résumés en texte brut (pas le contenu réel du message). Pour une sécurité renforcée, envisagez d'auto-héberger un serveur ntfy.
Push APNS (App native iOS)
APNS (Apple Push Notification Service) envoie des notifications push aux apps iOS natives construites avec Capacitor. Deux options de configuration sont disponibles :
Option A : Configuration directe (Serveur du développeur de l'app)
- Se connecter Ă Apple Developer â Certificates, Identifiers & Profiles â Keys
- Cliquer sur + pour crĂ©er une nouvelle Key â cocher Apple Push Notifications service (APNs) â Register
- Télécharger le fichier
.p8(â ïž ne peut ĂȘtre tĂ©lĂ©chargĂ© qu'une seule fois !) et noter le Key ID - Noter votre Team ID depuis la page de membre Apple Developer (10 caractĂšres alphanumĂ©riques)
- Ajouter Ă
server/.env:
APNS_TEAM_ID=AB12CD34EF
APNS_KEY_ID=LH4Z9YN3P7
APNS_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIGTAgEA...(contenu du fichier .p8)...\n-----END PRIVATE KEY-----"
APNS_BUNDLE_ID=com.yourcompany.paperphoneplus
APNS_SANDBOX=false
APNS_SANDBOX: DĂ©finir Ătruepour les builds de dĂ©veloppement/TestFlight,falsepour la production App Store.
Option B : Via Push Relay (Serveurs auto-hébergés)
Si vous utilisez l'app iOS de quelqu'un d'autre (ex. téléchargée depuis l'App Store), vous n'avez pas les identifiants Apple du développeur et ne pouvez pas envoyer de pushes APNS directement. Utilisez le Push Relay à la place.
Fonctionnement :
ââââââââââââââââââââââââ âââââââââââââââââââââââââââ âââââââââââ
â Serveur â HTTP â Serveur du â APNS â Apple â
â auto-hĂ©bergĂ© âââââââââ dĂ©veloppeur âââââââââ âââ đ± â
â (sans creds Apple) â â (a .p8 Key + Relay) â âââââââââââ
â APNS_RELAY_URL=... â â APNS_TEAM_ID=... â
â APNS_RELAY_KEY=... â â APNS_RELAY_SECRET=... â
ââââââââââââââââââââââââ âââââââââââââââââââââââââââ
Ătape 1 : Le dĂ©veloppeur de l'app active le endpoint Relay
Sur le serveur du développeur de l'app (qui possÚde déjà les identifiants APNS), configurer un secret relay :
# .env du serveur du développeur (a déjà APNS_TEAM_ID etc.)
APNS_RELAY_SECRET=un_long_secret_partagé_aléatoire
Cela active automatiquement le endpoint de relay push Ă POST /api/push-relay/apns.
Ătape 2 : L'utilisateur auto-hĂ©bergĂ© configure le Relay
Les serveurs auto-hĂ©bergĂ©s n'ont besoin que de deux variables â aucun identifiant Apple requis :
# .env du serveur auto-hébergé
APNS_RELAY_URL=https://app-developer-server.com
APNS_RELAY_KEY=le_secret_partagé_de_l_étape_1
Fonctionnement :
- Le serveur auto-hĂ©bergĂ© reçoit un message hors ligne â interroge la table locale
apns_tokenspour les tokens d'appareils iOS de l'utilisateur - Envoie les tokens d'appareils + titre/contenu push via HTTP POST au Relay
- Le Relay valide la clé, puis envoie à Apple en utilisant ses propres identifiants APNS
- Le Relay retourne une liste de tokens obsolÚtes ; le serveur auto-hébergé nettoie automatiquement sa base de données locale
PrioritĂ© : Identifiants APNS locaux â Push Relay â Ignorer (silencieux). Si les deux sont configurĂ©s, la connexion directe locale a la prioritĂ©.
Note de sĂ©curitĂ© : Le relay ne transmet que les titres et rĂ©sumĂ©s des notifications push (ex. « Quelqu'un vous a envoyĂ© un message »), pas le contenu rĂ©el du message. Les tokens d'appareils ne peuvent pas ĂȘtre utilisĂ©s pour lire les donnĂ©es des utilisateurs.
Push Relay (Tous les canaux)
Pour les opérateurs de serveurs auto-hébergés utilisant l'app publiée par quelqu'un d'autre (ex. depuis l'App Store/Google Play), vous n'avez pas les identifiants push du développeur (Apple .p8 Key / compte de service Firebase / OneSignal API Key).
Le systÚme Push Relay fournit une capacité de relais pour les canaux APNS, FCM et OneSignal :
Le développeur de l'app active les endpoints relay sur son serveur :
# .env du serveur du développeur
APNS_RELAY_SECRET=une_longue_chaßne_aléatoire
FCM_RELAY_SECRET=une_longue_chaßne_aléatoire
ONESIGNAL_RELAY_SECRET=une_longue_chaßne_aléatoire
Les utilisateurs auto-hĂ©bergĂ©s n'ont besoin que de l'URL et la clĂ© du relay â aucun identifiant de service push requis :
# .env du serveur auto-hébergé
# APNS (push natif iOS)
APNS_RELAY_URL=https://app-developer-server.com
APNS_RELAY_KEY=secret_partagé
# FCM (push natif Android)
FCM_RELAY_URL=https://app-developer-server.com
FCM_RELAY_KEY=secret_partagé
# OneSignal (apps empaquetées avec Median.co)
ONESIGNAL_RELAY_URL=https://app-developer-server.com
ONESIGNAL_RELAY_KEY=secret_partagé
PrioritĂ© : Identifiants locaux â Push Relay â Ignorer (silencieux). Si les deux sont configurĂ©s, la connexion directe locale a la prioritĂ©.
Push Relay officiel
Les opérateurs de serveurs auto-hébergés peuvent utiliser le relay push officiel pour activer les notifications push iOS/Android sans configurer d'identifiants push :
# 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
Ajoutez ces lignes au fichier .env de votre serveur auto-hébergé.
Licence
Ce projet est distribué sous la GNU Affero General Public License v3.0 (AGPL-3.0).