YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Add / rework overview of the mail stack

Browse source
This commit is contained in:
Alexandre Aubin 2018-08-28 02:53:57 +02:00
parent 5db63d13f7
commit eec33a5688
2 changed files with 65 additions and 43 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
email.md Normal file
View file

@ -0,0 +1,39 @@
Emails
======
YunoHost comes with a complete mail stack allowing you to host your own email server, and therefore to have your own email addresses in `something@your.domain.tld`.
The mail stack includes a SMTP server (postfix), an IMAP server (Dovecot), an antispam (rspamd) and DKIM configuration.
Making sure your setup is right
-------------------------------
Mails are a complicated ecosystem and quite a lot of details can cause them to not work properly.
To validate that your setup is right :
- if you are self-hosting at home and not using a VPN, make sur [your ISP won't block port 25](isp) ;
- route ports according to [this documentation](isp_box_config) ;
- carefully configure mail DNS records according [this documentation](dns_config) ;
- test your setup using [Mail-tester.com](https://mail-tester.com) <small>(be careful : only 3 tests per domain per day are allowed)</small> ;
A score of at least 7~8/10 is a reasonnable goal.
Email clients
-------------
To interact with the email sever (read and send emails), you can either install a webclient such as Roundcube or Rainloop on your serveur - or configure a desktop/mobile client as described in [this page](email_configure_client).
Configuring email aliases and auto-forwards
-------------------------------------------
Mail aliases and forwards can be configured for each users. For instance, the first user created on the server automatically has an alias `root@the.domain.tld` configured - meaning that sending email to this adress will end in the inbox of this user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just want to receive emails from the server on, say, his/her gmail address.
What happens if my server becomes unavailable ?
-----------------------------------------------
If your server becomes unavailable, emails sent to your server will stay in a pending queue on the sender's side for as long as ~5 days. The sender's hoster will regularly try to resend the mail, until it drops it if it was unable to send it.
Migrating email from an email provider to a YunoHost instance
-------------------------------------------------------------
See [this page](email_migration).

69
email_fr.md
View file

@ -1,58 +1,41 @@
# Messagerie électronique
Emails
======
### Relever ses courriels
#### Le webmail Rouncube
Pour relever simplement ses [courriels](https://fr.wikipedia.org/wiki/Courrier_%C3%A9lectronique), le client webmail [Rouncube](https://roundcube.net/) est proposé dans YunoHost. Il est installable depuis l’interface d’administration :
YunoHost est livré avec un écosystème complet de serveur mail, vous permettant d'héberger votre propre serveur de messagerie, et donc d'avoir vos propres adresses email dans `quelquechose@votre.domaine.tld`.
<img src="/images/mailview.jpg" width=650>
Cet écosystème comprends un serveur SMTP (postfix), un serveur IMAP (Dovecot), un antispam (rspamd) et une configuration DKIM.
#### Client de messagerie alternatif
Vous pouvez également configurer un [client de messagerie indépendant](email_configure_client_fr), pour par exemple relever les messages de plusieurs adresses de courriel simultanément ou [relever vos courriels depuis un smartphone](email_configure_client_fr#Android)<!-- proposer plus de clients et rendre plus verbeux -->.
S'assurer que votre configuration est correcte
-------------------------------
#### Transférer ou migrer ses mails vers un autre serveur
Suivez [ce guide](email_migration_fr)<!-- à clarifier --> pour transférer vos mails sur votre serveur YunoHost en utilisant le protocole IMAP.
Les emails sont un écosystème compliqué et un grand nombre de détails peuvent les empêcher de fonctionner correctement.
### Configurations supplémentaires pour la messagerie
#### Configurer les DNS MX
Si vous avez opté pour un nom de domaine personnel, il est nécessaire de [configurer votre serveur DNS](/dns_config_fr)<!-- explication spécifique des DNS MX à ajouter sur cette page--> pour faire fonctionner la messagerie électronique.
Pour valider que votre configuration est correcte :
- si vous vous hébergez chez vous et n'utilisez pas de VPN, assurez-vous que [votre FAI ne bloque pas le port 25](isp) ;
- routez les ports selon [cette documentation](isp_box_config) ;
- configurez soigneusement les enregistrements DNS du courrier électronique selon [cette documentation](dns_config) ;
- Testez votre configuration en utilisant [Mail-tester.com](https://mail-tester.com) <small>(attention : seuls 3 tests par domaine et par jour sont autorisés)</small> ;
#### Ouverture des ports
Vérifiez également que les ports correspondant à la messagerie (n° 25, 587 et 993) sont bien ouverts au niveau de votre box ou de votre routeur. [Tutoriel d’ouverture des ports de la box](/isp_box_config_fr).
Un score d'au moins 7~8/10 est un but raisonnable.
#### Configurer l’authentification DKIM/SPF (facultatif)
Le protocole SMTP ne prévoit pas de mécanisme de vérification de l’expéditeur. Il est donc possible d’envoyer un courrier avec une adresse d’expéditeur factice ou usurpée. SPF et DKIM sont deux mécanismes possibles d’authentification de l’expéditeur d’un email. [Tutoriel pour configurer DKIM/SPF](dkim_fr).<!-- compliqué, à clarifier ? -->
Clients de messagerie
-------------
### Résolution de problèmes
#### Votre serveur est sur une liste noire…
Si les courriels envoyés à un type d’adresse spécifique (par exemple les adresses Gmail) n’arrivent pas à destination, votre serveur (son adresse IP) a peut être été ajouté à la liste noire du fournisseur d’adresse courriel en question. Pour résoudre ce problème voici les [formulaires de retrait des listes noires](blacklist_forms_fr).
Pour interagir avec le serveur de mail, c'est-à-dire lire et envoyer des emails, vous pouvez soit installer un client web comme Roundcube ou Rainloop sur votre serveur - ou configurer un client de bureau ou mobile comme décrit dans [cette page](email_configure_client).
#### Consulter les fichiers de log pour identifier le problème
De nombreux messages permettant d’identifier les problèmes se trouvent enregistrés dans les fichiers de log du système. Apprenez à les consulter, pour pouvoir mieux comprendre ce qui cloche et trouver de l’aide sur le forum ou le salon de support.
Configuration des alias de messagerie et des redirections automatiques
-------------------------------------------
<!-- ajouter une doc pour consulter ses logs des services mail -->
Des alias de messagerie et des redirections peuvent être configurés pour chaque utilisateur. Par exemple, le premier utilisateur créé sur le serveur dispose automatiquement d'un alias `root@votre.domaine.tld` - ce qui signifie qu'un email envoyé vers cette adresse se retrouvera dans la boîte de réception de cet utilisateur. Les redirections automatiques peuvent être configurées, par exemple si un utilisateur ne veut pas configurer un compte de messagerie supplémentaire et souhaite simplement recevoir des courriels du serveur sur, disons, son adresse gmail.
#### Je suis capable de recevoir mais pas d'envoyer des mails
Que se passe-t-il si mon serveur devient indisponible ?
-----------------------------------------------
Cela peut être dû au fait que le port 25 est fermé, et que votre fournisseur d'accès internet ne vous permet pas de l'ouvrir (pour lutter contre le spam)...
Si votre serveur devient indisponible, les courriels envoyés à votre serveur resteront dans une file d'attente du côté de l'expéditeur pendant environ 5 jours. L'hébergeur de l'expéditeur tentera régulièrement de renvoyer le courrier, jusqu'à ce qu'il le jette s'il n'a pas pu l'envoyer.
Une solution de contournement consiste, soit à utiliser un VPN (ce qui nécessitera un abonnement chez un fournisseur, et de configurer l'app vpnclient), soit à utiliser un relai SMTP.
Attention : dans le cas d'un relai SMTP, ***la personne ou l'organisme qui possède le relai sera techniquement très facilement capable de lire tout mail non-chiffré transitant entre votre serveur et le reste d'Internet ! Vous lui faites donc confiance à propos de toute information personelle ou critique que pourrait contenir vos mails !***
Pour aller plus loin
--------------------
Pour mettre en place le relai SMTP, il faut modifier le fichier `/etc/postfix/main.cf`.
Chercher la ligne contenant `relayhost = ` et la remplacer par `relayhost = smtp.<nom-du-fai>.tld`. Par exemple: `relayhost = smtp.free.tld`.
Si la ligne n'existe pas ajouter la ligne à la fin du fichier.
**Plus d'informations**
- https://yunohost.org/#/isp_fr
- https://yunohost.org/#/isp_orange_fr
- https://yunohost.org/#/isp_sfr_fr
- https://yunohost.org/#/isp_free_fr
### Aller plus loin
La messagerie électronique est basée sur les protocoles SMTP pour l’envoi de mail et IMAP (ou anciennement POP3) pour la récupération des messages depuis un serveur. En arrière-plan, YunoHost fournit :
* [Postfix](http://www.postfix.org) en tant que serveur SMTP.
* [Dovecot](http://www.dovecot.org) pour le serveur IMAP.
* [Rspamd](https://rspamd.com) logiciel antispam, filtrant les messages indésirables.
Pour approfondir votre compréhension du courriel et de ses protocoles, voici une [conférence éclairante](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/index.html)(en français).
- Il existe une page de documentation pour [migrer ses emails d'un fournisseur de messagerie vers une instance YunoHost](email_migration).
- Pour approfondir votre compréhension du courriel et de ses protocoles, voici une [conférence éclairante](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/index.html)(en français).