Postfix + Cyrus-SASL + Cyrus-IMAPD + PgSQL HOWTO

[附言]
该附言或许不成其为什么许可证，但还是希望您尊重作者的愿望。
如果您发现有什么错误，请及时通知我，我将尽快作出修改。如果您在网上转载，那将是免费，但希望您附上本附言，并且注明出处的链接。如果您要把它用印刷物形式出版，请通过www.cnfug.org跟本人接洽。
您在以本文作为根据配置电脑的时候，若出现任何故障，后果自负，与本作者无关。

目标
本文的目的是在于说明如何在FreeBSD的环境下面搭建一个邮件系统。这个邮件系统支持虚拟用户，提供IMAP服务，可以成为构成WebMail系统的基础。
支持IMAP服务的Webmail有著名的IMP和SquirrelMail等等。
本文虽然是用PgSQL作为后台数据库，但是仍然对使用MySQL，LDAP数据库的作为后台的类似邮件系统有启发作用。如果仔细阅读本文，一定会有所收货的。使用其他后台数据库的话，要修改的地方有两处：pam服务和main.cf的virtual_mailbox_maps项。
本文所有的调试是在FreeBSD-4.8 release上通过的，也对FreeBSD-5作了额外的说明，主要的差异是集中在pam服务的配置不同而已，希望能有所帮助。
Linux的用户也能可以参考本文的配置，您只需要留意路径和pam服务的配置。pam服务配置跟FreeBSD-5类似。

零、阅读准备

1)阅读本文需要一定基础，我假设你已经清楚以下的东西：
邮件系统的基本原理，邮件系统的相关协议的作用，例如smtp,pop3,imap。

2)什么是SASL：
SASL的英文全称是Simple Authentication and Security Layer，简单验证和安全层。
SMTP协议并没有提供用户验证功能，很容易匿名中转邮件。即使限制了可以转发的网段，也不安全。他的定义是： a method for adding authentication support to connection-based protocols，为基于连接的协议提供认证功能。

3)软件的角色：

Postfix：充当MTA，就是smtpd，作为邮件转发用。

Cyrus-SASL：分成两部分
a)Cyrus项目的SASL lib，Postfix使用SASL需要用到的lib。
b)Cyrus-saslauthd，一个SASL的验证后台程序。

Cyrus-IMAPD：
提供IMAP服务，提供邮件读取和管理邮箱的作用。

cyradm：
这个不是一个独立的软件，安装Cyrus-IMAP的时候会自动安装上去的。它的作用是创建和管理邮箱。

PgSQL：后台数据库，存放用户的密码等等。

总的来讲，Postfix充当转送邮件的服务；Cyrus-IMAP充当提供邮件读取、管理的服务；SASL使用验证服务。

4、Cyrus-SASL和Cyrus-IMAPD不是同一样东西
就跟Microsoft Visual C++和Microsoft Office不是同一个东西一样

一、本系统的工作原理和结构
注意是本系统。实现一个邮件系统有很多种方式，即使你用的都是跟本系统完全一样的软件，也有不同的实现方式。
本系统的邮件主机是:
f4.room
f4是因为fbsd-4，域为room：是因为电脑放在房间里头。您要看不顺眼，就把本文的f4.room都换成example.com算了。

I、Postfix的担任的工作的部分：
1、这个是投递邮件的时候的用户验证的部分：

 |------------------------|
 |     Postfix            |
 |                        |
 | |-------------|        |
 |-| Cy-SASL-lib |--------|
   |             |    
   |-------------|    
        |             
        |             
   |--------------|   
   | Cy-saslauthd |   
   |--------------|   
        |             
        |             
   |-------|          
   |  PAM  |          
   |-------|          
        |             
        |             
 |-----------------------|
 |    PostgreSQL         |
 |-----------------------|

图例说明：
当有程序访问smtp服务(TCP端口25)的时候，Postfix会给出220 ESMTP的回应，提示是要验证的smtp服务。密码和用户名提交给Postfix以后，Postfix会把密码和用户名通过调用Cy-SASL lib提交给一个后台验证程序：Cy-saslauthd。Cy-saslauthd会调用PAM模块进行验证。PAM模块会调用名为smtp的PAM服务名进行验证。在本系统中，PAM服务是调用pam_pgsql访问PostgreSQL进行验证的。然后结果再Return回去。

2、邮件转送：
分成三种情况：
1)如果邮件是给非本域用户的，例如是21cn.com的，马上就转发过去了。

2)如果邮件是给本域虚拟用户的，Postfix要访问PgSQL，来看看本域是否有这个虚拟用户。有就转发到他的虚拟邮箱，没有就把邮件defered掉。（什么是defered？待查，估计是砍掉的意思）
Postfix <--> PostgreSQL

3)如果是本域的本地用户，就转发到本地用户的邮箱，就是/var/mail/username那里。
Postfix <--> /etc/passwd

