SP Mail — déploiement et exploitation
Version 1.0.0 (SP Mail Next) en production depuis le 2026-11-20. Procédure, variables nouvelles (APNs, IA locale, surveillance) et retour arrière :
next/RELEASE-NEXT.md; exploitation et alertes :next/OPERATIONS-NEXT.md,next/PUSH.md. Clés hors dépôt ajoutées sur le nœud :~/.config/sp-mail/apns-AuthKey_Z9M555KPUY.p8,~/.config/sp-mail/llm-local.key.
Où tourne quoi
| Élément | Machine | Emplacement | Gestion |
|---|---|---|---|
| Stalwart 1.1.1 (épinglé) | BHS64 | /usr/local/bin/stalwart, /etc/stalwart, /var/lib/stalwart, journaux journalctl -u stalwart |
systemctl … stalwart |
stalwart-cli 2.0.0 |
BHS64 | /usr/local/bin/stalwart-cli |
— |
Certificat mx1.spboucher.ai |
BHS64 | obtenu par Caddy (/etc/caddy/sites/mx1.spboucher.ai.caddy), recopié dans /etc/stalwart/tls |
sp-mail-cert.path → /usr/local/sbin/sp-mail-sync-cert |
| ClamAV + milter | BHS64 | /etc/clamav/clamav-milter.conf (original en .dist), 127.0.0.1:7357 |
systemctl … clamav-daemon clamav-milter |
| Sauvegarde du courrier | BHS64 | /usr/local/sbin/sp-mail-edge-backup, /var/backups/sp-mail |
sp-mail-backup.timer (03:20) |
| Backend + web | M4M64c | ~/apps/sp-mail (clone git, origin spbgit sp-mail.git), PM2 sp-mail (port 8730) |
mld (manifeste M1M32:~/dispatch/apps/sp-mail.json) |
| Base du backend | M4M64c | PostgreSQL 17, base sp_mail |
PM2 sp-mail-backup (03:45) |
| Copie des sauvegardes du courrier | M4M64c | ~/backups/sp-mail/edge |
PM2 sp-mail-edge-pull (03:50) |
| Route publique | BHS64 | Caddy mail.spboucher.ai → 10.67.0.33:8730 |
mld tunnel |
Pare-feu BHS64 ajouté pour SP Mail : 25/tcp entrant ; reject out du port 25 en IPv6 ; wg0 : 10.67.0.33 → 10.67.0.1:8080.
Secrets (jamais dans le dépôt)
| Secret | Où |
|---|---|
Compte de gestion Stalwart spmail-admin@spboucher.ai |
BHS64:/root/.sp-mail-svc, manifeste mld, ~/Desktop/Cluster/secrets/sp-mail/stalwart-admin.pw |
| Administrateur de récupération Stalwart (inactif hors mode récupération) | BHS64:/root/.sp-mail-admin |
| Clé maîtresse du backend (scelle les secrets de boîtes) | manifeste mld, secrets/sp-mail/master-prod.key |
| Clé de chiffrement des sauvegardes | M4M64c:~/.config/sp-mail/backup.key, BHS64:/root/.sp-mail-backup.key, secrets/sp-mail/backup-prod.key |
| Clé SSH de tirage des sauvegardes (commande forcée) | M4M64c:~/.ssh/sp-mail-backup_ed25519 |
| Clés privées DKIM | dans la base Stalwart (donc dans les sauvegardes chiffrées) |
Installer le serveur de courrier depuis zéro
scp infra/mail-edge/install-stalwart.sh infra/mail-edge/*.ndjson BHS64:/tmp/
ssh BHS64 'sudo bash /tmp/install-stalwart.sh' # binaire épinglé, utilisateur, unité systemd
# config.json = {"@type":"RocksDb","path":"/var/lib/stalwart/"} ; stalwart.env = STALWART_RECOVERY_MODE=1 + STALWART_RECOVERY_ADMIN=admin:<secret>
ssh BHS64 'sudo systemctl start stalwart && stalwart-cli --url http://127.0.0.1:8080 --user admin --password <secret> apply --file /tmp/plan-bootstrap.ndjson'
# créer le compte de gestion, remplacer stalwart.env par STALWART_PUBLIC_URL=http://10.67.0.1:8080, redémarrer
ssh BHS64 'stalwart-cli … apply --file /tmp/plan-hardening.ndjson && stalwart-cli … create Action/ReloadSettings --json "{}"'Les écouteurs, magasins et proxyTrustedNetworks ne changent qu'au redémarrage ; le reste après Action/ReloadSettings.
Mettre à jour
- Backend / web (remote-first, sur le nœud) :
ssh M4M64c 'cd ~/apps/sp-mail && git pull --ff-only && export PATH=/opt/homebrew/bin:$PATH && pnpm install --frozen-lockfile && pnpm build && pm2 restart sp-mail', puiscurl https://mail.spboucher.ai/api/health/ready. - Stalwart : lire les notes de version ;
sudo /usr/local/sbin/sp-mail-edge-backup;STALWART_VERSION=vX.Y.Z sudo -E bash install-stalwart.sh;systemctl restart stalwart; test SMTP + JMAP. Une version plus récente peut écrire des données illisibles par l'ancienne : le retour arrière passe par la restauration. - Correctifs système BHS64 :
unattended-upgradesactif.
Opérations courantes (sur M4M64c, dans ~/apps/sp-mail)
E='export PATH=/opt/homebrew/bin:$PATH DATABASE_URL=postgres://127.0.0.1/sp_mail SPMAIL_ORIGIN=https://mail.spboucher.ai SPMAIL_RP_ID=mail.spboucher.ai SPMAIL_STALWART_URL=http://10.67.0.1:8080'
node dist/cli.mjs bootstrap # lien à usage unique du premier administrateur
node dist/cli.mjs recover <handle> # appareil perdu
node dist/cli.mjs mailbox-add info@spboucher.ai <handle> --name "Simon-Pierre Boucher"
node dist/cli.mjs status | dns | revoke-sessions <handle>(mailbox-add, dns exigent aussi SPMAIL_STALWART_ADMIN_PASSWORD et SPMAIL_MASTER_KEY, présents dans l'environnement PM2 : pm2 env <id>.)
File d'attente et journaux SMTP : ssh BHS64 'stalwart-cli … query QueuedMessage', journalctl -u stalwart. Aucune console web d'administration n'est exposée ; l'interface Stalwart reste joignable par ssh -L 8080:127.0.0.1:8080 BHS64.
Surveillance
En place : mld heal (PM2 + route toutes les 5 min), healthcheck /api/health/ready, panneau d'administration (état du serveur, DNS en direct, file, certificats, sauvegarde). Non fait : alertes actives (courriel/notification) sur file bloquée, disque, certificat, liste noire.