Roundcube 网页邮件:自建邮件服务的 SPF、DKIM 与 DMARC

Roundcube 本身不做任何邮件认证。弄清 SPF、DKIM、DMARC 真正生效的层级,正确配置带认证的 SMTP 提交,避开 localhost 中继的坑。
4 分钟阅读
更新于 2026-11-04
平台专区
roundcubespfdkimdmarc网页邮件

Roundcube 是一个 PHP 应用:用 IMAP 读信,用 SMTP 发信。它没有签名引擎,不发布 DNS 记录,也不参与任何认证判断。凡是在 Roundcube 里写出的邮件,其 SPF、DKIM、DMARC 结果都来自它背后的 MTA(Postfix、Exim 或别的),以及你为域名发布的 DNS 记录。

分清这一点,大部分"Roundcube 送达率问题"就迎刃而解了。管理员在网页邮件的设置里翻找一个根本不存在的 DKIM 开关,而真正的故障点在 MTA 配置或提交路径上。本文把配置放回它该在的层级。

准备工作

  • 一台已经在为你的域名发信的 MTA,以及供 Roundcube 读取的 Dovecot 或其他 IMAP 服务。
  • From 地址所用域名的 DNS 管理权限。
  • Roundcube 1.5 或 1.6,且能修改 config/config.inc.php。
  • 一个允许在 587 端口提交邮件的邮箱账号。

认证究竟发生在哪一层

三个层次,三个负责人:

  • DKIM 签名发生在 MTA,通常由 OpenDKIM、rspamd 或 Exim ACL 完成。Roundcube 只负责把邮件交出去。
  • SPF由接收方针对"向它发起 SMTP 连接的那个 IP"评估——是你服务器的公网 IP,不是浏览器的。
  • DMARC是接收方套用前两项结果、并与 Roundcube 写入的 From 头比对的一条 DNS 策略。

所以 Roundcube 这一侧要做的事很少:让邮件通过带认证的提交路径进入 MTA,并保证 From 域名与你签名、授权的域名一致。其余都在服务器上。如果你的 MTA 是 Postfix,milter 与密钥配置见 Postfix SPF、DKIM 与 DMARC 指南。

第一步:确认 MTA 确实在签名

改 Roundcube 之前,先证明服务器本身会签名。在服务器上用 swaks 发一封,检查信头里有没有 DKIM-Signature 字段。没有就先去修 milter——网页邮件这边再怎么改也补不上。

swaks --to you@gmail.com --from you@yourdomain.com --server 127.0.0.1:587 --auth LOGIN --auth-user you@yourdomain.com --tls

OpenDKIM 还可以直接测密钥:opendkim-testkey -d yourdomain.com -s mail -vvv。没有任何输出,说明密钥与 DNS 记录一致。

第二步:发布 DNS 记录

网页邮件场景真正相关的只有两条记录,且都是按域名发布一次,而不是每个邮箱一条:

yourdomain.com         TXT  "v=spf1 ip4:203.0.113.10 a mx ~all"
mail._domainkey.yourdomain.com  TXT  "v=DKIM1; k=rsa; p=MIIBIjANBg..."
_dmarc.yourdomain.com  TXT  "v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com"

SPF 里必须列出邮件真正离开网络时用的 IP。如果 Postfix 交给 smarthost 中继,还要把该服务商的 include 域加进来,并要求它保留你的信封发件人,或用 SRS 重写。用 SPF 检测和 DKIM 检测核对,selector 填 MTA 实际使用的值。

第三步:走认证 SMTP 提交,不要走 localhost

这一步决定网页邮件发出去的信是否被正确认证。Roundcube 的默认配置常指向 localhost 的 25 端口,等于不做认证直接把邮件塞进本机 MTA。平时看不出问题,一旦 MTA 向外中继、对未认证邮件另作处理,或改写信封发件人,SPF 就会失败、对齐就会断,而且很难定位。

改成 587 端口 + TLS + 用户本人凭据:

$config['smtp_host'] = 'tls://mail.yourdomain.com';
$config['smtp_port'] = 587;
$config['smtp_user'] = '%u';
$config['smtp_pass'] = '%p';
$config['smtp_helo_host'] = 'mail.yourdomain.com';

%u 与 %p 会传入当前登录用户的凭据,每封邮件都以该邮箱身份通过认证,而不是靠"来自本机"被信任。显式设置 HELO 主机名,可以让它与 PTR 记录保持一致。若用 465 端口的隐式 TLS,把前缀改为 ssl://、端口改为 465。

第四步:发布 DMARC,盯住对齐

签名和 SPF 就位后,先上监控策略。p=none 不拦截任何邮件,只要求接收方回传聚合报告:

v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com; fo=1

报告会显示经网页邮件发出的信是否对齐。常见情况是 DKIM 通过了但对齐失败:用户在下拉里选了别的域名的发件身份,或者插件在签名后改写了 From。用 DMARC 报告分析器读 XML,确认所有正常来源都通过后,再逐步收紧到 quarantine 与 reject。不想手写记录可以用 DMARC 生成器。

验证一封网页邮件

从 Roundcube 发到你自己的 Gmail,打开显示原始邮件。目标是 spf=pass、dkim=pass(d= 为你的域名)、dmarc=pass。认证结果不好读时,把完整信头贴进 邮件头分析;想要域名级的整体视图,跑一次 邮件投递测试。

常见错误

  1. 不做认证直接走 localhost 中继。没有提交检查、没有按用户追责,一旦经 smarthost 转发 SPF 立刻失败。
  2. 用 25 端口提交。很多主机商封锁该端口,而且它完全绕过了认证路径。应当用 587 + STARTTLS。
  3. 用未签名的域名别名发信。Roundcube 的身份功能允许用户任选 From 地址;该域名不在 SigningTable 里,DMARC 就对它失败。
  4. 让插件用 PHP mail() 发信。这类邮件根本不会经过 milter,出去时没有签名。
  5. 在 Roundcube 里找 DKIM 设置。没有这样的设置。该修的是 MTA 或 DNS 区域。

常见问题

Roundcube 需要单独配 SPF 记录吗?

不需要。SPF 授权的是域名的发信 IP,不是某个应用。记录放在域名根下,覆盖所有为它发信的服务器,包括跑 Roundcube 的这台。

为什么邮件客户端发信正常,网页邮件却 SPF 失败?

基本都是出口路径不同。桌面客户端认证到 587,从你的服务器出去;配置不当的 Roundcube 从 localhost 注入,MTA 可能再经 smarthost 转发,而那个 IP 不在 SPF 里。对比两封邮件的 Received 头即可确认。

Roundcube 能自己做 DKIM 签名吗?

原生不支持,也没有值得长期维护的插件。签名应当放在邮件离开基础设施的那一层,这样定时任务、邮件列表、网站表单发的信才能享受同样待遇。

只用网页邮件,也需要 DMARC 吗?

需要。网页邮件只是邮件离开域名的途径之一,接收方无法判断邮件是怎么写出来的。DMARC 防的是别人伪造你用户登录的那个域名。

这篇指南有帮助吗?