v1.0.0 Manuel officiel · 5 groupes thématiques · 24 guides ciblés

Documentation nextxch

Manuel de référence clairement organisé couvrant l'installation, le DNS, la sécurité, le groupware, l'automatisation CLI et l'exploitation : chaque guide ciblé documente les valeurs par défaut exactes et les bonnes pratiques de production.

Prise en main

D'un hôte Windows, Linux ou Docker vierge jusqu'à la matrice des ports du périmètre.

Réseau, DNS & cryptographie

Délivrabilité 10/10 avec FCrDNS/PTR, Dual-DKIM, IPv6, pfSense & Let's Encrypt DANE.

Transport & défense de la messagerie

File d'attente SMTP, diagnostics MX en direct, SpamGuard ML, greylisting, ClamAV, Fail2Ban & passerelle de messagerie en amont.

Clients, groupware & CLI

Configuration iPhone compatible messageries, Outlook pour Windows, calendrier & contacts du Webmail, clés API & CLI.

Chap. 10 →

Configuration iPhone, mobile & WhatsApp

Les utilisateurs doivent pouvoir configurer Mail, Calendrier, Contacts et Notes sur iOS et macOS en moins de 30 secondes, sans saisir de ports ni exposer leur m...

Chap. 11 →

Webmail, calendrier (CalDAV) & contacts

Contrairement aux backends de messagerie limités aux protocoles, nextxch est livré avec une PWA Webmail rapide et installable (/mail/), dotée d'un calendrier groupware complet (mois, semaine, j...

Chap. 12 →

Configurer Outlook pour Windows

Microsoft Outlook pour Windows se connecte à nextxch via IMAP (entrant) et SMTP (sortant). Cela s'applique à Outlook classique (Microsoft 365 Apps, Out...

Chap. 13 →

nextxch-cli : commandes, requêtes & IaC

Avec nextxch-cli, vous gérez les domaines, boîtes aux lettres, listes de distribution, alias, clés API à portée limitée, routes SMTP sortantes (y compris dérogations TLS), le préchauffage d'IP...

Chap. 13b →

Configuration as code (GitOps)

L'état complet du serveur sous forme de fichiers YAML dans Git : locataires, domaines (sélecteurs DKIM, MTA-STS, routage), boîtes aux lettres avec alias, transfert et abs...

Chap. 14 →

Schéma des objets API & CLI (tous les champs)

Cette référence documente chaque propriété JSON, type de données, valeur d'énumération, valeur par défaut et rôle RBAC minimal pour les 12 objets de gestion (/api/...

Chap. 15 →

Clés API, Send API & SSO

Les applications web, outils de ticketing, systèmes ERP et pipelines CI/CD ne doivent jamais partager les mots de passe de boîtes aux lettres d'utilisateurs. Sous Clés API, SSO & règles (#pApiAuth), mi...

Chap. 16 →

LDAP, AD, Entra ID & SSO

Sous Admin > Sources d'identité, vous connectez un locataire ou des domaines individuels à Active Directory ou LDAP (connexion par bind, synchronisation des utilisateurs, groupes imbriqués et...

Chap. 16a →

SSO Kerberos (connexion Windows)

Avec Kerberos, les PC Windows du réseau de l'entreprise se connectent sans demande de mot de passe : webmail et admin via SPNEGO ("Se connecter avec Windows"), Out...

Chap. 16b →

OAuth pour Thunderbird, Outlook & CLI

nextxch est son propre serveur d'autorisation OAuth 2.1 : les applications de messagerie se connectent dans le navigateur via la connexion habituelle au webmail (y compris 2FA et clés d'accès),...

Conformité, stockage & exploitation

Message Trace, archive GoBD WORM, SQLite / SQL Server / PostgreSQL 18 & mises à jour.

Référence rapide : les 5 ports entrants requis

De plus, le port TCP 25 sortant doit être ouvert vers internet pour la remise MX directe.

TCP 25ESMTP MX entrant & sortant
TCP 443HTTPS : Webmail, administration, DAV, push
TCP 465Soumission client SMTPS (TLS)
TCP 587Soumission (STARTTLS)
TCP 993Boîte aux lettres IMAPS & push IDLE

Questions fréquentes sur l'exploitation

Quels ports de pare-feu sont strictement nécessaires à nextxch ?

Le fonctionnement complet de la messagerie, de la PWA Webmail, du Mobile Push et de CalDAV/CardDAV requiert 5 ports TCP entrants : 25 (ESMTP MX entrant), 443 (HTTPS pour Webmail, Admin, JMAP, CalDAV/CardDAV & Mobile Push), 465 (SMTPS TLS implicite), 587 (Submission STARTTLS) et 993 (IMAPS). Les ports optionnels sont 80 (Let's Encrypt HTTP-01), 143 (IMAP STARTTLS), 4190 (ManageSieve) et 995 (POP3S) / 110 (POP3 STLS) si POP3 est activé, ainsi que le port TCP 25 sortant vers Internet.

Pourquoi une vérification de port externe peut-elle expirer lorsque les deux serveurs se trouvent derrière la même passerelle pfSense ou SSL ?

Lorsqu'un serveur web et un serveur de messagerie partagent un pare-feu (par ex. pfSense, OPNsense ou HAProxy) sans Hairpin NAT (NAT Reflection), les paquets adressés depuis l'intérieur de la passerelle à votre propre IP WAN publique sont rejetés. Depuis la v1.2.4, nextxch détecte automatiquement les topologies de passerelle partagée par sondage à chemins séparés. Pour les clients LAN, il est recommandé de configurer des substitutions d'hôtes Split-DNS ou la Pure NAT Reflection.

Comment partager en toute sécurité un profil de configuration iPhone ou smartphone via WhatsApp ou Microsoft Teams ?

Sous Comptes & listes -> Configuration de l'appareil dans /admin/ (ou dans les paramètres du Webmail), nextxch génère un lien de page de configuration valable 24 heures (/onboarding/setup/{token}) adossé à un mot de passe d'application dédié par appareil. Les robots d'aperçu de WhatsApp, Teams, Telegram ou Slack ne consomment jamais le jeton, et les WebViews intégrées aux applications affichent une invite claire de passage à Safari afin qu'iOS installe proprement le profil .mobileconfig signé.

Quels sont les seuils SpamGuard recommandés en production ?

Conservez JunkThreshold à 4.5 (classe le courrier suspect dans Courrier indésirable) et RejectThreshold à 9.0 (rejet SMTP 550 ferme pour le spam manifeste), associés au greylisting intelligent (240 secondes sur les préfixes IPv4 /24 et IPv6 /64). Les MTA légitimes passent automatiquement le greylisting lors de la nouvelle tentative et sont mis en cache pendant 30 jours, ce qui évite les pertes de données dues aux faux positifs.

Quel moteur de base de données choisir : SQLite WAL, Microsoft SQL Server ou PostgreSQL 18 ?

Jusqu'à environ 250 boîtes aux lettres actives sur un seul hôte, SQLite WAL intégré offre des lectures en moins d'une milliseconde sans aucune maintenance de DBA. Les environnements Windows disposant déjà de Microsoft SQL Server (2019-2025, Express ou Azure SQL) bénéficient d'emblée du clustering multi-nœuds natif et de la recherche, tandis que les clusters Linux haute disponibilité profitent de PostgreSQL 18 LISTEN/NOTIFY.