Dovecot 是 Linux 平台上最流行的开源 IMAP/POP3 邮件服务器软件之一，负责处理邮件的接收读取环节，通常与 Postfix 搭配组成完整的邮件系统。Postfix 管 SMTP 发信，Dovecot 管收信和认证，两者配合才能构成一台功能完整的邮件服务器。这篇文章将以 CentOS/Ubuntu 系统为例，完整演示 Dovecot 的安装与配置流程，并附上常见问题的排查方法。
一、安装 Dovecot
安装过程比较简单，两个主流发行版各有一条命令即可完成。CentOS/RHEL 系统使用 yum 或 dnf 安装，Ubuntu/Debian 系统使用 apt 安装。安装前建议先更新一下软件源，避免拿到过老的版本。
在 CentOS 上执行：
yum install dovecot -y
在 Ubuntu 上执行：
apt update && apt install dovecot -y
安装完成后可以用 dovecot --version 命令查看版本号，确认安装成功。然后执行 systemctl start dovecot 启动服务，再执行 systemctl enable dovecot 设置开机自启。如果启动没有报错，说明基础环境已经就绪。
二、主配置文件 dovecot.conf 详解
Dovecot 的主配置文件位于 /etc/dovecot/dovecot.conf，各个功能模块的配置分散在 /etc/dovecot/conf.d/ 目录下的多个文件中，主配置文件负责加载它们。先打开主配置文件，找到 protocols 这一行，确定要启用的协议。常见写法如下：
protocols = imap pop3 lmtp
这一行表示同时启用 IMAP、POP3 和 LMTP 三种协议。如果你只用 IMAP，写成 protocols = imap 即可。接下来是监听设置，找到 listen 参数：
listen = *
星号表示监听所有网卡的 IPv4 地址。如果服务器需要支持 IPv6，可以写成 listen = *, ::。这个参数如果漏配，可能出现服务启动了但外部连不上的情况。
另外一个值得关注的参数是 login_trusted_networks，它控制允许登录的来源网段。如果只想让内网特定网段访问，可以在这里限制，提升安全性。
三、邮件存储格式与路径配置
邮件存储位置在 /etc/dovecot/conf.d/10-mail.conf 文件中设置，核心参数是 mail_location。Dovecot 支持两种主流存储格式：mbox 和 Maildir。mbox 把所有邮件放在一个文件里，历史悠久但不适合大邮箱；Maildir 采用一封邮件一个文件的目录结构，性能和安全性更好，是目前的推荐方案。
使用 Maildir 格式的写法：
mail_location = maildir:~/Maildir
这表示每个用户的邮件存放在其家目录下的 Maildir 目录中。如果系统用户就是邮箱用户，这样配置即可直接生效。如果邮件存储在 /var/mail 目录下使用 mbox 格式，则写成 mail_location = mbox:~/mail:INBOX=/var/mail/%u。
同时注意 mail_privileged_group 参数。如果邮件目录的属组是 mail，需要设置为 mail_privileged_group = mail，否则普通用户可能没有权限读取自己的邮件。
四、认证配置：让用户能正常登录
认证部分在 /etc/dovecot/conf.d/10-auth.conf 中配置。首先是禁用明文登录，找到 disable_plaintext_auth 参数，默认值是 yes，也就是不允许明文密码登录，这个默认值建议保留，前提是配置好 SSL。
接着看认证机制，auth_mechanisms 参数决定支持的登录方式：
auth_mechanisms = plain login
plain 和 login 是绝大多数邮件客户端都支持的机制，通常这样配置就能满足 Outlook、Foxmail、Thunderbird 等客户端的需要。
用户来源方面，默认配置文件末尾有一行 !include auth-system.conf.ext，表示使用系统用户作为邮箱账号。如果希望用数据库管理虚拟用户，需要注释掉这行，改用 auth-sql.conf.ext 或 auth-passwdfile.conf.ext。使用 MySQL 对接时，需要安装 dovecot-mysql 组件，并在 /etc/dovecot/dovecot-sql.conf.ext 中配置数据库连接信息、密码查询语句等。
五、SSL 加密配置
SSL 配置在 /etc/dovecot/conf.d/10-ssl.conf 文件中。默认参数 ssl = required 表示强制加密，这是安全的默认设置。证书路径配置如下：
ssl_cert = </etc/pki/dovecot/certs/dovecot.pem
ssl_key = </etc/pki/dovecot/private/dovecot.pem
这里的尖括号是 Dovecot 配置语法的一部分，表示从文件读取内容。生产环境建议替换成正式的 SSL 证书，比如 Let's Encrypt 免费证书，路径指向实际的证书文件即可。配置完成后重启 Dovecot 服务使设置生效：
systemctl restart dovecot
六、常见问题与排查思路
问题一：客户端登录提示认证失败。 先执行 doveadm user 用户名 查看该用户的邮件路径是否能正确解析，再用 telnet 127.0.0.1 143 手动测试 IMAP 连接，输入 a login 用户名 密码 观察返回信息。如果认证失败，检查 10-auth.conf 中的用户来源配置是否正确，虚拟用户还要确认 SQL 查询语句能否返回结果。
问题二：端口连不上。 用 ss -tlnp | grep dovecot 检查 143、993、110、995 端口是否处于监听状态。如果没监听，回头看主配置文件中的 protocols 和 listen 参数。另外检查防火墙是否放行了对应端口，CentOS 用 firewall-cmd --list-ports 查看，云服务器还要在控制台的安全组中放行。
问题三：日志不知道去哪看。 Dovecot 日志默认走 syslog，可以在 /var/log/maillog 或 /var/log/mail.log 中找到。排查时也可以临时把日志级别调高，在配置中加入 auth_verbose = yes 和 mail_debug = yes，重启后日志会详细很多，排查完记得关掉。
问题四：权限报错。 日志中出现 Permission denied 时，通常是邮件目录属主不对。确认 Maildir 目录的所有者是对于用户，权限建议为 700。使用 mail_privileged_group = mail 也能解决大部分权限问题。
七、验证配置是否生效
完成全部配置后，推荐使用 Dovecot 自带的检查工具验证语法：执行 doveconf -n 可以输出当前生效的配置项，方便核对；执行 doveadm auth test 用户名 密码 可以直接测试认证是否通过。两项都没有报错，再用邮件客户端实际收发一次，如果能看到邮件列表，说明整个 Dovecot 配置已经成功跑通。
最后提醒一点，邮件服务器搭建完不要忘记配置 DNS 的 MX 记录和 SPF、DKIM 等反垃圾邮件记录，否则发出的邮件很容易被对方判为垃圾邮件。Dovecot 本身只负责收信，这些周边配置同样影响整套系统的可用性。
dovecot配置教程dovecot安装Linux邮件服务器修改时间：2026-09-13 13:36:35