SP Mail — architecture
État : 2026-11-18. Tout ce qui est décrit ici est déployé, sauf mention « prévu ».
flowchart LR
subgraph Internet
MTA[Serveurs de courrier tiers]
U[Navigateur · app macOS · app iOS]
APNS[(APNs Apple — prévu)]
end
subgraph BHS64["BHS64 — OVH Beauharnois, 51.161.112.61"]
direction TB
S25["Stalwart 1.1.1<br/>SMTP :25 (public)"]
SJ["Stalwart JMAP + gestion<br/>10.67.0.1:8080 et 127.0.0.1:8080 (privé)"]
DB[("RocksDB /var/lib/stalwart<br/>boîtes, index, file d'attente")]
AV["ClamAV milter 127.0.0.1:7357"]
C["Caddy :443<br/>mail.spboucher.ai · mx1 (certificat)"]
BK["Sauvegarde chiffrée 03:20<br/>/var/backups/sp-mail"]
end
subgraph MacLustr["MacLustr — M4M64c (LAN, WireGuard 10.67.0.33)"]
API["Backend SP Mail :8730<br/>passkeys · sessions · passerelle JMAP · admin"]
PG[("PostgreSQL sp_mail<br/>identités, secrets de boîtes scellés")]
BK2["Copie des sauvegardes 03:50<br/>~/backups/sp-mail"]
end
MTA <-- "SMTP + STARTTLS" --> S25
S25 --- DB
SJ --- DB
S25 -- scan --> AV
U -- "HTTPS" --> C
C -- "WireGuard" --> API
API -- "JMAP (WireGuard, secret par boîte)" --> SJ
API --- PG
BK -- "clé SSH à commande forcée" --> BK2
API -. "métadonnées minimales" .-> APNS
Composants et frontières de confiance
| Zone | Contenu | Exposition |
|---|---|---|
| Bordure publique (BHS64) | Stalwart : réception/envoi SMTP direct, DKIM, SPF/DMARC/iprev entrants, antispam, file d'attente, stockage des boîtes (décision D1 du propriétaire) ; ClamAV ; Caddy | 25/tcp (SMTP), 443/tcp (Caddy). Rien d'autre du courrier : pas d'IMAP, pas de submission, pas de console d'administration publics |
| Gestion du serveur de courrier | API JMAP + gestion de Stalwart (:8080, HTTP clair) |
loopback et interface WireGuard seulement ; ufw n'accepte que 10.67.0.33 (backend) |
| Backend (M4M64c) | identité (passkeys WebAuthn), sessions par appareil, passerelle JMAP, API d'administration, mandataire d'images | derrière Caddy (mail.spboucher.ai), joint par WireGuard |
| Clients | web (React/TS), macOS et iOS (SwiftUI, socle SPMailCore) |
parlent JMAP standard au backend, jamais à Stalwart |
Pourquoi une passerelle plutôt que Stalwart exposé directement : une seule surface d'authentification (passkeys), des sessions révocables par appareil, aucun mot de passe de boîte dans un client, et la console de gestion du serveur de courrier hors d'Internet. Chaque boîte a dans Stalwart un mot de passe aléatoire que personne ne connaît ; le backend le garde scellé (AES-256-GCM, clé maîtresse hors base) et l'ajoute aux requêtes relayées. La passerelle refuse la capacité urn:stalwart:jmap et toute méthode x:*.
Flux
- Réception : MTA tiers →
mx1.spboucher.ai:25(STARTTLS, certificat Let's Encrypt obtenu par Caddy et recopié vers Stalwart parsp-mail-cert.path) → vérifications SPF/DKIM/DMARC/iprev → ClamAV (refus 550 si infecté, 4xx si l'antivirus est en panne) → antispam (score ≥ 5 → dossier Indésirables, jamais de suppression silencieuse) → boîte. - Envoi : client →
EmailSubmission/set(passerelle) → file Stalwart → signature DKIM (ed25519 + RSA-2048) → livraison directe au MX du destinataire, IPv4 seulement (ufw reject outdu port 25 en IPv6, faute de PTR IPv6). Aucun relais tiers. - Lecture : client →
https://mail.spboucher.ai/api/jmap/{boîte}/…→ backend → Stalwart par WireGuard. - Temps réel : EventSource JMAP relayé (états seulement). Push iOS (APNs) : prévu, métadonnées minimales.
Choix écartés
| Écarté | Raison |
|---|---|
| Boîtes stockées sur MacLustr, BHS64 simple relais | deux Stalwart à maintenir ; lecture dépendante du réseau résidentiel (IP changée le 2026-09-28, coupures). Réversible : export/import Stalwart |
| IMAP / submission publics | inutiles aux trois clients SP Mail ; surface d'attaque et mots de passe d'application en plus. Ouvrables plus tard |
| ACME intégré de Stalwart | Caddy possède déjà 80/443 sur BHS64 |
| IPv6 pour SMTP | pas de PTR IPv6 ; Gmail rejette sans PTR |
| IA dans le chemin de livraison | l'IA (phase G) est un service séparé, optionnel, jamais requis |