ExtMail Solution HOWTO for Linux

版权声明：

本文版权归作者所有，如其他个人、第三方网站或媒体报刊等需转载全文或节选，为支持我们的工作，请务必注明如下信息：

• 作者信息：hzqbbc <hzqbbc (at) hzqbbc (dot) com>
• 文章原始出处：http://www.extmail.org/docs/extmail_solution_linux/
• 项目首页：http://www.extmail.org

如果因此而给您带来麻烦，请您原谅，谢谢合作。

变更说明

• 0.18 2006-09-04：修正一处输入错误，一处不明确的地方
• 0.17 2006-08-30：修正缺漏receive_override_options的bug
• 0.16 2006-08-28：修正maildrop配置错误，感谢风云！
• 0.15 2006-08-17：增加mysql/httpd开机自启动的支持

关于此文

• 版　　本：0.18
• 作　　者：He zhiqiang <hzqbbc (at) hzqbbc (dot) com>
• 项目主页：http://www.extmail.org
• 个人主页：http://www.hzqbbc.com
• 最后更新：2006-09-04

本文档以2005-07-25的早期文档为蓝本，以RPM系统为基础。所涉及软件全部是OpenSource软件，版权以GPL为主，作为企业应用没有任何版权/法律问题。

基于RPM系统具有方便、快捷，易快速复制和重现的优点。如果用户希望获得这些RPM包的源码包，可以与作者联系。

编写本文的初衷，是给那些希望快速架设邮件系统而不想过多了解复杂的系统知识的网管/用户，为了使软件之间的结合更紧密，部分软件的配置及测试方面进行了增强改进，因此本文的一些操作步骤作者不能保证在其他场合能完全适用，敬请注意。

本文假定读者是在CentOS 4.x或 RedHat EnterPrise Linux 4.x平台上安装，并具有一定的Unix平台 / Linux平台系统经验，懂得rpm基本命令及常规的系统操作，如文件的删除，目录创建，改名，和vi编辑器的基本使用等。

文档目录

• ExtMail Solution概述
• 硬件配置
• 操作系统安装
• 下载ExtMail Solution软件包
• MTA-Postfix配置
• 配置Courier-Authlib
• 安装maildrop
• 配置Apache
• 安装Webmail-ExtMail
• 安装管理后台-ExtMan
• 配置图形化日志系统-mailgraph_ext
• 测试基本系统
• 配置Cyrus-SASL
• 安装Courier-IMAP
• 内容/病毒过滤
  准备工作
  ClamAV
  Amavisd-new
  配置Postfix
  测试
• 反垃圾邮件-Spam Locker
  准备工作
  配置/测试
  与Postfix结合
• 最终测试
• 附加信息
  增加FCGI支持
  编译Courier-IMAP
• 结束语
• 已知Bugs
• TODO列表

ExtMail Solution 结构

ExtMail Solution 是一个基于优秀开源软件的电子邮件系统解决方案，核心部件包括了Postfix, Amavisd-new, ClamAV, ExtMail 和ExtMan， Courier系列软件。是一个功能相对比较齐全的免费电子邮件系统。以下是其主要的特性列表：

