编辑“Xlight FTP/设置电子邮件通知”

{{Xlight FTP}}

==在Xlight FTP服务器中设置电子邮件通知==
<p style="text-indent:2em;">[[Xlight FTP]]服务器中, 系统管理员可以设置电子邮件通知, 这样当某些事件如, "文件上传" 或 "硬盘空间不足" 发生时, 他可以收到电子邮件通知.</p>

<p style="text-indent:2em;">在这个教学里, 我们将教你如何设置电子邮件通知. 注意: 只有专业版本的Xlight FTP服务器有这个功能, 用户在30-天试用期也可以试用这个功能.</p>

1. 你必须到[[虚拟服务器]]的设置里,启用电子邮件通知功能, 如下图所示.

[[Image:b1.jpg]]

2. 然后你需要设置 [[SMTP]] 服务器用于发送通知的电子邮件. 我们这里用Gmail为例. 因为Gmail的SMTP服务器需要TLS 加密连接, 你需要选择选项"使用SSL/TLS连接"并使用端口465. 对于大部分公司内部的邮件服务器，标准的SMTP端口25总是被支持，SSL/TLS的端口465不一定被支持。 所以对公司内部的邮件服务器来说，SSL/TLS连接不是必须的，甚至不能使用。

3. 你必须选择电子邮件通知配置文件. 这个文件用来配置那些事件能够触发FTP服务器发送电子邮件通知. 电子邮件通知配置文件是文本文件, 它存放关于你能够接受电子邮件通知的事件. 你可以用记事本编辑这个文件.

[[Image:b2.jpg]]

4. 你还需要设置SMTP用户认证以及默认的电子邮件设置. 设置SMTP用户认证, 你需要在邮件服务器有一个有效的账户, 如下图所示.

[[Image:b3.jpg]]

<p style="text-indent:2em;">Xlight FTP服务器的邮件通知支持6个事件. 下面的表格是支持事件的列表.</p>

===电子邮件通知支持的事件===
[[Image:b4.jpg]]

<p style="text-indent:2em;">如果你想要接受到电子邮件通知, 你需要将事件类型放在电子邮件通知配置文件中. 你可以使用参数进一步限制电子邮件通知被发送的条件. 下图是一个电子邮件通知配置文件的例子,其中包含了5个事件.</p>

[[Image:b5.jpg]]

<p style="text-indent:2em;">在虚拟服务器当一个用户上传,下载,删除一个文件或硬盘空间被定期检查后,这些动作都会导致FTP服务器检查,预先加载到内存里的邮件通知配置文件. 服务器使用当前的动作对照并检查在电子邮件通知配置文件中的每一行事件和条件. 如果其中一行能够通过这个检查, 一封电子邮件将被发出. 当找到匹配的一行以后, Xlight FTP服务器将不会继续检查下面的行. 配置文件中行的顺序会影响电子邮件通知. 你最好将比较特别的条件放在靠近上面的行,比较同样的条件放在靠近下面的行.</p>

<p style="text-indent:2em;">配置文件中的每一行是从左到右检查. 在上面的图里, OnFileUpload是第一行里的事件. 参数 $file 设置文件的类型. $file 有两个值 *.exe 和 *.bat. 当用户上传文件的后缀是 *.exe 或 *.bat, 它将既满足 OnFileUpload事件和文件类型的条件. 用户的上传行为然后检查参数$dir. $dir参数限制了上传目录是虚拟路径 /public 或是它的子目录.</p>

<p style="text-indent:2em;">如果上面所有的条件都满足, 一封电子邮件将被发出通知一个文件后缀是*.exe 或 *.bat 被上传到虚拟路径 /public 或是它的子目录中.</p>

<p style="text-indent:2em;">第一行中的 $email_file 参数不是条件. 它用来指定一个文件,这个文件用于定制电子邮件的内容. 如果你不使用 $email_file 参数, Xlight FTP服务器会生成默认的电子邮件内容. 在 $email_file 指定的文件中, 你可以为将要受到邮件的人使用其他 TO, CC 和 BCC 地址. 这将替代电子邮件设置里默认的TO地址.</p>

===邮件通知配置文件事例===

例子 1. 当硬盘C的剩余空间少于100 MB, 或硬盘D的剩余空间少于200 MB时发送电子邮件通知.

OnDiskSpaceLow $disk_space=C(100),D(200)

Example 2. 当被上传的文件大小超过2000 MB时发送电子邮件通知.

OnFileUpload $file_size>2000

Example 3. 当用户名是test的用户上传后缀是 gif, jpg, 或 png的文件后电子邮件通知.

OnFileUpload $file=*.gif,*.jpg,*.png; $user=test

Example 4. 当用户上传文件名包含被禁止关键字如sex, porn的文件后发送电子邮件通知.

OnFileUpload $file=*sex*,*porn*;

Example 5. 当用户登出时,发送电子邮件通知的条件时他至少需要上传一个文件.

OnLogout $up_files>0;

Example 6. 当用户"tester"登录时发送[[电子邮件]]通知.

OnLogin $user=tester;

Example 7. 除了匿名用户"anonymous"之外，其他用户登录时会发送电子邮件通知.

OnLogin $user=×; $exclude_user=anonymous;

下面是邮件通知配置文件支持的参数.

===邮件通知配置文件支持的参数===
[[Image:b6.jpg]]

<p style="text-indent:2em;">某些参数允许多个值. 多个值之间用逗号","分割. 对于有多个值的参数,值之间的关系是或者. 例如$user = a*, c* 的意思是用户的登录名以字符a 或者 b 开始. 如果一行包含多个参数,所有条件必须满足才能触发事件. 对于这行里没有出现的参数,它们的条件自动满足.</p>

<p style="text-indent:2em;">下图是$email_file指定的一个电子邮件文件的内容示例. 以字符%开始的字符串是变量, 它们将在电子邮件发送前被替换为实际的内容.</p>

<p style="text-indent:2em;">注意: 在电子邮件头内不能有任何空行. 电子邮件头和邮件内容之间只用一个空行分开. 在电子邮件内容中, 允许空行数没有限制,如下图所示.</p>

[[Image:b7.jpg]]

<p style="text-indent:2em;">下面是电子邮件文件支持的变量. 请注意区别: 电子邮件文件的变量以字符%开始, 但是邮件通知配置文件的参数以字符$开始.</p>

===电子邮件文件支持的变量===
[[Image:b8.jpg]]


==参考来源==
*http://www.xlightftpd.com/cn/


{{Xlight FTP导航}}


[[category:Xlight FTP]]