v1.0.0 Manuale ufficiale · 5 gruppi tematici · 24 guide mirate

Documentazione nextxch

Manuale di riferimento organizzato in modo chiaro su installazione, DNS, sicurezza, groupware, automazione CLI e operatività: ogni guida mirata documenta i valori predefiniti esatti e le best practice per la produzione.

Primi passi

Da un host Windows, Linux o Docker appena installato fino alla matrice delle porte perimetrali.

Rete, DNS & crittografia

Recapitabilità 10/10 con FCrDNS/PTR, Dual-DKIM, IPv6, pfSense & Let's Encrypt DANE.

Trasporto posta & difesa

Coda SMTP, diagnostica MX live, SpamGuard ML, greylisting, ClamAV, Fail2Ban & un mail gateway a monte.

Client, groupware & CLI

Configurazione iPhone compatibile con i messenger, Outlook per Windows, calendario & contatti Webmail, chiavi API & CLI.

Cap. 10 →

Configurazione iPhone, mobile & WhatsApp

Gli utenti devono poter configurare posta, calendario, contatti e note su iOS e macOS in meno di 30 secondi, senza digitare porte né esporre le loro m...

Cap. 11 →

Webmail, calendario (CalDAV) & contatti

A differenza dei backend di posta limitati ai protocolli, nextxch include una Webmail PWA veloce e installabile (/mail/) con un calendario groupware completo (mese, settimana, g...

Cap. 12 →

Configurare Outlook per Windows

Microsoft Outlook per Windows si connette a nextxch tramite IMAP (in entrata) e SMTP (in uscita). Questo vale per Outlook classico (Microsoft 365 Apps, Out...

Cap. 13 →

nextxch-cli: comandi, query & IaC

Con nextxch-cli si gestiscono domini, caselle di posta, liste di distribuzione, alias, chiavi API con ambito, route SMTP in uscita (incl. override TLS), warming IP...

Cap. 13b →

Configuration as code (GitOps)

L'intero stato del server come file YAML in Git: tenant, domini (selettori DKIM, MTA-STS, routing), caselle di posta con alias, inoltro e risposta automatica...

Cap. 14 →

Schema degli oggetti API & CLI (tutti i campi)

Questo riferimento documenta ogni proprietà JSON, tipo di dato, valore enum, impostazione predefinita e ruolo RBAC minimo per tutti i 12 oggetti di gestione (/api/...

Cap. 15 →

Chiavi API, Send API & SSO

Le web app, gli strumenti di ticketing, i sistemi ERP e le pipeline CI/CD non dovrebbero mai condividere le password delle caselle di posta delle persone. In Chiavi API, SSO & regole (#pApiAuth), mi...

Cap. 16 →

LDAP, AD, Entra ID & SSO

In Admin > Fonti di identità si collega un tenant o singoli domini ad Active Directory o LDAP (accesso tramite bind, sincronizzazione degli utenti, gruppi annidati e...

Cap. 16a →

SSO Kerberos (accesso Windows)

Con Kerberos, i PC Windows nella rete aziendale accedono senza richiesta di password: Webmail e admin tramite SPNEGO ("Accedi con Windows"), Out...

Cap. 16b →

OAuth per Thunderbird, Outlook & CLI

nextxch è un proprio server di autorizzazione OAuth 2.1: le app di posta accedono nel browser tramite il normale login della webmail (incluse 2FA e passkey),...

Conformità, storage & operatività

Message Trace, archivio GoBD WORM, SQLite / SQL Server / PostgreSQL 18 & aggiornamenti.

Riferimento rapido: le 5 porte in ingresso necessarie

Inoltre, la porta TCP 25 in uscita deve essere aperta verso internet per il recapito MX diretto.

TCP 25ESMTP MX in entrata & in uscita
TCP 443HTTPS: Webmail, Admin, DAV, Push
TCP 465Invio client SMTPS (TLS)
TCP 587Submission (STARTTLS)
TCP 993Casella di posta IMAPS & push IDLE

Domande frequenti sull'operatività

Quali porte del firewall sono strettamente necessarie per nextxch?

Il funzionamento completo di posta, Webmail PWA, Mobile Push e CalDAV/CardDAV richiede 5 porte TCP in entrata: 25 (ESMTP MX in entrata), 443 (HTTPS per Webmail, Admin, JMAP, CalDAV/CardDAV & Mobile Push), 465 (SMTPS TLS implicito), 587 (Submission STARTTLS) e 993 (IMAPS). Le porte facoltative sono 80 (Let's Encrypt HTTP-01), 143 (IMAP STARTTLS), 4190 (ManageSieve) e 995 (POP3S) / 110 (POP3 STLS) se POP3 è attivato, più la porta TCP 25 in uscita verso Internet.

Perché un controllo esterno delle porte può andare in timeout quando entrambi i server si trovano dietro lo stesso pfSense o gateway SSL?

Quando un server web e un mail server condividono un firewall (ad esempio pfSense, OPNsense o HAProxy) senza Hairpin NAT (NAT Reflection), i pacchetti inviati dall'interno del gateway al proprio IP WAN pubblico vengono scartati. A partire dalla v1.2.4, nextxch rileva automaticamente le topologie con gateway condiviso tramite split-path probing. Per i client LAN si consiglia di configurare override host Split-DNS o Pure NAT Reflection.

Come condividere in sicurezza un profilo di configurazione per iPhone o smartphone tramite WhatsApp o Microsoft Teams?

In Account & liste -> Configurazione dispositivo in /admin/ (o nelle impostazioni di Webmail), nextxch genera un link a una pagina di configurazione valida 24 ore (/onboarding/setup/{token}) associato a una password per app dedicata per dispositivo. I crawler di anteprima di WhatsApp, Teams, Telegram o Slack non consumano mai il token e le WebView in-app mostrano un chiaro invito a passare a Safari, così iOS installa correttamente il profilo .mobileconfig firmato.

Quali sono le soglie SpamGuard consigliate per la produzione?

Mantenere JunkThreshold a 4.5 (sposta la posta sospetta in Spam) e RejectThreshold a 9.0 (rifiuto SMTP 550 definitivo per lo spam evidente), insieme allo Smart Greylisting (240 secondi su prefissi IPv4 /24 e IPv6 /64). Gli MTA legittimi superano automaticamente il greylisting al nuovo tentativo e vengono memorizzati in cache per 30 giorni, evitando perdite di dati dovute a falsi positivi.

Quale motore di database scegliere: SQLite WAL, Microsoft SQL Server o PostgreSQL 18?

Fino a ~250 caselle di posta attive su un singolo host, SQLite WAL integrato offre letture sotto il millisecondo senza alcuna manutenzione da parte di un DBA. Le realtà Windows con Microsoft SQL Server già in uso (2019-2025, Express o Azure SQL) ottengono clustering multi-nodo nativo e ricerca senza configurazioni aggiuntive, mentre i cluster Linux ad alta disponibilità beneficiano di PostgreSQL 18 LISTEN/NOTIFY.