Ansible 角色: Dovecot

Dovecot 是一款开源的 IMAP 邮件服务器，适用于 Linux/UNIX 类系统，以安全性为主要考虑。

该角色是 Mailserver 项目的一部分。Dovecot 用作 Postfix 的虚拟邮件传输和 IMAP 服务器。

配置

dovecot_hostname

运行邮件服务器的主机的完全限定域名（FQDN）。此域名不允许列入虚拟域名。默认值为 Ansible facts 中的主机名 ansible_fqdn。

dovecot_default_mysql

主邮件数据库的 MySQL 凭据。此配置选项在 policy_source 不同于 mysql 时被忽略。

dovecot_mysql:
  host: "127.0.0.1"
  port: 3306
  user: "dovecot"
  password:
  database: "mail"

dovecot_config

抽象出 Dovecot 特定的配置选项。

listen

要监听的网络地址列表。默认值为所有可用的 IPv4 和 IPv6 地址 ["*", "[::]"]。

policy_source

在不同的策略源之间切换。目前只有 mysql 是支持的源。关于使用的方案的信息可以在 mailserver.mysql-seed 仓库中找到。

vmail

键	默认值	描述
user	vmail	邮件目录的虚拟拥有者
group	vmail	邮件目录的虚拟组
directory	/var/mail	邮件目录的存储位置

auth

键	默认值	描述
listen	["inet", "unix"]	监听网络或本地 Unix 套接字
inet	{ address: '[::1]', port: 10026 }	认证服务的接口和监听端口
unix		Unix 套接字的路径和设置

lmtp

键	默认值	描述
listen	["inet", "unix"]	监听网络或本地 Unix 套接字
inet	"{ address: '[::1]', port: 10025 }"	lmtp 服务的接口和监听端口
unix		Unix 套接字的路径和设置

阅读更多: http://wiki.dovecot.org/LMTP

ssl

SMTP 的加密设置。用于通过 StartTLS 在提交端口（587）上的客户端连接和服务器到服务器的连接。

默认的证书和密钥路径指向 Letsencrypt。如果不可用，将自动生成 2048 位的 Diffie-Hellman 参数。

键	默认值	描述
key	/etc/letsencrypt/live/{{ dovecot_hostname }}/privkey.pem	PEM 格式的 SSL 密钥路径
certificate	/etc/letsencrypt/live/{{ dovecot_hostname }}/fullchain.pem	PEM 格式的 SSL 证书（链）路径
dhparams.length	2048	Diffie-Hellman 参数的大小
dhparams.file	/etc/ssl/postfix_dhparams.pem	Diffie-Hellman 参数文件的路径

managesieve_enabled

启用基于用户的 Sieve 和 Managesieve 配置。默认情况下启用。

config_dir

Dovecot 配置存储的文件夹。大多数操作系统的默认值为 /etc/dovecot。

示例

Dovecot IMAP 启用 TLS 和 2048 位 Diffie-Hellman 参数，使用 MySQL 后端

- role: mailserver.dovecot
  dovecot_hostname: "imap.example.com"
  dovecot_config:
    ssl:
      certificate: "/etc/letsencrypt/live/imap.example.com/fullchain.pem"
      key: "/etc/letsencrypt/live/imap.example.com/privkey.pem"
      dhparam:
        size: 2048
  dovecot_mysql:
    host: '127.0.0.1'
    user: 'dovecot'
    password: 'correct horse battery staple'
    database: 'maildb'