Rspamd中Multimap模块附件文件名匹配失效问题分析

问题现象

在使用Rspamd 3.11.1版本时，发现multimap模块无法正确匹配邮件附件文件名中的关键词。具体表现为：

• 配置了基于正则表达式的文件名匹配规则
• 测试发送包含"abcdefg.txt"附件的邮件
• 日志显示规则未能触发匹配（返回nil值）

配置分析

典型的错误配置示例如下：

MARK_ATTACHED_CHEAK {
    type = "filename";
    filter = regexp:/re/;  # 问题根源
    map = "${LOCAL_CONFDIR}/local.d/maps.d/attached.map";
    prefilter = true;
    description = "cheak attached";
    regexp = true;
    score = 10.0;
}

其中attached.map文件内容包含正则表达式规则如/def/u。

根本原因

问题核心在于filter = regexp:/re/这行配置：

1. 该配置会强制将附件文件名与字面值"/re/"进行匹配
2. 导致实际的正则表达式规则/def/u完全被忽略
3. 日志中可见abcdefg.txt -> nil的转换结果，表明过滤环节已失效

解决方案

正确的配置应该完全移除filter参数：

MARK_ATTACHED_CHEAK {
    type = "filename";
    map = "${LOCAL_CONFDIR}/local.d/maps.d/attached.map";
    prefilter = true;
    description = "cheak attached";
    regexp = true;  # 启用正则匹配
    score = 10.0;
}

技术原理

Rspamd multimap模块的工作流程：

1. 根据type字段确定检查目标（此处为filename）
2. 当regexp=true时，自动将map文件内容作为正则表达式处理
3. 无需额外filter即可直接匹配目标内容
4. filter参数仅用于特殊情况下的值转换

最佳实践建议

1. 对于简单匹配场景，避免使用filter参数
2. 正则表达式应直接写入map文件
3. 调试时可检查日志中的"->"转换结果
4. 确保map文件权限正确（通常需要rspamd用户可读）
5. 复杂匹配需求可考虑使用composite规则组合多个条件

总结

Rspamd的multimap模块在正确配置下能够有效匹配附件文件名。关键是要理解各参数的实际作用，避免不必要的过滤设置。通过移除错误的filter配置，即可实现预期的正则表达式匹配功能。