JDMail的过滤器 (帮助)
--------------------------------------------------------------------------------

本篇是关于过滤器的安装配置的详细帮助信息。

JDMail过滤器，是邮件到达后触发各种处理程序进行各种处理的机制。JDMail的过滤器功能非常灵活，使用这个功能，可以增强对邮件的各种处理能力。

JDMail过滤器，有在线处理(SMTP会话期间执行)和离线处理(SMTP会话结束后执行或SMTP会话开始前执行)两种区别。

在线处理是在JDMail接收邮件（包括所有接收的邮件）的过程中执行，离线处理是在给本地用户的邮件在投递到用户的邮箱之前，或转发到外部的邮件会话开始前执行。

JDWA功能扩展

JDWA向JDMail邮件服务添加标准在线过滤器和离线过滤器，实行以下功能。

【SMTP RCPT 后处理】
(在线过滤器)

垃圾邮件主机的管理(S25R检查)
【SMTP DATA 前处理】
(在线过滤器)

SMTP 连接数制限

【SMTP DATA 后处理】
(在线过滤器)

病毒扫描

垃圾邮件内容过滤

批量删除附件

记录所有收到邮件(Catch All)
垃圾邮件主机的管理(S25R检查)
【SMTP 会话后处理(入站处理)】
(离线处理)

自动回复

通知邮件

删除附件

限制收信(许可收信)
拒绝收信

收信记录

Message-Id: Header标记的添加

Subject: Header标记的宏的添加

Reply-To: Header标记的添加

正文的页眉/页脚添加

垃圾邮件内容过滤

空邮件投稿自动订阅/退订

名单处理器

病毒扫描

邮件到达对 LAN 内主机的通知

接收邮件的自动过滤

批量删除附件

【SMTP 会话开始前处理(出站处理)】
(离线处理)

