尧图网站建设 
即时通讯后端前端【免费下载链接】roundcubemailThe Roundcube Webmail suite项目地址https://gitcode.com/gh_mirrors/ro/roundcubemail点击查看免费下载导读MarkAsJunk 是 Roundcube Webmail 官方插件体系中负责标记为垃圾/非垃圾的核心组件它向邮件工具栏或标记菜单注入 spam/ham 按钮并将选定邮件移动到 Junk垃圾箱或收件箱同时通过可插拔的学习驱动Learning Driver把被标记的邮件交给 SpamAssassinsa-learn、DSPAM 等外部反垃圾系统进行训练。本文将基于 plugins/markasjunk/README.md 的完整内容结合 插件主文件、配置文件模板、drivers 目录 及 测试用例 的源码证据带你从零完成插件的启用、配置、驱动选型与自定义驱动开发。插件能做什么两种场景下的消息流转从 markasjunk.php 的插件头注释与 README 可以看出插件的核心行为由当前所在邮箱决定不在 Junk 邮箱时把选中的消息移动到 Junk 邮箱并标记为已读SEEN同时打上 Junk 标志、清除 NonJunk 标志。在 Junk 邮箱时按钮自动切换为标记为非垃圾 / 此消息不是垃圾邮件mark as not spam/this message is not spam消息被移回收件箱默认INBOX清除 Junk 标志并打上 NonJunk 标志。插件只在mail任务下生效public $task mail见 markasjunk.php并注册了plugin.markasjunk.junk与plugin.markasjunk.not_junk两个动作markasjunk.php统一由mark_message()处理。按钮的呈现位置有两种选择默认放在主工具栏markasjunk_toolbar true也可以关闭该选项改为在标记菜单markmenu中出现菜单项见 markasjunk.php。安装与基础配置配置文件默认配置模板位于 plugins/markasjunk/config.inc.php.dist使用方式与 Roundcube 其他插件一致将config.inc.php.dist复制为config.inc.php按需修改参数——README 明确说明所有配置参数都是可选的。插件通过load_config()读取该文件markasjunk.php并额外支持按邮件主机mail host加载专属配置。基础行为参数以下参数控制消息移动、标志与界面均来自 config.inc.php.dist参数默认值作用markasjunk_ham_mboxnull即INBOX标记为 ham 后消息移动到的邮箱设为false可禁用移动markasjunk_spam_mboxnull即 Roundcube 设置中指定的垃圾邮件文件夹junk_mbox标记为 spam 后消息移动到的邮箱设为false可禁用移动markasjunk_read_spamfalse标记为 spam 时是否同时标记为已读markasjunk_unread_hamfalse标记为 ham 时是否同时标记为未读markasjunk_spam_flagJunk标记为 spam 时附加的 IMAP 标志标记为 ham 时移除设为false关闭标志markasjunk_ham_flagNonJunk标记为 ham 时附加的 IMAP 标志标记为 spam 时移除设为false关闭标志markasjunk_toolbartruetrue在工具栏显示按钮false则改用标记菜单markasjunk_move_spamfalse任何被移入垃圾箱的消息都作为 spam 学习不仅是点击按钮时markasjunk_move_hamfalse任何从垃圾箱移出到 ham 邮箱的消息都作为 ham 学习markasjunk_permanently_removefalse某些驱动会创建消息的新副本此时原消息会被删除设为true时原消息被永久删除而非移入 Trashmarkasjunk_spam_onlyfalse只显示标记为垃圾按钮markasjunk_allowed_hostsnull仅在指定主机启用插件例如[mail1.domain.tld, mail2.domain.tld]markasjunk_host_confignull按主机加载专属配置例如[mail1.domain.tld mail1_config.inc.php]markasjunk_debugfalse把 spam/ham 命令的输出写入日志便于调试从源码实现看标志逻辑位于_init_flags()markasjunk.php当markasjunk_spam_flag false时移除JUNK标志否则可用自定义值替换NONJUNK同理。只要仍有标志启用插件就会通过storage_init钩子把JUNK/NONJUNK注册进核心存储层set_flags()markasjunk.php保证这些自定义标志在 Roundcube 内部可被识别与渲染。主机白名单与按主机配置也在init()阶段处理不在markasjunk_allowed_hosts列表内的主机直接跳过插件初始化markasjunk.php_load_host_config()则会针对当前storage_host加载对应配置文件markasjunk.php。学习驱动Learning Driver机制学习驱动是插件的灵魂它允许在每条被标记为 spam/ham 的消息上执行额外的处理例如调用 sa-learn 训练贝叶斯过滤、把消息副本存盘、转发到指定邮箱、维护黑/白名单等。驱动接口约定README 明确规定了驱动必须满足的契约源码侧由_init_driver()markasjunk.php强制校验文件与类名驱动文件放在plugins/markasjunk/drivers/下文件名形如xxx.php类名必须是markasjunk_{文件名}例如cmd_learn.php对应markasjunk_cmd_learn。spam 方法接收 2 个参数——被标记为 spam 的消息 UID 数组、这些消息所在的邮箱名。实际调用时还会额外传入目标邮箱见_call_driver()markasjunk.php。ham 方法接收同样的 2 个参数处理被标记为 ham 的消息。init 方法可选不接收参数在页面加载时被调用典型用途是向页面注入 JavaScript以控制不同邮箱中 spam/ham 按钮的显示状态。驱动加载的校验逻辑非常严格文件不可读会抛出错误Unable to open driver file类不存在或缺少spam/ham方法则报Broken drivermarkasjunk.php。配置项markasjunk_learning_driver指定要加载的驱动名留空null则不加载任何驱动插件只做消息移动与标志操作。驱动的返回值还会影响主流程_call_driver()通过empty($this-driver-is_error)判断驱动是否报错若驱动把is_error置真_spam()/_ham()会中断后续处理markasjunk.php。内置驱动一览README 列出的默认驱动与 drivers 目录 一一对应MarkasjunkTest测试用例也逐一验证了这 8 个驱动都能被正确实例化tests/MarkasjunkTest.php驱动作用依赖/要求cmd_learn调用外部命令例如sa-learn处理消息无dir_learn把消息副本存放到预定义目录供后续处理目录需 Web 服务器可写email_learn把消息以附件形式或直接转发到指定邮箱需 Roundcube 1.4sa_blacklist将 spam 消息的发件人地址加入用户黑名单ham 则加入白名单需 SAUserPrefs 插件amavis_blacklist同上但面向 Amavis/Amacube 的 wblist 表需 Amacube 插件驱动作者 Der-Jansa_detach若消息是 SpamAssassin 垃圾报告且内嵌原始邮件附件则分离附件存入收件箱、删除报告本身无edit_headers用preg_replace修改消息头无jsevent示例驱动演示如何利用 JS 事件控制按钮显示无示例各驱动深入解析cmd_learn命令行学习读取markasjunk_spam_cmd/markasjunk_ham_cmd配置的命令模板逐条消息展开宏后通过shell_exec执行drivers/cmd_learn.php。实现细节上有两点值得注意对%s发件人地址和%h:消息头展开出的值会做escapeshellarg转义且若值以-开头可能被解析成命令行选项则跳过该消息防止注入%f消息文件路径通过tempnam()在temp_dir生成临时文件并写入get_raw_body()内容执行后立即unlink清理旧版宏%xds已被自动替换为%h:x-dspam-signatureDSPAM 支持。dir_learn目录学习把markasjunk_spam_dir/markasjunk_ham_dir指定目录作为存储目标将每条消息的原始内容写入tempnam($dest_dir, $filename)生成的临时文件drivers/dir_learn.php文件名前缀由markasjunk_filename决定支持%u、%tspam/ham、%l、%d宏。email_learn邮件学习读取markasjunk_email_spam/markasjunk_email_ham目标地址通过rcmail_sendmail发送drivers/email_learn.php。markasjunk_email_attach true时把原消息作为message/rfc822附件发送附件名取原主题 .emlfalse时则以rcmail_resend_mail构造 Resent-* 回弹邮件bounce形式直接转发。主题由markasjunk_email_subject控制默认learn this message as %t。sa_blacklistSpamAssassin 黑/白名单依赖 SAUserPrefs 插件读取其数据库配置sauserprefs_sql_table_name、sauserprefs_sql_username_field等与markasjunk_sauserprefs_config指定的配置路径默认../sauserprefs/config.inc.php。对每条消息取发件人地址校验合法性后写入blacklist_from/whitelist_fromSpamAssassin v4 下自动切换为blocklist_from/welcomelist_from并先清除对侧名单避免冲突drivers/sa_blacklist.php。amavis_blacklistAmavis 黑/白名单依赖 Amacube 插件操作 Amavis 的wblist/mailaddr/users三张表drivers/amavis_blacklist.phpspam 置wbbblackham 置wbwwhite。邮箱地址不存在时自动写入mailaddr表priority 20。sa_detachSpamAssassin 报告分离spam()为空操作ham()遍历消息附件寻找message/rfc822类型且x-spam-typeoriginal的内嵌原始邮件分离保存到目标邮箱后删除原报告drivers/sa_detach.php。edit_headers头部编辑读取markasjunk_spam_patterns/markasjunk_ham_patterns的patternsreplacements数组对原始头部get_raw_headers()执行preg_replace再用新头部替换原始消息中的旧头部最后save_message()写入目标邮箱并让主流程移动/删除旧消息drivers/edit_headers.php。该驱动直接改动消息源message sourceREADME 对此有明确警告。jseventJS 事件示例演示init()的用法——向页面注入监听markasjunk-update事件的脚本根据当前邮箱名动态切换 spam/ham 按钮例如对spam2/spam3只显示 ham 按钮、对unknown1/unknown2两个按钮都显示并改文案为 As possibly spamdrivers/jsevent.php。命令行宏变量cmd_learn与dir_learn/email_learn的配置支持一套统一的宏展开机制config.inc.php.dist 中有完整定义宏替换内容%u用户名来自会话信息%l用户名的本地部分若用户名为邮箱地址%d用户名的域名部分若用户名为邮箱地址否则为默认邮件域名%i用户默认身份identity的邮箱地址%s消息的发件人邮箱地址仅cmd_learn%f消息文件路径仅cmd_learn%t消息类型spam/hamdir_learn文件名与email_learn主题%h:header name消息中指定头的内容小写例如%h:x-dspam-signature仅cmd_learnSpam 与 Ham 学习命令示例README 给出了 SpamAssassin 的经典命令行写法可直接填入markasjunk_spam_cmd/markasjunk_ham_cmdSpam 学习markasjunk_spam_cmdsa-learn --spam --username%u %f或使用按域名/用户拆分的主目录预文件sa-learn --spam --prefs-file/var/mail/%d/%l/.spamassassin/user_prefs %fHam 学习markasjunk_ham_cmdsa-learn --ham --username%u %f或sa-learn --ham --prefs-file/var/mail/%d/%l/.spamassassin/user_prefs %f结合cmd_learn源码可知%f会被替换为插件生成的临时消息文件路径位于 Roundcube 的temp_dir命令执行后临时文件随即被删除%u、%l、%d、%i、%s均经过escapeshellarg处理。若希望 DSPAM 也能学习可将%f换成%h:x-dspam-signature等专属头参与拼装。运行多个驱动进阶需谨慎README 特别警告同时运行多个驱动非常危险务必充分测试风险自负。更安全的做法是创建一个把所有逻辑都做完的单一驱动。如果确实需要多驱动可以把多个驱动串联例如先sa_blacklist再cmd_learn或edit_headers与cmd_learn组合。从架构上讲markasjunk_learning_driver目前只能指定一个驱动类_init_driver()只实例化一个类markasjunk.php因此多驱动实际上是通过编写一个内部串联多个逻辑的自定义驱动实现的。README 提供了一个示例多驱动作为起点但它只是一个起始模板需要针对具体场景修改后才能使用。edit_headers 配置示例edit_headers驱动通过正则改写头部README 给出了给主题加[SPAM]前缀的完整示例警告这是简单示例自行使用需承担风险spam 模式匹配整个 Subject 行并加前缀$config[markasjunk_spam_patterns] array( patterns array(/^(Subject:\s*)(.*)$/m), replacements array($1[SPAM] $2) );ham 模式去除前缀还原$config[markasjunk_ham_patterns] array( patterns array(/^(Subject:\s*)\[SPAM\](https://link.gitcode.com/i/f2f3b11025838adebcc606d40304c7dd)$/m), replacements array($1$2) );重要安全提示README 与 config 模板双重强调必须匹配整条头部行包括头部名称本身务必使用^和$锚点并启用m修饰符在真实消息上使用前一定要充分测试。该驱动会改动消息源message source一旦正则写错可能破坏邮件结构。patterns与replacements一一对应替换采用 PHPpreg_replace语义。消息流转的源码级验证mark_message()的完整流程markasjunk.php印证了 README 描述的两场景行为根据动作名判断$is_spamplugin.markasjunk.junk为 spam从 POST 读取_uid与_mbox经rcmail_action::get_uids()解析出messageset支持多文件夹模式特殊情形当选择全选uid *、非多文件夹且有驱动时自行取整个邮箱索引markasjunk.php调用_spam()/_ham()先执行驱动再设置/清除SEEN、JUNK、NONJUNK标志markasjunk.php成功后通过markasjunk_move前端命令把消息移动到目标邮箱或刷新列表并显示reportedasjunk/reportedasnotjunk确认提示。插件还通过set_env()向前端 JS 暴露markasjunk_ham_mailbox、markasjunk_spam_mailbox、markasjunk_move_spam、markasjunk_move_ham、markasjunk_permanently_remove、markasjunk_spam_only等环境变量markasjunk.php前端逻辑位于 markasjunk.js。测试与验证仓库提供了两个层面的测试单元测试tests/MarkasjunkTest.php 验证插件对象构造继承rcube_plugin并逐一实例化全部 8 个内置驱动确认markasjunk_{driver}类加载无误浏览器测试tests/Browser/MailTest.php 覆盖邮件列表场景下的端到端行为。启用驱动后建议结合markasjunk_debug true观察日志输出cmd_learn会记录完整命令与命令输出、dir_learn/email_learn/黑名单驱动也会记录关键动作确认命令执行与地址写入是否符合预期。许可证说明插件以 GNU General Public License Version 3GPLv3 发布见 markasjunk.php。README 特别说明即使皮肤skins包含部分编程工作它们不被视为插件的关联部分因此皮肤不受 GPL 条款约束皮肤许可详情请查看核心皮肤目录中的 README。小结MarkAsJunk 的价值在于把用户手动纠错这一行为转化为反垃圾系统的训练信号通过markasjunk_learning_driver挂接cmd_learnsa-learn/DSPAM 命令行、dir_learn落盘、email_learn转发、sa_blacklist/amavis_blacklist名单维护、sa_detach报告分离或自定义驱动可以在消息移动之外完成真正的机器学习闭环。部署时请牢记三条红线编辑头部必须精确匹配整行并充分测试多驱动串联前务必验证各步骤的副作用任何来自邮件的值发件人、头部内容都会经过转义与合法性校验切勿自行绕过。赞分享即时通讯后端前端【免费下载链接】roundcubemailThe Roundcube Webmail suite项目地址https://gitcode.com/gh_mirrors/ro/roundcubemail点击查看免费下载相关推荐终极Postal反垃圾邮件实战SpamAssassinClamAV集成指南拦截率提升至99%终极Postal反垃圾邮件实战SpamAssassinClamAV集成指南拦截率提升至99% Postal作为一款功能全面的开源邮件投递平台支持收发邮件后端通信Docker-Mailserver反垃圾邮件实战Rspamd与SpamAssassin深度配置Docker Mailserver反垃圾邮件实战Rspamd与SpamAssassin深度配置 想要搭建一个安全可靠的邮件服务器却总是被垃圾邮件困扰后端通信云原生Haraka反垃圾邮件终极指南集成SpamAssassin和Rspamd的完整配置教程Haraka反垃圾邮件终极指南集成SpamAssassin和Rspamd的完整配置教程 Haraka是一款快速、高度可扩展的事件驱动型SMTP服务器通过插件后端网络/通信上一篇Deepin Boot Maker三步搞定Linux启动盘制作告别复杂命令下一篇告别30天限制Beyond Compare 5永久激活密钥生成器完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Roundcube Webmail MarkAsJunk 插件实战指南：垃圾邮件标记、学习驱动与 SpamAssassin 集成
即时通讯后端前端【免费下载链接】roundcubemailThe Roundcube Webmail suite项目地址https://gitcode.com/gh_mirrors/ro/roundcubemail点击查看免费下载导读MarkAsJunk 是 Roundcube Webmail 官方插件体系中负责标记为垃圾/非垃圾的核心组件它向邮件工具栏或标记菜单注入 spam/ham 按钮并将选定邮件移动到 Junk垃圾箱或收件箱同时通过可插拔的学习驱动Learning Driver把被标记的邮件交给 SpamAssassinsa-learn、DSPAM 等外部反垃圾系统进行训练。本文将基于 plugins/markasjunk/README.md 的完整内容结合 插件主文件、配置文件模板、drivers 目录 及 测试用例 的源码证据带你从零完成插件的启用、配置、驱动选型与自定义驱动开发。插件能做什么两种场景下的消息流转从 markasjunk.php 的插件头注释与 README 可以看出插件的核心行为由当前所在邮箱决定不在 Junk 邮箱时把选中的消息移动到 Junk 邮箱并标记为已读SEEN同时打上 Junk 标志、清除 NonJunk 标志。在 Junk 邮箱时按钮自动切换为标记为非垃圾 / 此消息不是垃圾邮件mark as not spam/this message is not spam消息被移回收件箱默认INBOX清除 Junk 标志并打上 NonJunk 标志。插件只在mail任务下生效public $task mail见 markasjunk.php并注册了plugin.markasjunk.junk与plugin.markasjunk.not_junk两个动作markasjunk.php统一由mark_message()处理。按钮的呈现位置有两种选择默认放在主工具栏markasjunk_toolbar true也可以关闭该选项改为在标记菜单markmenu中出现菜单项见 markasjunk.php。安装与基础配置配置文件默认配置模板位于 plugins/markasjunk/config.inc.php.dist使用方式与 Roundcube 其他插件一致将config.inc.php.dist复制为config.inc.php按需修改参数——README 明确说明所有配置参数都是可选的。插件通过load_config()读取该文件markasjunk.php并额外支持按邮件主机mail host加载专属配置。基础行为参数以下参数控制消息移动、标志与界面均来自 config.inc.php.dist参数默认值作用markasjunk_ham_mboxnull即INBOX标记为 ham 后消息移动到的邮箱设为false可禁用移动markasjunk_spam_mboxnull即 Roundcube 设置中指定的垃圾邮件文件夹junk_mbox标记为 spam 后消息移动到的邮箱设为false可禁用移动markasjunk_read_spamfalse标记为 spam 时是否同时标记为已读markasjunk_unread_hamfalse标记为 ham 时是否同时标记为未读markasjunk_spam_flagJunk标记为 spam 时附加的 IMAP 标志标记为 ham 时移除设为false关闭标志markasjunk_ham_flagNonJunk标记为 ham 时附加的 IMAP 标志标记为 spam 时移除设为false关闭标志markasjunk_toolbartruetrue在工具栏显示按钮false则改用标记菜单markasjunk_move_spamfalse任何被移入垃圾箱的消息都作为 spam 学习不仅是点击按钮时markasjunk_move_hamfalse任何从垃圾箱移出到 ham 邮箱的消息都作为 ham 学习markasjunk_permanently_removefalse某些驱动会创建消息的新副本此时原消息会被删除设为true时原消息被永久删除而非移入 Trashmarkasjunk_spam_onlyfalse只显示标记为垃圾按钮markasjunk_allowed_hostsnull仅在指定主机启用插件例如[mail1.domain.tld, mail2.domain.tld]markasjunk_host_confignull按主机加载专属配置例如[mail1.domain.tld mail1_config.inc.php]markasjunk_debugfalse把 spam/ham 命令的输出写入日志便于调试从源码实现看标志逻辑位于_init_flags()markasjunk.php当markasjunk_spam_flag false时移除JUNK标志否则可用自定义值替换NONJUNK同理。只要仍有标志启用插件就会通过storage_init钩子把JUNK/NONJUNK注册进核心存储层set_flags()markasjunk.php保证这些自定义标志在 Roundcube 内部可被识别与渲染。主机白名单与按主机配置也在init()阶段处理不在markasjunk_allowed_hosts列表内的主机直接跳过插件初始化markasjunk.php_load_host_config()则会针对当前storage_host加载对应配置文件markasjunk.php。学习驱动Learning Driver机制学习驱动是插件的灵魂它允许在每条被标记为 spam/ham 的消息上执行额外的处理例如调用 sa-learn 训练贝叶斯过滤、把消息副本存盘、转发到指定邮箱、维护黑/白名单等。驱动接口约定README 明确规定了驱动必须满足的契约源码侧由_init_driver()markasjunk.php强制校验文件与类名驱动文件放在plugins/markasjunk/drivers/下文件名形如xxx.php类名必须是markasjunk_{文件名}例如cmd_learn.php对应markasjunk_cmd_learn。spam 方法接收 2 个参数——被标记为 spam 的消息 UID 数组、这些消息所在的邮箱名。实际调用时还会额外传入目标邮箱见_call_driver()markasjunk.php。ham 方法接收同样的 2 个参数处理被标记为 ham 的消息。init 方法可选不接收参数在页面加载时被调用典型用途是向页面注入 JavaScript以控制不同邮箱中 spam/ham 按钮的显示状态。驱动加载的校验逻辑非常严格文件不可读会抛出错误Unable to open driver file类不存在或缺少spam/ham方法则报Broken drivermarkasjunk.php。配置项markasjunk_learning_driver指定要加载的驱动名留空null则不加载任何驱动插件只做消息移动与标志操作。驱动的返回值还会影响主流程_call_driver()通过empty($this-driver-is_error)判断驱动是否报错若驱动把is_error置真_spam()/_ham()会中断后续处理markasjunk.php。内置驱动一览README 列出的默认驱动与 drivers 目录 一一对应MarkasjunkTest测试用例也逐一验证了这 8 个驱动都能被正确实例化tests/MarkasjunkTest.php驱动作用依赖/要求cmd_learn调用外部命令例如sa-learn处理消息无dir_learn把消息副本存放到预定义目录供后续处理目录需 Web 服务器可写email_learn把消息以附件形式或直接转发到指定邮箱需 Roundcube 1.4sa_blacklist将 spam 消息的发件人地址加入用户黑名单ham 则加入白名单需 SAUserPrefs 插件amavis_blacklist同上但面向 Amavis/Amacube 的 wblist 表需 Amacube 插件驱动作者 Der-Jansa_detach若消息是 SpamAssassin 垃圾报告且内嵌原始邮件附件则分离附件存入收件箱、删除报告本身无edit_headers用preg_replace修改消息头无jsevent示例驱动演示如何利用 JS 事件控制按钮显示无示例各驱动深入解析cmd_learn命令行学习读取markasjunk_spam_cmd/markasjunk_ham_cmd配置的命令模板逐条消息展开宏后通过shell_exec执行drivers/cmd_learn.php。实现细节上有两点值得注意对%s发件人地址和%h:消息头展开出的值会做escapeshellarg转义且若值以-开头可能被解析成命令行选项则跳过该消息防止注入%f消息文件路径通过tempnam()在temp_dir生成临时文件并写入get_raw_body()内容执行后立即unlink清理旧版宏%xds已被自动替换为%h:x-dspam-signatureDSPAM 支持。dir_learn目录学习把markasjunk_spam_dir/markasjunk_ham_dir指定目录作为存储目标将每条消息的原始内容写入tempnam($dest_dir, $filename)生成的临时文件drivers/dir_learn.php文件名前缀由markasjunk_filename决定支持%u、%tspam/ham、%l、%d宏。email_learn邮件学习读取markasjunk_email_spam/markasjunk_email_ham目标地址通过rcmail_sendmail发送drivers/email_learn.php。markasjunk_email_attach true时把原消息作为message/rfc822附件发送附件名取原主题 .emlfalse时则以rcmail_resend_mail构造 Resent-* 回弹邮件bounce形式直接转发。主题由markasjunk_email_subject控制默认learn this message as %t。sa_blacklistSpamAssassin 黑/白名单依赖 SAUserPrefs 插件读取其数据库配置sauserprefs_sql_table_name、sauserprefs_sql_username_field等与markasjunk_sauserprefs_config指定的配置路径默认../sauserprefs/config.inc.php。对每条消息取发件人地址校验合法性后写入blacklist_from/whitelist_fromSpamAssassin v4 下自动切换为blocklist_from/welcomelist_from并先清除对侧名单避免冲突drivers/sa_blacklist.php。amavis_blacklistAmavis 黑/白名单依赖 Amacube 插件操作 Amavis 的wblist/mailaddr/users三张表drivers/amavis_blacklist.phpspam 置wbbblackham 置wbwwhite。邮箱地址不存在时自动写入mailaddr表priority 20。sa_detachSpamAssassin 报告分离spam()为空操作ham()遍历消息附件寻找message/rfc822类型且x-spam-typeoriginal的内嵌原始邮件分离保存到目标邮箱后删除原报告drivers/sa_detach.php。edit_headers头部编辑读取markasjunk_spam_patterns/markasjunk_ham_patterns的patternsreplacements数组对原始头部get_raw_headers()执行preg_replace再用新头部替换原始消息中的旧头部最后save_message()写入目标邮箱并让主流程移动/删除旧消息drivers/edit_headers.php。该驱动直接改动消息源message sourceREADME 对此有明确警告。jseventJS 事件示例演示init()的用法——向页面注入监听markasjunk-update事件的脚本根据当前邮箱名动态切换 spam/ham 按钮例如对spam2/spam3只显示 ham 按钮、对unknown1/unknown2两个按钮都显示并改文案为 As possibly spamdrivers/jsevent.php。命令行宏变量cmd_learn与dir_learn/email_learn的配置支持一套统一的宏展开机制config.inc.php.dist 中有完整定义宏替换内容%u用户名来自会话信息%l用户名的本地部分若用户名为邮箱地址%d用户名的域名部分若用户名为邮箱地址否则为默认邮件域名%i用户默认身份identity的邮箱地址%s消息的发件人邮箱地址仅cmd_learn%f消息文件路径仅cmd_learn%t消息类型spam/hamdir_learn文件名与email_learn主题%h:header name消息中指定头的内容小写例如%h:x-dspam-signature仅cmd_learnSpam 与 Ham 学习命令示例README 给出了 SpamAssassin 的经典命令行写法可直接填入markasjunk_spam_cmd/markasjunk_ham_cmdSpam 学习markasjunk_spam_cmdsa-learn --spam --username%u %f或使用按域名/用户拆分的主目录预文件sa-learn --spam --prefs-file/var/mail/%d/%l/.spamassassin/user_prefs %fHam 学习markasjunk_ham_cmdsa-learn --ham --username%u %f或sa-learn --ham --prefs-file/var/mail/%d/%l/.spamassassin/user_prefs %f结合cmd_learn源码可知%f会被替换为插件生成的临时消息文件路径位于 Roundcube 的temp_dir命令执行后临时文件随即被删除%u、%l、%d、%i、%s均经过escapeshellarg处理。若希望 DSPAM 也能学习可将%f换成%h:x-dspam-signature等专属头参与拼装。运行多个驱动进阶需谨慎README 特别警告同时运行多个驱动非常危险务必充分测试风险自负。更安全的做法是创建一个把所有逻辑都做完的单一驱动。如果确实需要多驱动可以把多个驱动串联例如先sa_blacklist再cmd_learn或edit_headers与cmd_learn组合。从架构上讲markasjunk_learning_driver目前只能指定一个驱动类_init_driver()只实例化一个类markasjunk.php因此多驱动实际上是通过编写一个内部串联多个逻辑的自定义驱动实现的。README 提供了一个示例多驱动作为起点但它只是一个起始模板需要针对具体场景修改后才能使用。edit_headers 配置示例edit_headers驱动通过正则改写头部README 给出了给主题加[SPAM]前缀的完整示例警告这是简单示例自行使用需承担风险spam 模式匹配整个 Subject 行并加前缀$config[markasjunk_spam_patterns] array( patterns array(/^(Subject:\s*)(.*)$/m), replacements array($1[SPAM] $2) );ham 模式去除前缀还原$config[markasjunk_ham_patterns] array( patterns array(/^(Subject:\s*)\[SPAM\](https://link.gitcode.com/i/f2f3b11025838adebcc606d40304c7dd)$/m), replacements array($1$2) );重要安全提示README 与 config 模板双重强调必须匹配整条头部行包括头部名称本身务必使用^和$锚点并启用m修饰符在真实消息上使用前一定要充分测试。该驱动会改动消息源message source一旦正则写错可能破坏邮件结构。patterns与replacements一一对应替换采用 PHPpreg_replace语义。消息流转的源码级验证mark_message()的完整流程markasjunk.php印证了 README 描述的两场景行为根据动作名判断$is_spamplugin.markasjunk.junk为 spam从 POST 读取_uid与_mbox经rcmail_action::get_uids()解析出messageset支持多文件夹模式特殊情形当选择全选uid *、非多文件夹且有驱动时自行取整个邮箱索引markasjunk.php调用_spam()/_ham()先执行驱动再设置/清除SEEN、JUNK、NONJUNK标志markasjunk.php成功后通过markasjunk_move前端命令把消息移动到目标邮箱或刷新列表并显示reportedasjunk/reportedasnotjunk确认提示。插件还通过set_env()向前端 JS 暴露markasjunk_ham_mailbox、markasjunk_spam_mailbox、markasjunk_move_spam、markasjunk_move_ham、markasjunk_permanently_remove、markasjunk_spam_only等环境变量markasjunk.php前端逻辑位于 markasjunk.js。测试与验证仓库提供了两个层面的测试单元测试tests/MarkasjunkTest.php 验证插件对象构造继承rcube_plugin并逐一实例化全部 8 个内置驱动确认markasjunk_{driver}类加载无误浏览器测试tests/Browser/MailTest.php 覆盖邮件列表场景下的端到端行为。启用驱动后建议结合markasjunk_debug true观察日志输出cmd_learn会记录完整命令与命令输出、dir_learn/email_learn/黑名单驱动也会记录关键动作确认命令执行与地址写入是否符合预期。许可证说明插件以 GNU General Public License Version 3GPLv3 发布见 markasjunk.php。README 特别说明即使皮肤skins包含部分编程工作它们不被视为插件的关联部分因此皮肤不受 GPL 条款约束皮肤许可详情请查看核心皮肤目录中的 README。小结MarkAsJunk 的价值在于把用户手动纠错这一行为转化为反垃圾系统的训练信号通过markasjunk_learning_driver挂接cmd_learnsa-learn/DSPAM 命令行、dir_learn落盘、email_learn转发、sa_blacklist/amavis_blacklist名单维护、sa_detach报告分离或自定义驱动可以在消息移动之外完成真正的机器学习闭环。部署时请牢记三条红线编辑头部必须精确匹配整行并充分测试多驱动串联前务必验证各步骤的副作用任何来自邮件的值发件人、头部内容都会经过转义与合法性校验切勿自行绕过。赞分享即时通讯后端前端【免费下载链接】roundcubemailThe Roundcube Webmail suite项目地址https://gitcode.com/gh_mirrors/ro/roundcubemail点击查看免费下载相关推荐终极Postal反垃圾邮件实战SpamAssassinClamAV集成指南拦截率提升至99%终极Postal反垃圾邮件实战SpamAssassinClamAV集成指南拦截率提升至99% Postal作为一款功能全面的开源邮件投递平台支持收发邮件后端通信Docker-Mailserver反垃圾邮件实战Rspamd与SpamAssassin深度配置Docker Mailserver反垃圾邮件实战Rspamd与SpamAssassin深度配置 想要搭建一个安全可靠的邮件服务器却总是被垃圾邮件困扰后端通信云原生Haraka反垃圾邮件终极指南集成SpamAssassin和Rspamd的完整配置教程Haraka反垃圾邮件终极指南集成SpamAssassin和Rspamd的完整配置教程 Haraka是一款快速、高度可扩展的事件驱动型SMTP服务器通过插件后端网络/通信上一篇Deepin Boot Maker三步搞定Linux启动盘制作告别复杂命令下一篇告别30天限制Beyond Compare 5永久激活密钥生成器完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考