II、Cyrus-IMAP担任的工作部分
1、邮件的获取：
Cyrus-IMAPD有他自己的一套管理邮件的方法，不是用传统的unix邮箱方法(/var/mail/username)，但是邮箱的读取十分高效。当Postfix获得目的地是本域的虚拟用户的时候，我们设置Postfix内置支持的一个功能：调用Cyrus-IMAP的一个程序，将邮件“拿”过来放到由Cyrus-IMAPD管理的邮箱里头。

2、用户的验证。
当用户要读取自己的邮件的时候，要通过IMAP服务。本系统配置了Cyrus-IMAP通过Cyrus-saslauthd进行验证。其原理大概同Postfix验证用户的原理一样。

 |------------------------|
 |     Cyrus-IMAPD        |
 |                        |
 | |-------------|        |
 |-| Cy-SASL-lib |--------|
   |             |    
   |-------------|    
        |             
        |             
   |--------------|   
   | Cy-saslauthd |   
   |--------------|   
        |             
        |             
   |-------|          
   |  PAM  |          
   |-------|          
        |             
        |             
 |-----------------------|
 |    PostgreSQL         |
 |-----------------------|

III、PgSQL存储的数据
现在把PgSQL存储的数据再总结一下。
PgSQL主要存储两部分数据：
1)虚拟用户的用户名和密码。这部分是提供验证用，从saslauthd通过PAM服务访问。

ID  | usr   | pass  | expired | newtok
----+-------+-------+---------+--------
 1  | test1 | pass1 | f       | f
 2  | test2 | pass2 | f       | f

2)用户的地址和对应的信箱。这部分是Postfix访问的，从中获得邮件地址和邮箱的映射关系，然后根据邮件地址转发到相应的邮箱。

ID  | addr           | box
----+----------------+------------
 1  | test1@f4.room  | test1
 2  | test2@f4.room  | test2

在本系统中，实际上是两个表，为了方便大家看，就将他拆分成两个表。
其实使用两个表来存储这些数据的做法从安全角度是可取的。我们比如说我们分别建立两个数据库用户：postfix和saslauthd，他们只是对自己可以访问的表有读权限。另外我们再建立一个视图，把两个表关联起来，超级用户对这个视图有读取使用的权限，来进行管理。
本文为了方便调试，只是建立一个表。

二、安装软件
请务必使用port来安装，因为这不仅影响到你编译成功率，更影响到以后的配置。因为你直接下载源码包编译安装的路径可能不一样

0.PostgreSQL
路径/usr/ports/databases/postgresql7
make install
注意，这个路径下的是pgsql 7.3

1.Postfix:
路径 /usr/ports/mail/postfix
make install，然后会出现一个编译选项的菜单，选择Cyrus-SASL2和PgSQL的支持。PgSQL的支持可能有两种，一个是7.3，一个是7.2，请根据的PgSQL服务器选择。

2.Cyrus-SASL2:
由于上面安装Postfix的时候，选择了Cyrus-SASL2支持，编译Postfix的时候，会自动下载Cyrus-SASL2进行编译安装，所以Cyrus-SASL2不需要安装。

3. Cyrus-sasl-saslauthd
路径：/usr/ports/security/cyrus-sasl2-saslauthd/
make install

4. Cyrus-imapd-2.1.14
路径：/usr/ports/mail/cyrus-imapd2/
make install

三、配置软件
零、配置PgSQL和pam服务
1、建立一个叫做mail的数据库。
2、建立一个叫做mailuser的表。
结构如下

ID  | usr   | pass  | expired | newtok | addr          | box   
----+-------+-------+---------+--------+---------------+--------
 1  | test1 | pass1 | f       | f      | test1@f4.room | test1 
 2  | test2 | pass2 | f       | f      | test2@f4.room | test2 

3、在PgSQL里头建立一个数据库用户mail，密码mail
4、创建一个/etc/pam_pgsql.conf

在/etc/pam.conf里头加上以下几行。

注意，如果的是Freebsd-5和linux，他们的配置有不同：
不用设置/etc/pam.conf，而是在/etc/pam.d/smtp和/etc/pam.d/imap里头加上

Part I、配置Postfix + SASL
[目标]

I、配置Postfix + SASL验证，并且组建一个虚拟用户的环境。
比如说：user@f4.room
user并不是FreeBSD上的本地用户，而是一个虚拟的用户。用户的认证信息是存储在数据库的。

零、域名的处理
相信很多朋友跟我一样，没有一个FQDN(Full Qualiefied Domain Name)。虽然没有域名，我们仍然可以玩Postfix。
先在/etc/hosts添加你的域名。我的域名设置为f4.room，而我的IP是192.168.1.10，所以我的文件是这样的：

注意，这里的域名f4.room，是我以后在main.cf用到虚拟用户的域名，virtual_mailbox_domainsd的那项。

一、Postfix
要Postfix正常运行，必须先要把Sendmail禁用。
/etc/rc.conf里头加入一行

然后做一个连接

