SPB Git

Repository Public

deployment.md 5.4 KB 66 lines markdown

1# SP Mail — déploiement et exploitation23> **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`](next/RELEASE-NEXT.md) ; exploitation et alertes : [`next/OPERATIONS-NEXT.md`](next/OPERATIONS-NEXT.md), [`next/PUSH.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`.45## Où tourne quoi67| Élément | Machine | Emplacement | Gestion |8|---|---|---|---|9| Stalwart 1.1.1 (épinglé) | BHS64 | `/usr/local/bin/stalwart`, `/etc/stalwart`, `/var/lib/stalwart`, journaux `journalctl -u stalwart` | `systemctl … stalwart` |10| `stalwart-cli` 2.0.0 | BHS64 | `/usr/local/bin/stalwart-cli` | — |11| 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` |12| ClamAV + milter | BHS64 | `/etc/clamav/clamav-milter.conf` (original en `.dist`), `127.0.0.1:7357` | `systemctl … clamav-daemon clamav-milter` |13| Sauvegarde du courrier | BHS64 | `/usr/local/sbin/sp-mail-edge-backup`, `/var/backups/sp-mail` | `sp-mail-backup.timer` (03:20) |14| 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`) |15| Base du backend | M4M64c | PostgreSQL 17, base `sp_mail` | PM2 `sp-mail-backup` (03:45) |16| Copie des sauvegardes du courrier | M4M64c | `~/backups/sp-mail/edge` | PM2 `sp-mail-edge-pull` (03:50) |17| Route publique | BHS64 | Caddy `mail.spboucher.ai → 10.67.0.33:8730` | `mld tunnel` |1819Pare-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`.2021## Secrets (jamais dans le dépôt)2223| Secret | Où |24|---|---|25| Compte de gestion Stalwart `spmail-admin@spboucher.ai` | `BHS64:/root/.sp-mail-svc`, manifeste mld, `~/Desktop/Cluster/secrets/sp-mail/stalwart-admin.pw` |26| Administrateur de récupération Stalwart (inactif hors mode récupération) | `BHS64:/root/.sp-mail-admin` |27| Clé maîtresse du backend (scelle les secrets de boîtes) | manifeste mld, `secrets/sp-mail/master-prod.key` |28| Clé de chiffrement des sauvegardes | `M4M64c:~/.config/sp-mail/backup.key`, `BHS64:/root/.sp-mail-backup.key`, `secrets/sp-mail/backup-prod.key` |29| Clé SSH de tirage des sauvegardes (commande forcée) | `M4M64c:~/.ssh/sp-mail-backup_ed25519` |30| Clés privées DKIM | dans la base Stalwart (donc dans les sauvegardes chiffrées) |3132## Installer le serveur de courrier depuis zéro3334```bash35scp infra/mail-edge/install-stalwart.sh infra/mail-edge/*.ndjson BHS64:/tmp/36ssh BHS64 'sudo bash /tmp/install-stalwart.sh'                       # binaire épinglé, utilisateur, unité systemd37# config.json = {"@type":"RocksDb","path":"/var/lib/stalwart/"} ; stalwart.env = STALWART_RECOVERY_MODE=1 + STALWART_RECOVERY_ADMIN=admin:<secret>38ssh BHS64 'sudo systemctl start stalwart && stalwart-cli --url http://127.0.0.1:8080 --user admin --password <secret> apply --file /tmp/plan-bootstrap.ndjson'39# créer le compte de gestion, remplacer stalwart.env par STALWART_PUBLIC_URL=http://10.67.0.1:8080, redémarrer40ssh BHS64 'stalwart-cli … apply --file /tmp/plan-hardening.ndjson && stalwart-cli … create Action/ReloadSettings --json "{}"'41```42Les écouteurs, magasins et `proxyTrustedNetworks` ne changent qu'au redémarrage ; le reste après `Action/ReloadSettings`.4344## Mettre à jour4546- **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`.47- **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.48- **Correctifs système BHS64** : `unattended-upgrades` actif.4950## Opérations courantes (sur M4M64c, dans `~/apps/sp-mail`)5152```bash53E='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'54node dist/cli.mjs bootstrap            # lien à usage unique du premier administrateur55node dist/cli.mjs recover <handle>     # appareil perdu56node dist/cli.mjs mailbox-add info@spboucher.ai <handle> --name "Simon-Pierre Boucher"57node dist/cli.mjs status | dns | revoke-sessions <handle>58```59(`mailbox-add`, `dns` exigent aussi `SPMAIL_STALWART_ADMIN_PASSWORD` et `SPMAIL_MASTER_KEY`, présents dans l'environnement PM2 : `pm2 env <id>`.)6061File 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`.6263## Surveillance6465En 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.66
Files main
Menu

Theme