编程 Rspamd greylist 没生效时查什么:servers 前提、同名 action、两个 hash 与 timeout/expire

2026-11-19 00:05:19

Rspamd greylist 没生效时查什么:servers 前提、同名 action、两个 hash 与 timeout/expire

范围限定在 greylist 模块本身:启用前提、greylist 模块与 greylist action 的同名区分、Redis 里两个 hash 的键构成,以及 timeout / expire 两个时间参数。score 与 action 的归属见站内 #8410;BAYES 的 min_learns 见 #8414。

现象

Rspamd 灰名单(greylisting)最常见的两个问题:

  1. 在 local.d/greylist.conf 里写了 enabled = true,但 History 里一个 GREYLIST 都没有,邮件照常进来。
  2. 反过来,把 enabled = false 写进去了,History 的 action 列还是显示 greylist,以为没关掉。

维护者 fatalbanana 在 rspamd issue #3412 里给过原话:greylist action is not greylisting; rather it's functionally the same as no action。以及 greylist module does not work without configuration。

一个名字,两个东西

  • greylist 模块:真正做延迟投递,需要 Redis。
  • greylist action:actions 里的分数区间名字,只表示 score 落在这个区间。它本身等同于 no action,不触发任何延迟。

所以 History 上看到 action=greylist,只说明这封信的分数到了 4 分这个档,不代表模块在工作。

模块启用的硬前提:Redis servers

官方模块文档:Adding servers to store greylisting data enables greylisting in Rspamd。只写 enabled = true 不够,必须有 servers。

# /etc/rspamd/local.d/greylist.conf
servers = "127.0.0.1:6379";

没有 Redis 连接时模块什么都不做,也不报错。grommunio 文档写得很直白:Both modules store their state in Redis and do nothing without a Redis connection。

数据结构:两个 hash,两段时间

每条待灰名单的消息在 Redis 里存两个 hash:

  • meta hash:from : to : ip 三元组
  • data hash:取报文正文(长度足够时),max_data_len 默认 10k

IP 不是原样存:IPv4 默认 /19 掩码,IPv6 默认 /64。这意味着同一个 /19 里不同发信 IP 共享一条灰名单状态。好处是发信方多出口 IP 轮换、NAT 池不会每次都当新发信人;代价是同一 /19 内的干净 IP 会被一起牵连。要精确到单 IP 就设 ipv4_mask = 32,代价是 Redis 键数量上涨。

两个时间别混:

  • timeout:灰名单窗口,默认 5min。首次到达的软拒后多久重试接受。
  • expire:hash 在 Redis 的存活时间,默认 1d。这才是 Redis 容量的决定项。

有人照抄网上配置写 expire = 365d,等于把每条发信三元组留一年;邮件量大的实例 Redis 内存会持续上涨。改之前先按日均新三元组数量估一遍。

触发条件

模块文档的表述是:延迟 spam score 高于 greylisting action 阈值的邮件。也就是说阈值在 actions.conf 的 greylist 项上(上游默认 4,不同打包版可能不同,用 rspamadm configdump actions 核对)。greylist_min_score 这个老参数仍列在文档里,默认 unset;两处阈值同时出现最容易配歪,改完一定 dump 一遍生效值。

误杀来自哪里

不重试的发信方是主要来源:验证码、告警通知、Web 应用里同步调用 SMTP 的业务代码,被 4xx 软拒后不会重发,信就没了。MTA 是否重试决定灰名单是否安全,这跟 Rspamd 的判定对错无关。

放行手段:

  • whitelisted_ip:IP 或网段。
  • whitelist_domains_url:域名白名单,默认配置指向 local.d/greylist-whitelist-domains.inc 与 maps.d 下同名文件,按 eSLD 向上回退匹配。
  • whitelist_symbols(1.9.1 起):命中特定符号时跳过灰名单。

也可以在 settings 模块里直接关掉 GREYLIST_CHECK / GREYLIST_SAVE 两个符号,按来源条件选择性关闭。

排查顺序

rspamadm configdump greylist     # 看 enabled、servers、timeout、expire、掩码
rspamadm configdump actions      # 看 greylist 阈值
rspamadm configtest
rspamc stat | grep -Ei 'greylist|soft reject|reject'

rspamc stat 里的 greylist / soft reject 计数为 0 时,先确认 servers 生效,再确认发信测试邮件的分数确实过了阈值。

Redis 侧核对:

redis-cli --scan --pattern 'rg*' | head

key_prefix 默认 rg,能看到键才说明模块真的在写。

部署注意

docker-mailserver v12 的默认配置里,greylist 与 clickhouse、elastic、neural、reputation、spamassassin、url_redirector、metric_exporter 一起被禁用,理由是不必占用资源。用这类镜像时要自己开,别以为改了分数阈值就会生效。

关闭:local.d/greylist.conf 写 enabled = false。关掉后 History 里的 greylist 标签仍可能出现,那是 action 区间,不是模块。

项目与文档

推荐文章

程序员茄子在线接单