送信者(From允许SMTP中继的地址

垃圾邮件内容过滤

病毒扫描

Recievied:Header标记的添加

批量删除附件

SMTP 送信保留(延迟发送)

使用在线过滤器功能的准备工作

在线过滤器处理[SMTP RCPT 后处理]、[SMTP DATA 前处理]和[SMTP DATA 后处理]需要以下的工作。

[SMTP RCPT 后处理]、[SMTP DATA 前处理]、[SMTP DATA 后处理] 的定义文件保存在 MailRoot\filters.post-rcpt.tab、MailRoot\filters.pre-data.tab、MailRoot\filters.post-data.tab 。

过滤器定义文件中启动过滤器的定义可以指定如下(可以指定多行)。

"!标志" (tab) "启动指令" (tab) "参数" (tab) "参数" (tab) ‥‥‥(换行)

标志可以省略。如果省略标志，启动指令在开始处。标志 aex、wlex 。aex 对通过SMTP认证连接到SMTP服务器的用户不运行那个指令。wlex 对 [SMTP 白名单」登记的用户(IP 地址)不运行那个指令。指定多个标志时候用逗号断开。此外，标志字符串的起始作为识别字符的 "!" 需要添加。
例如: "!aex,wlex" ......

启动命令，操作系统的内部命令和外部命令，您可以指定一个程序或脚本，在控制台模式下运行。如果您运行一个Perl脚本，例如 c:\usr\local\bin\perl.exe 的解释器请指定路径。

参数可以重复任意多次。如果运行Perl脚本，请把脚步的完整路径作为第一个参数。JDMail支持宏作为参数。支持的宏如下。

$(CRCPT) 最后的 RCPT TO: 指令的值

$(FILE) 邮件文件的完整路径

$(FROM) MAIL FROM: 指令的值

$(LOCALADDR) 接收邮件的本地IP地址和TCP端口号

$(REMOTEADDR) 远程主机的IP地址和TCP端口号

$(USERAUTH) SMTP认证时的用户名

$(FILE) 或 @@FILE 两种参数格式都可以使用。

启动指令返回值为 3 ，JDMail 对 SMTP 客户端通知拒绝接收。如果返回值为 16 ，过滤器定义文件中有多个指令的情况，后面的指令不再执行。以外的返回值就继续SMTP会话。

使用离线过滤器功能的准备工作

离线过滤器处理的[SMTP 会话后处理](入站处理)或[SMTP 会话开始前处理](出站处理)需要以下的工作。

[SMTP会话后处理]或[SMTP会话开始前处理]的过滤器定义文件保存在 MailRoot\filters.in.tab 和 MailRoot\filters.out.tab 。

定义格式如下。(1 行 1 个定义)

"发件人地址" (tab) "收件人地址" (tab) "远程 IP 地址" (tab) "本地 IP 地址" (tab) "启动文件名" (换行)

发件人地址和收件人地址可以象 *@domain.com 一样指定通配符。如果只指定 * ，表示所有的地址。

IP 地址像 0.0.0.0./0 和 192.168.1.0/24 一样包含子网掩码。

通过JDWA添加规则不需要输入引号，此外，您可以用空格代替TAB符。

如果有多个规则，符合[发件人地址]、[收件人地址]、[远程 IP 地址]、[本地 IP 地址] 的邮件，按照规则顺序执行。

[环境设置]-[JDWA环境设置] 运行时，会自动配置标准过滤器(JDWA_common_in.tab 和 JDWA_common_out.tab)，启动文件也会自动生成。

过滤器定义文件指定的启动文件在 JDMail 的 MailRoot\filters 文件夹内生成。

如果不使用JDWA制作启动文件，可以用文本编辑器按如下格式制作启动文件。(可以指定多行)

"启动指令" (tab) "参数" (tab) "参数" (tab) ‥‥‥(换行)

启动命令，操作系统内部命令和外部命令，您可以指定一个程序或脚本，在控制台模式下运行，如果您运行一个Perl脚本，例如 c:\usr\local\bin\perl.exe 解释器请具体说明路径。

参数可以重复任意次数。如果运行Perl脚本，把脚本文件的完整路径作为第一个参数。JDMail可以使用宏参数。支持的宏如下。

$(FILE) 邮件文件的完整路径

$(FROM) MAIL FROM: 指令的值

$(LOCALADDR) 接收邮件的本地 IP 地址和 TCP 端口号

$(MSGID) JDMail Message ID
$(MSGREF) SMTP Message ID
$(RCPT) RCPT TO: 指令的值

$(REMOTEADDR) 远程主机的IP地址和TCP端口号

$(RFROM) 别名表参照后的 MAIL FROM: 指令的值

$(RRCPT) 别名表参照后的 RCPT TO: 指令的值

$(USERAUTH) SMTP 认证时的用户名

$(FILE) 和 @@FILE 两种参数格式都可以使用。

实际要使用JDWA标准过滤器提供的功能，还需要将 [用户的管理] 和 [邮件列表的管理] 的各个帐户过滤器设为开启状态。

SMTP会话和过滤器 (示例)
--------------------------------------------------------------------------------

通过JDMail的过滤器系统，您可以添加其它的功能，从而构筑一个健康、坚固的通信系统。在这里，列出了Outlook等的 SMTP 客户端软件和 JDMail 服务器端会话的详细过程， JDMail过滤器系统在每个阶段的参与都附有具体例子说明。请您在创建自定义过滤器时参考。

某天的SMTP会话

以下是某天 zhangsan@mailer.cn 先生发给 lisi@chundi.com 先生电子邮件的时候，在他使用的Outlook和JDMail间的数据交换的简单说明。红色表示Outlook向JDMail发送的数据，蓝色表示从JDMail向Outlook发送的数据。同时，连接到JDMail不仅仅是客户端软件，也有其它的SMTP服务器，这个情况SMTP会话内容和上述情况基本一致。

(JDMail等待的IP地址的TCP端口和客户端建立连接)
(SMTP会话开始)
220 mailer.cn <1238906842.1660@mailer.cn> [JDMail 3.10 ESMTP Server] service ready; Sun, 5 Apr 2009 13:47:22 +0900
EHLO mailer.cn (Mailer->JDMail通知使用SMTP认证)
250-mailer.cn (JDMail->Mailer通知可以使用的认证方法和许可指令等。)
250-VRFY
250-ETRN
250-8BITMIME
250-PIPELINING
250-AUTH RSA-AUTH
250-SIZE
250 STARTTLS
AUTH LOGIN (Mailer->JDMail通知使用的认证类型)
334 VXNlcm5hbWU6 (JDMail->Mailer通知为了认证的一次性字符串(挑战))
Y29wOmh1bmV0Lm5lLmpw (Mailer->JDMail通知根据收到的一次性字符串生成编码后的用户名字符串(response))
334 UGFzc3dvcmQ6 (JDMail->Mailer通知用于加密口令的一次性字符串)
**** (Mailer->JDMail通知加密的字符串)
235 Authentication successful (JDMail->Mailer通知认证成功了)
MAIL From:<zhangsan@mailer.cn> (Mailer->JDMailer通知发送原地址)
250 OK (JDMail->Mailer通知收到发送原地址)
RCPT To:<lisi@chundi.com> (Mailer->JDMail通知收件人地址)
250 OK (JDMail->Mailer通知收到了收件人地址)
DATA (Mailer->JDMail通知开始消息实体的发送)
354 Start mail input; end with <CRLF>.<CRLF> (JDMail->Mailer通知可以开始消息实体的发送)
(开始向JDMail发送消息数据)
(Mailer到JDMail发送用只有一个点的行结束数据发送)
250 OK <S9305E> (JDMail->Mailer通知完成了消息实体的接收)
QUIT (Mailer->JDMail通知SMTP会话结束)
221 [JDMail 3.10 ESMTP Server] service closing transmission channel (JDMail->Mailer通知会话结束)
(SMTP会话结束)

会话阶段和JDMail的动作，过滤器的启动

与上述会话各阶段的JDMail的动作内容参照文件，对应的 JDWA 管理菜单如下。文件名单是按照拉丁字母顺序排序，不是按照 JDMail 实际调用顺序排序。

用过滤器能做的事情，不能做的事情

利用JDMail提供的5种过滤器，可以追加各种功能。详细请参照「JDMail过滤器」。

可以是邮件的加工和外部命令的运行，数据库系统操作、OS操作等，总之都可以。命令的运行使用控制台方式能实行多个程序的调用。当然，您也可以调用自己编写的程序。

JDMail的过滤器系统不能运行的情况如下。

关于认证因为在过滤器被启动之前完成，而且不能干预。

正在与服务器进行会话的 SMTP 客户端和过滤器不能进行相互通讯。

有图行界面的程序通过过滤器不能运行。