看到freebsd的port的好处了吗？他可以让你保留原有的sendmail。
Postfix也有一个程序叫做sendmail。如果用源码安装，会把Postfix安装在/usr/sbin里头，那么就会把sendmail覆盖掉了。用Port来安装，它会遵守freebsd的hier(目录结构)，将软件都装在/usr/local/下面的sbin/,bin/,lib/,libexe/目录里头，不会跟系统的冲突。
哪天您老人家不高兴，想玩玩sendmail，先pkg_delete了postfix，然后修改/etc/rc.conf，把sendmail="NONE"改成"YES"，就可把sendmail请回来了。

Postfix的配置文件在/usr/local/etc/postfix/
1、master.cf
更改以下两项：
1)搜索smtp的一行，然后改为

2)修改cyrus的安装路径
将argv=.....一项改为argv=/usr/local/cyrus/bin/deliver
结果如下：

2、main.cf

#本地用户的设置

3、创建一个pgsql-mailbox.cf

4、建立相关的目录
确保你有root权限哦

二、配置Cyrus-SASL

然后做一个连接
ln -s Sendmail.conf smtpd.conf

好现在做一个测试：
先获取plain字符窜。为了获得plain字符串，必须要用base64编码。我安装了一个perl的mod来产生这个base64编码。

结果： 一般的格式是：

他的port在/usr/ports/converters/p5-MIME-Base64/

测试：

出现235 Authentication successful，就表示你的机器成功使用postfix + sasl 认证了。
注意，一定要打ehlo hostname，否则就不会出下面的东西了。

三、调试发信给虚拟用户

如果成功的话，/var/mail/vhost/test1大小为非0，而且你可用cat、less等工具把文件的内容读出来读出来。

四、一个小小的Bug
首先声明，这个Bug不是postfix的，应该是我的配置的。
不知道为什么，根据以上的设置，在本机上写信给本地用户，例如powerplane，地址必须是：
powerplane@localhost.my.domain。
其他地址，如：powerplane@localhost，他会当把powerplane@f4.room处理。
估计是main.cf和/etc/hosts上没有配置好。哪位高人，请指点一下？

Part II、配置Cyrus-IMAP
1、编辑/usr/local/etc/imapd.conf，这个是Cyrus-IMAP的配置文件
内容应该如下：

2、运行/usr/local/cyrus/bin/mkimap。
他会自动读取/usr/local/etc/imapd.conf，自动创建/var/imap，/var/spool/imap等等所需要的目录的。

3、启动Cyrus-IMAPD。
使用Port来安装Cyrus-IMAP，它会在/usr/local/etc/rc.d创建一个启动脚本的，名字为：imapd.sh.sample。你要把它改名为imapd.sh，在启动系统时后他才会自动执行。如果它没有运行，你也可人工启动它：
/usr/local/etc/rc.d/imapd.sh start

4、建立Cyradm模块的需要的用户数据库：sasldb2。
1)创建sasldb2数据库，并且创建管理员cyrus。

2)创建用户邮箱：
Cyrus-IMAP是自己管理邮箱，创建邮箱必须通过cyradm来创建。
下面通过cyradm工具来创建邮箱。
cyradm --user cyrus localhost 是用cyrus用户，登陆到主机localhost。
cm是创建邮箱
lm是列出邮箱

使用imtest来测试

出现上面字样表示登陆成功，打. logout退出。

Part III、整合Postfix和Cyrus-IMAP
你前面的设置和调试都顺利通过了吗？好到这一步了，只需要改一个文件。

别忘记重新启动你的postfix

好赶快测试一下吧

咱们用一个支持IMAP的客户端收信吧，试试能不能成功？用户名用test1，密码是pass1。

总结
如果使用port的时候，有什么不明白，不懂的时候，可以参考具体软件的port目录里头的pkg-message，里头有关于该软件的一些简单说明和配置。当然不是每个port都有的。
我的建议是：不要期待一篇HOW-TO就让你明白所有东西，你还是要作作功课的。
下面提供一些文档作为参考，有些文档是在你安装port以后，在本机上的，当然在源码包肯定也有。

Postfix的virtual domains入门：
http://www.freebsddiary.org/postfix.php

Postfix的虚拟用户设置：
/usr/local/share/doc/postfix/VIRTUAL_README

Postfix的一些官方文档，教你如何跟Cyrus-SASL2和Cyrus-IMAP2整合：
http://www.postfix.org/docs.html

FreeBSD上面的PAM配置：
http://www.freebsd.org/doc/en_US.ISO8859-1.../pam/index.html

下面的是Linux为目标系统的，我也参考过。如果您仔细阅读过他们和本文，就明白FreeBSD的hier和Port系统的好处。
Postfix-Cyrus-Web-cyradm-HOWTO：
http://www.delouw.ch/linux/Postfix-Cyrus-W...html/index.html

Postfix + Cyrus-IMAP + Cyrus-SASL + MySQL + IMP的中文HOWTO
http://www.cngnu.org/technology/Postfix_I.html

,