secubox-openwrt/package/secubox/secubox-app-mailserver/README.fr.md
CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)
Add complete French (fr) and Chinese (zh) translations for all documentation:

- Root files: README, CHANGELOG, SECURITY, BETA-RELEASE
- docs/: All 16 core documentation files
- DOCS/: All 19 deep-dive documents including embedded/ and archive/
- package/secubox/: All 123+ package READMEs
- Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/

Total: 346 translation files created

Each file includes language switcher links for easy navigation between
English, French, and Chinese versions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-20 10:00:18 +01:00

5.5 KiB

SecuBox Mail Server

Languages: English | Francais | 中文

Serveur de messagerie personnalise (Postfix + Dovecot) fonctionnant dans un conteneur LXC avec support de sauvegarde mesh.

Fonctionnalites

  • Postfix - Serveur SMTP avec domaines virtuels
  • Dovecot - IMAP/POP3 avec livraison LMTP
  • Rspamd - Filtrage anti-spam
  • OpenDKIM - Signature des emails
  • Sauvegarde mesh - Synchronisation de sauvegarde P2P avec d'autres noeuds SecuBox
  • Integration webmail - Fonctionne avec le conteneur Roundcube

Installation

opkg install secubox-app-mailserver

Demarrage rapide

# 1. Configurer le domaine
uci set mailserver.main.domain='example.com'
uci set mailserver.main.hostname='mail'
uci commit mailserver

# 2. Installer le conteneur
mailctl install

# 3. Configurer les enregistrements DNS (MX, SPF, DMARC)
mailctl dns-setup

# 4. Obtenir le certificat SSL
mailctl ssl-setup

# 5. Ajouter des utilisateurs de messagerie
mailctl user add user@example.com

# 6. Activer et demarrer
uci set mailserver.main.enabled=1
uci commit mailserver
/etc/init.d/mailserver start

# 7. Configurer le webmail
mailctl webmail configure

Reference CLI

Controle du service

mailctl start      # Demarrer le serveur de messagerie
mailctl stop       # Arreter le serveur de messagerie
mailctl restart    # Redemarrer le serveur de messagerie
mailctl status     # Afficher le statut

Gestion des utilisateurs

mailctl user add user@domain.com    # Ajouter un utilisateur (demande le mot de passe)
mailctl user del user@domain.com    # Supprimer un utilisateur
mailctl user list                   # Lister tous les utilisateurs
mailctl user passwd user@domain.com # Changer le mot de passe

Alias

mailctl alias add info@domain.com user@domain.com
mailctl alias list

Certificats SSL

mailctl ssl-setup    # Obtenir le certificat Let's Encrypt via DNS-01
mailctl ssl-status   # Afficher les informations du certificat

Integration DNS

mailctl dns-setup    # Creer les enregistrements MX, SPF, DMARC via dnsctl

Sauvegarde mesh

mailctl mesh backup              # Creer une sauvegarde pour la synchronisation mesh
mailctl mesh restore <fichier>   # Restaurer depuis une sauvegarde
mailctl mesh sync push           # Pousser vers les peers mesh
mailctl mesh sync pull           # Tirer depuis les peers mesh
mailctl mesh add-peer <peer_id>  # Ajouter un peer mesh
mailctl mesh peers               # Lister les peers configures
mailctl mesh enable              # Activer la synchronisation mesh
mailctl mesh disable             # Desactiver la synchronisation mesh

Webmail

mailctl webmail status      # Verifier le statut de Roundcube
mailctl webmail configure   # Pointer Roundcube vers ce serveur

Diagnostics

mailctl logs         # Voir les logs de messagerie (50 dernieres lignes)
mailctl logs 100     # Voir les 100 dernieres lignes
mailctl test user@external.com   # Envoyer un email de test

Configuration UCI

config mailserver 'main'
    option enabled '0'
    option hostname 'mail'
    option domain 'example.com'
    option postmaster 'postmaster'
    option data_path '/srv/mailserver'
    option container 'mailserver'

config ports 'ports'
    option smtp '25'
    option submission '587'
    option smtps '465'
    option imap '143'
    option imaps '993'
    option pop3 '110'
    option pop3s '995'

config features 'features'
    option spam_filter '1'
    option virus_scan '0'
    option dkim '1'
    option spf '1'
    option dmarc '1'
    option fail2ban '1'

config ssl 'ssl'
    option type 'letsencrypt'

config webmail 'webmail'
    option enabled '1'
    option container 'secubox-webmail'
    option port '8026'

config mesh 'mesh'
    option enabled '0'
    option backup_peers ''
    option sync_interval '3600'

Structure des donnees

/srv/mailserver/
├── config/          # Configuration Postfix/Dovecot
│   ├── vmailbox     # Carte des boites virtuelles
│   ├── valias       # Carte des alias virtuels
│   └── users        # Base de donnees utilisateurs Dovecot
├── mail/            # Stockage Maildir
│   └── example.com/
│       └── user/
│           ├── cur/
│           ├── new/
│           └── tmp/
└── ssl/             # Certificats SSL
    ├── fullchain.pem
    └── privkey.pem

Enregistrements DNS requis

La commande mailctl dns-setup cree ces enregistrements via dnsctl :

Type Nom Valeur
A mail <ip-publique>
MX @ 10 mail.example.com.
TXT @ v=spf1 mx a:mail.example.com ~all
TXT _dmarc v=DMARC1; p=none; rua=mailto:postmaster@example.com
TXT mail._domainkey v=DKIM1; k=rsa; p=<cle-publique>

Ports

Port Protocole Description
25 SMTP Transfert de courrier (serveur a serveur)
587 Submission Soumission de courrier (client a serveur)
465 SMTPS SMTP securise
143 IMAP Acces au courrier
993 IMAPS IMAP securise
110 POP3 Telechargement du courrier (optionnel)
995 POP3S POP3 securise (optionnel)
4190 Sieve Regles de filtrage du courrier

Dependances

  • lxc - Runtime de conteneur
  • secubox-app-dns-provider - Gestion des enregistrements DNS
  • acme - Automatisation des certificats SSL (optionnel)
  • secubox-p2p - Synchronisation de sauvegarde mesh (optionnel)