SPB Git

Repository Public

deployment.md 5.4 KB

# 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

bash
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', puis curl 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-upgrades actif.

# Opérations courantes (sur M4M64c, dans ~/apps/sp-mail)

bash
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.

Files main
Menu

Theme