• 支持SMTP/POP3/HTTP协议
• 支持SMTP认证及ESMTP
• 可支持大容量邮箱(大于1GB）
• 高速Web界面访问邮箱
• 完整的Web管理后台
• 在线服务端病毒过滤
• 内建内容过滤
• SMTP行为识别垃圾邮件
• 支持大量反垃圾邮件技术
• 图形化邮件日志分析
• 支持别名/多域/域管理员等
• 支持网络磁盘/POP3邮件
• 支持读/写HTML格式邮件
• 支持定制模板及多语言

整个邮件解决方案由如下软件组成：
 

功能模块	内容	备注
操作系统（OS）	CentOS 4.3	CentOS和RHEL是一样的，而且升级免费
邮件传输代理（MTA）	Postfix 2.3snapshot	使用2.3 snapshot，虽然不是最新但是对一般人而言足够用了
数据库/目录服务	MySQL 4.1	可选openLDAP或NetScape LDAP，本文以MySQL为蓝本
邮件投递代理（MDA）	maildrop 2.0.x	支持过滤和强大功能
Web帐户管理后台	ExtMan 0.16-pre1	支持无限域名、无限用户
POP3 服务器	Courier-IMAP	只使用pop3部分，对于大部分企业而言完全足够
WebMail 系统	ExtMail 0.24-pre8	支持多语言、全部模板化，功能基本齐全
防病毒软件（Anti-Virus）	ClamAV 0.88	最热门的开源杀毒软件
SMTP阶段反垃圾邮件工具	Spam Locker 0.083	基于SMTP行为识别的Antispam软件，大量可选插件
内容过滤器	Amavisd-new 2.40	Content-Filter软件，支持与clamav/sa的挂接
内容级别的反垃圾邮件工具	SpamAssassin	著名的SA，可以支持大量规则，但速度慢
SMTP认证库	Cyrus SASL 2.1x	标准的SASL实现库，可以支持Courier authlib
其他数据认证库	Courier Authlib 0.57	authlib是maildrop, courier-imap等服务的关键部件
日志分析及显示	mailgraph_ext	在ExtMan中已经包含了
Web 服务器	Apache 2.0.x	CentOS 自带

硬件配置

要流畅地运行邮件系统，建议的硬件配置如下：

• 物理内存：256M+ 推荐512M
• 交换区：2倍物理内存大小
• CPU：PIII 1G+ 推荐P4
• 主板：推荐Intel原装
• 网卡：100M/1000M 推荐3Com/Intel

操作系统安装

本文档支持RedHat Enterprise 4.x 及CentOS 4.x版本。要注意的是安装系统时，只安装如下的组件：

• Web Server
  要注意必须选中httpd-suexec软件包，否则下文的配置将失效
• MYSQL数据库
  注意必须选中mysql-server, libdbi-dbd-mysql, perl-DBD-mysql等模块，否则extmail将无法连接mysql
• VIM编辑器
  强烈建议安装vim-enhanced软件包，它支持main.cf彩色高亮语法分析

其余的Xwindows, 打印，KDE/Gnore, 服务器配置工具，网络工具，开发包等全部都不要选上。安装完毕进入操作系统后，建议禁止root直接登陆，并增加一个非root帐户，例如叫sysadmin。这样要以root权限操作的话，必须先以sysadmin身份登陆再su到root执行。方法：

CentOS4.3安装步骤图解

以下将以详细的图解来介绍如何安装CentOS4.3

CentOS启动光盘的启动画面，直接回车即可。

系统提示“是否需要校验CD媒质”，请选择“Skip”。

选择“English”作为安装界面的语言。

安装类型请务必选择“Custom”，以便之后详细选择要装的软件包。

磁盘分区设置请选择“Manually partition with disk Druid”（手工分区）。

如图，我们将/，/usr，/var，/var/spool/postfix等单独分成一个分区，注意：如果磁盘大小允许，请将/var/spool/vscan目
录也单独成一个分区，该目录主要存放被过滤的临时邮件。

配置网卡及子网掩码，记得点选“Activate boot”。

配置网关及DNS，请将离你的服务器最近DNS服务器IP地址填入“Primary DNS”。

防火墙配置时，打开防火墙（选Enable FireWall），并放行常规的服务（服务列表全选），最重要的是记得打开SELinux（选Active）

时区选“上海”。

输入root帐户密码，建议使用较长的密码，并混杂数字与字母及特殊字符。

进入软件组的选择对话界面后，我们只选择Editors组。

其次选择是Web Server及FTP Server组。

再次选择MySQL DataBase组，并点击右边的Details

在Details对话框里，确保libdbi-dbd-mysql，mysql-server，perl-DBD-MySQL等模块都被选中。extmail依赖这些软件包。

最后，确认一下所做的选择。其他没有被提到的软件模块/组全部都去掉。总共软件大小有814MB左右。

点Next后，安装系统提示必须要准备好CentOS的第1，2，3张光盘。

系统进行初始化，磁盘分区等。

系统安装到后面时，需要换安装盘。请将盘2及盘3按提示放入光驱。

安装完毕后，出现祝贺完成的界面，点Reboot重新启动。

如无意外，系统进入登陆提示符界面。至此，CentOS4.3的安装就结束了。

以root身份登进系统后，增加一个非root帐户，名称为sysadmin，密码按您的需求设置一个即可。接下来我们要禁止root直接登陆，编辑/etc/ssh/sshd_config 修改以下配置为：

然后重新启动sshd：

这样禁止了root直接登陆。

自从RHEL4/CentOS4以后，系统默认打开了SELinux支持，简单说SELinux就是一个强制性的安全机制，但是它也带来了不少麻烦，为了避免编写烦琐的policy规则，本文档将屏蔽掉SELinux对MySQL及httpd的保护。方法如下：

setsebool httpd_disable_trans=1setsebool mysqld_disable_trans=1

操作完毕后，重新启动mysql及apache，并将如下命令加入/etc/rc.d/rc.local以便服务器启动后能自动生效：

/usr/sbin/setsebool httpd_disable_trans=1/usr/sbin/setsebool mysqld_disable_trans=1/etc/init.d/mysqld restart/etc/init.d/httpd restart

下载ExtMail Solution软件包

基本假定

整个系统的安装全过程都要求以root身份执行，如果机器没有访问外部网络的能力，则事先下载好ExtMail Solution软件包，并用ftp以sysadmin帐户的身份，上载到服务器。

下载软件包

我们统一将软件包下载到/root目录里。

su - rootcd /rootwget http://www.extmail.org/source/ExtMail-Solution-Linux-0.1.tar.gz

校验

下载的文件必须校验确认过没损坏才能使用。命令如下：

wget http://www.extmail.org/source/md5sum.es_linux-0.1cat md5sum.es_linux-0.1md5sum ExtMail-Solution-Linux-0.1.tar.gz 

一个可能的结果：

# cat md5sum.es_linux-0.1168eced41c0cac0ed9f981e791f3783b ExtMail-Solution-Linux-0.1.tar.gz# md5sum ExtMail-Solution-Linux-0.1.tar.gz168eced41c0cac0ed9f981e791f3783b ExtMail-Solution-Linux-0.1.tar.gz

由于软件包不断的变更，所以上述结果和您的结果可能不一致，请以下载的md5sum为准

解压

目前最新的ExtMail-Solution软件包版本号为0.1，软件包文件名为：ExtMail-Solution-Linux-0.1.tar.gz，下载回来后，在/root目录解开：

此外，我们假设本次安装默认域是extmail.org，主机名为：mail.extmail.org，ExtMail Solution的文件目录是/root/ExtMail-Solution-Linux-0.1/

我们进入/root/ExtMail-Solution-Linux-0.1/目录，该目录下包括如下文件/目录：

conf/docs/RPMS/src/README

其中RPMS目录是本文的重点，里面包含了所需要的全部rpm包，src目录则是存放webmail, anti-spam等相关软件的源码，而README则是说明文件，docs目录则是本文档相关的html及图片。

下文所涉及的操作，绝大部分都是发生在/root/ExtMail-Solution-Linux-0.1目录里，请确保当前目录为：/root/ExtMail-Solution-Linux-0.1

配置Postfix MTA

删除冲突软件,sendmail，需要执行:

CentOS4.x/ RedHat EL4.x 都自带mysql-server，请用户自行安装好，包括mysql-client和devel等包

简化postfix配置:

postconf -n > /etc/postfix/main2.cfmv /etc/postfix/main.cf /etc/postfix/main.cf.oldmv /etc/postfix/main2.cf /etc/postfix/main.cf

再编辑main.cf：

增加如下内容：

# hostnamemynetworks = 127.0.0.1myhostname = mail.extmail.orgmydestination = $mynetworks $myhostname# bannermail_name = Postfix - by extmail.orgsmtpd_banner = $myhostname ESMTP $mail_name# response immediatelysmtpd_error_sleep_time = 0sunknown_local_recipient_reject_code = 450# extmail config herevirtual_alias_maps = mysql:/etc/postfix/mysql_virtual_alias_maps.cfvirtual_mailbox_domains = mysql:/etc/postfix/mysql_virtual_domains_maps.cfvirtual_mailbox_maps = mysql:/etc/postfix/mysql_virtual_mailbox_maps.cfvirtual_transport = maildrop:

内容如下：

user = extmailpassword = extmailhosts = localhostdbname = extmailtable = aliasselect_field = gotowhere_field = address

内容如下：

user = extmailpassword = extmailhosts = localhostdbname = extmailtable = domainselect_field = descriptionwhere_field = domain#additional_conditions = and backupmx ='0' and active ='1'

内容如下：

user = extmailpassword = extmailhosts = localhostdbname = extmailtable = mailboxselect_field = maildirwhere_field = username#additional_conditions = and active = '1'

配置Courier-Authlib

安装Courier-Authlib

运行如下命令安装相关软件包

rpm -ivh RPMS/libtool-libs-1.5.6-4.EL4.1.c4.3.i386.rpmrpm -ivh RPMS/courier-authlib-0.57-1hzq.i386.rpmrpm -ivh RPMS/courier-authlib-devel-0.57-1hzq.i386.rpmrpm -ivh RPMS/courier-authlib-mysql-0.57-1hzq.i386.rpm

编辑/etc/authlib/authmysqlrc文件，并将其内容清空，然后增加如下内容：

MYSQL_SERVER            localhostMYSQL_USERNAME          extmailMYSQL_PASSWORD          extmailMYSQL_SOCKET            /var/lib/mysql/mysql.sockMYSQL_PORT              3306MYSQL_OPT               0MYSQL_DATABASE          extmailMYSQL_USER_TABLE        mailboxMYSQL_CRYPT_PWFIELD     passwordMYSQL_UID_FIELD         uidnumberMYSQL_GID_FIELD         gidnumberMYSQL_LOGIN_FIELD       usernameMYSQL_HOME_FIELD        homedirMYSQL_NAME_FIELD        nameMYSQL_MAILDIR_FIELD     maildirMYSQL_QUOTA_FIELD       quotaMYSQL_SELECT_CLAUSE     SELECT username,password,"",uidnumber,gidnumber,\                        CONCAT('/home/domains/',homedir),               \                        CONCAT('/home/domains/',maildir),               \                        quota,                                          \                        name                                            \                        FROM mailbox                                    \                        WHERE username = '$(local_part)@$(domain)'

存盘退出后启动courier-authlib：

如一切正常，命令行将返回如下信息：

如果该目录权限不正确修改，maildrop及postfix等将无法正确获取用户的信息及密码认证：

安装Maildrop

如果您需要重新编译maildrop软件包，首先必须获得其源码rpm包，其次必须先装好courier-authlib及其devel软件包，否则编译maildrop之后将无法打开authlib支持。

rpm -ivh RPMS/maildrop-2.0.1-1hzq.i386.rpmrpm -ivh RPMS/maildrop-man-2.0.1-1hzq.i386.rpm

为了使Postfix支持Maildrop，必须修改/etc/postfix/master.cf文件，注释掉原来的maildrop的配置内容，并改为：

maildrop   unix        -       n        n        -        -        pipe    #flags=DRhu user=vmail argv=/usr/local/bin/maildrop -d ${recipient}    flags=DRhu user=vuser argv=maildrop -w 90 -d ${user}@${nexthop} ${recipient} ${user} ${extension} {nexthop}

由于maildrop不支持一次接收多个收件人，因此必须在main.cf里增加如下参数：

最后重新启动postfix即可

配置Apache

编辑httpd.conf：
在730行左右，屏蔽掉AddDefaultCharset：
使apache开机默认启动：

虚拟主机设置

编辑/etc/httpd/conf/httpd.conf文件，在最后一行加上：

NameVirtualHost *:80Include conf/vhost_*.conf

编辑/etc/httpd/conf/vhost_extmail.conf，里面定义虚拟主机的相关内容，包括主目录，以及ExtMail和ExtMan的相关配置，Suexec的设置等。

# VirtualHost for ExtMail Solution<VirtualHost *:80>ServerName mail.extmail.orgDocumentRoot /var/www/extsuite/extmail/html/ScriptAlias /extmail/cgi/ /var/www/extsuite/extmail/cgi/Alias /extmail/ /var/www/extsuite/extmail/html/ScriptAlias /extman/cgi/ /var/www/extsuite/extman/cgi/Alias /extman/ /var/www/extsuite/extman/html/# Suexec configSuexecUserGroup vuser vgroup</VirtualHost>

重新启动apache:

注意：此时重新启动apache会产生以下警告信息，可不必理会

安装ExtMail

建立/var/www/extsuite并复制源码到该目录，相关命令：

mkdir /var/www/extsuitecp -r src/extmail-0.24-pre8 /var/www/extsuite/extmailcd /var/www/extsuite/extmailcp webmail.cf.default webmail.cfcd $OLDPWD

注意：上面命令行中最后一个cd $OLDPWD是返回原始路径（即ExtMail Solution软件包根目录）

用vi打开/var/www/extsuite/extmail/webmail.cf，并按2次ESC键以确保进入命令模式，然后输入：

:1, $ s#/var/www/cgi-bin#/var/www/extsuite#g

上述命令的作用是将默认路径从/var/www/cgi-bin下换到/var/www/extsuite下，处理完毕后，修改webmail.cf里的其他参数，主要变动的内容见下：

SYS_USER_LANG = zh_CNSYS_USER_CHARSET = gb2312SYS_MFILTER_ON = 1SYS_NETDISK_ON = 1SYS_MYSQL_USER = extmailSYS_MYSQL_PASS = extmailSYS_MYSQL_DB = extmailSYS_G_ABOOK_TYPE = fileSYS_G_ABOOK_FILE_CHARSET = gb2312

其中SYS_MFILTER_ON及SYS_NETDISK_ON 设置为1是为了打开网络磁盘和过滤器。全局地址本默认为ldap格式，现在也改为文本格式，并将地址本的转换编码改为GB2312

由于SuEXEC的需要，必须将extmail的cgi目录修改成vuser:vgroup权限：

安装ExtMan - web后台

在ExtMail-Solution软件包根目录下执行：

cp -r src/extman-0.16-pre1 /var/www/extsuite/extman/

用vi编辑/var/www/extsuite/extman/webman.cf，并连按2次ESC，确保进入命令模式，然后输入如下命令：

:1, $ s#/var/www/cgi-bin#/var/www/extsuite#g

处理完毕后修改SYS_CHARSET及SYS_LANG参数为：

SYS_CHARSET = gb2312SYS_LANG = zh_CN

其他参数基本上可以使用默认值。

由于SuEXEC的需要，必须将extman的cgi目录修改成vuser:vgroup权限：

在执行mysql操作前，必须确认它已被正确安装并启动，可以用rpm命令查询mysql server的安装情况，用ps ax的办法查看进程列表是否有mysqld进程：

正常情况下应该可以看到mysql-server被安装：

如果没有，则表示没有安装好mysql-server，可以从本软件包RPMS目录里安装，也可以找安装光盘安装：

安装完毕后必须初始化mysql，然后重新启动

/usr/bin/mysql_install_db/etc/init.d/mysqld start

正常情况下将启动成功：

Starting MySQL:                                            [  OK  ]

然后用ps命令来检查mysqld是否正确运行：

正常情况下应出现如下的结果：

如果mysql没正确启动，请检查/var/log/mysqld.log里面的出错提示，进行处理：

执行以下命令导入mysql数据库结构及初始化数据，注意必须逐行输入以下命令，root密码默认为空，不可直接用鼠标复制两行命令直接输入，否则会报错！

mysql -u root -p < /var/www/extsuite/extman/docs/extmail.sqlmysql -u root -p < /var/www/extsuite/extman/docs/init.sql

由于ExtMan的体系与ExtMail比较类似，因此ExtMan需要使用ExtMail中几个基础perl 模块，在extman的源码包里，包含了一个叫buildlink.sh 的小脚本，该脚本完成了这些链接的工作，使用方法：

cd /var/www/extsuite/extman/libs/Ext./buildlink.sh build /var/www/extsuite/extmail/libs/Extmkdir /tmp/extmanchown -R vuser:vgroup /tmp/extmancd $OLDPWD

操作完毕后，需要建立刚才导入mysql的test@extmail.org帐户的Maildir，请输入如下命令：

cd /var/www/extsuite/extman/tools./maildirmake.pl /home/domains/extmail.org/test/Maildirchown -R vuser:vgroup /home/domains/extmail.orgcd $OLDPWD

注意事项：

上面命令行中最后一个cd $OLDPWD是返回原始路径（即ExtMail Solution软件包根目录）

由于RedHat发行版中包含了一个叫tmpwatch的工具，该工具会定期扫描/tmp/下的文件，如果这些文件很久都没被使用，将被删除，因此如果后台长期不使用，/tmp/extman目录有可能被tmpwatch删除，所以要么定期登陆后台，要么修改 webman.cf将临时目录修改到另一个地方。此处暂以/tmp/extman默认值为例。

在命令行下执行：

结果如下：

Authentication succeeded.     Authenticated: test@extmail.org  (uid 1000, gid 1000)    Home Directory: /home/domains/extmail.org/test           Maildir: /home/domains/extmail.org/test/Maildir/             Quota: 5242880Encrypted Password: {crypt}uywiuN.XggXXcCleartext Password: test           Options: (none)

这样表明ExtMan的正确安装，数据库也正确导入，courier-authlib能正确连接到mysql数据库

最后访问http://mail.extmail.org/extmail/，如无意外，将看到webmail的登陆页，不过此时还没有加正式的用户，所以不能登陆，包括test@extmail.org也不行。必须要登陆到http://mail.extmail.org/extman/ 里增加一个新帐户才能登陆。

ExtMan的默认超级管理员帐户是root@extmail.org，密码是extmail，登陆成功后，建议将密码修改，以确保安全。

配置Mailgraph_ext

自ExtMan 0.14-pre2 开始，系统集成了Mailgraph_ext插件，该插件使extman具备图形化显示邮件日志的能力。mailgraph_ext融合了mailgraph和queuegraph两个软件包，除增加了更多的日志分析及图形显示能力外，还重写了web模块，集成到ExtMan后台里，这样邮件日志将只能给经过授权的用户查看，提高了安全性。

mailgraph_ext及Extman都需要安装rrdtool工具

- Perl 5.6+ (建议5.8以上)- rrdtool 及rrdtool的perl包，地址：  http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/- File::Tail (还需要Time::HiRes模块)

RHEL/CentOS一般自带了perl-Time-HiRes(1.5x)所以以下的rpm安装也许会报错（提示冲突），可以不必理会。如果想安装本文所带的新版Time-HiRes模块，可以用如下命令删除系统自带的包：

rpm -ivh RPMS/rrdtool-1.2.12-1hzq.i386.rpm RPMS/perl-rrdtool-1.2.12-1hzq.i386.rpmrpm -ivh RPMS/perl-Time-HiRes-1.72-1hzq.i386.rpmrpm -ivh RPMS/perl-File-Tail-0.99.3-1hzq.i386.rpm

执行以下命令：

注意事项：

本文使用qmonitor来搜集队列数据，而不是使用crontab来定时提取，这与官方网站上的文档有差异。使用qmonitor的好处是它实时的监视队列目录的变化，显示的结果更加精确。