vpopmail 管理员手册
原作者：Ken Jones
原文链接：http://inter7.com/vpopmail/vpopmail.html
英文版权所有：http://inter7.com ;
译者：黄丽红
联系地址：kinki@freebsdchina.org
中文版权所有：freebsdchina.org (如要转载请保留版权声明)
快速安装指南
快速安装vpopmail
解开vpopmail 分发包
添加vchkpw 组
添加vpopmail 用户，并指定为vchkpw组
./configure
make
make install-strip
现在可以添加虚拟邮件域和虚拟邮件域用户。使用vadddomain 和 vadduser.。还须要修改你的pop 服务器的启动参数以使用vchkpw 程序来认证用户。
.设置所有的邮件用户成为虚拟邮件域的用户
我们推荐所有的邮件域都设置为虚拟邮件域。
配置选项
常用选项
(1)--enable-roaming-users=n|y Enable or dissable open relay after pop authentication.Default is no
配置这个选项为Yes意味着客户端的IP地址是添加到一个IP地址列表中，用于允许用户在他们的pop认证通过以后利用smtp转发信件。服务器端有一个cron job ：clearopensmtp，会从这个IP 地址列表中清除认证超过3个小时的IP地址。这个选项需要你以tcpserver的方式运行smtp,并且提供-x /etc/tcp.smtp.cdb 参数(或者其它你放置tcp.smtp.cdb文件的路径)。
(2)--enable-hardquota=#|n Set and Enable hard quota or n for no quota
为每个pop用户设置磁盘配额的最大值（硬）。默认值为50M。当用户的磁盘配额的最大值达到以后，所有新的发给用户的邮件将会被退回，并附上一条信息。这条信息可以被自定义定制。假如你想关掉磁盘配额设置，可以设置这个值为：NOQUOTA，例如 --enable-hardquota=NOQUOTA
(3)--enable-default-domain=name Default domain name, default is null
我们推荐把所有的邮件以虚拟邮件域的方式运行。你可以设置其中一个为缺省。如果你只有一个域，那么把它设置为缺省。缺省设置的邮件域的用户可以直接用用户名进行认证,即不需要使用用户名%虚拟邮件域的格式。
(4)--enable-ip-alias-domains=y|n enable virutal domain lookup via reverse ip address lookup for virtual domains.
每个域缺省都使用基于虚拟邮件域的用户名。也就是说：用户必须提供包含所属的域的名称的用户名，例如：用户名 %虚拟邮件域。这也可以通过设置--enable-default-domain option来覆盖这个规则。
Vpopmail也支持基于IP地址的虚拟邮件域。假如这个选项打开后，而用户没有提供%<虚拟邮件域>，那么就会触发一个对用户连接的服务器的IP地址的反向查询。如果服务器的IP地址能解析到一个域名，那么vpopmail使用那个域名做为邮件域。例如：
IP地址 w.x.y.z反向解析到test.com。用户设置他们的pop服务器的IP地址为w.x.y.z 并开始连接。vpopmail接收到这个连接，检查连接的服务器端的IP地址。做一个IP地址的反向查询从而获得test.com这个域名。用户 发送joe作为他们的pop用户名，vpopmail使用test.com作为域名。
你可以混合使用基于名称和基于IP地址的形式的虚拟主机。
(5)--enable-relay-clear-minutes=360 expire time for roaming users after pop authentication.
如果设置了--enable-roamin-users=y 选项，那么这个选项就设置了clearopensmtp应该保留用户的IP地址在列表中多长时间。默认值是3小时。
Mysql选项
(1)--enable-mysql=n|y use mysql, default is no
启用mysql认证方式。
注意：确认编辑vmysql.h以及设置mysql 服务器名称或者IP地址，mysql用户和mysql用户密码。这个mysql用户必须有创建vpopmail数据库和在此数据库里生成表的权限。
(2)--enable-sqlincdir= Directory where sql include files are.
设置mysql include文件的目录位置。默认值是设置为/usr/local/mysql。
(3)--enable-sqllibdir=/usr/lib/mysql Directory where sql libs are.
设置mysql libmysqlclient.a文件所在的目录。默认的会在/usr/lib/mysql中查找。
(4)--enable-sqllibs=mysqlclient libraries for sql linking.
设置连接的库。默认会是libmysqlclient.a
(5)--enable-large-site=n|y Default is no, tune for large numbers of users per domain
默认的，vpopmail放置所有的域信息在一个vpopmail表中。这是维护很多邮件站点的最有效的方法。假如你在运行一个有大量用户的站点，你也许会想设置这个选项为YES。假如设置为YES，vpopmail会为每个虚拟域生成一个表。主要的不同在于域名不存储在数据库中，因为表名包含了域名。对有500,000+用户的站点来说，这种设置可以节省非常有价值的硬盘空间。然而，对于有大量的邮件虚拟域的站点来说，这会导致mysql系统性能的降低。
Vpasswd/cdb 选项
(1)--enable-ucspi-dir=dir Directory where the compiled ucspi package is.
设置uspi-tcp包所在目录。默认设置为../ucspi-tcp-0.84。vpopmail使用在目录中的headers以及两个.a文件。
Logging选项
(1)--enable-logging=e|y|n Turn on (y) or off (n) logging to syslog or (e) only log errors
设置日志纪录的等级。默认只记录pop认证错误。可以通过设置此选项为no，以关闭所有日志记录。也可以通过设置此选项为YES记录所有的pop认证。
(2)--enable-log-name=vpopmail set syslog name.
覆盖默认的vpopmail系统日志名称。
User/group 选项
(1)--enable-vpopuser=vpopmail user vchkpw was installed as.
假如基于某个原因你希望用一个不同的用户安装这个软件，那么使用这个选项。
(2)--enable-vpopgroup=vchkpw group vchkpw was installed as.
假如基于某个原因你希望用一个不同的组安装这个软件，那么使用这个选项。
(3)--enable-admin-email=email-address e-mail of system administrator.
覆盖默认的管理员邮件地址。
Directory and file location 选项
(1)--enable-tcpserver-file=/etc/tcp.smtp File where tcpserver -x relay information is stored.
设置你的tcp. smtp文件名。默认的设置程序在/etc中查找，然后再在/etc/tcprules.d目录查找。
(2)--enable-qmaildir=dir directory where qmail is installed.
假如在其它的目录中安装了qmail，而不是在/var/qmail，那么使用这个选项。
(3)--enable-tcprules-prog=/usr/local/bin/tcprules where is your tcprules program.
假如在其它的目录中安装了tcprules程序，而不是在/usr/local/bin，那么使用这个选项。
(4)--enable-apop-file=/etc/apop-secrets directory where apop secrerts are stored.
覆盖默认的apop-secrets文件的位置。
其它选项
(1)--enable-apop=y|n Enable or disable apop authentication.
通过设置这个选项为NO来禁用apop。默认为YES(pop and apop)。
(2)--enable-passwd=y|n Enable or disable /etc/passwd (or shadow) authentication.
覆盖默认的自动设置。默认的配置程序自动检测你的系统是否使用passwd 和 shadow passwords。通过设置这个选项为NO，你将禁止所有的/etc/passwd 认证。
Qmail 和 虚拟邮件域
qmail的邮件域有本地的和虚拟的两种分别。本地的邮件域是使用/etc/passwd 作为验证文件。而虚拟邮件域则以qmail的控制文档“virtualdomains”为依据。vpopmail使用qmail用户/认证文档和虚拟域文档。其中用户/认证会合并到一个user/cdb数据库内。user/cdb是一个hash数据库，用以加快匹配项的查询。如果一个项匹配到，那么qmail的发送程序将会投递邮件到在文件中定义的目录中去，并且使用预定义好的uid和gid进行投递操作的身份。Vpopmail使用这个方法来使qmail 投递程序使用单一的vpopmail用户和vchkpw组来投递所有的虚拟域的邮件。同时也使用它来直接投递邮件到/vpopmail/domains/虚拟邮件域目录中。
一旦qmail-local程序从users/assign获得信息，他会执行在目录中的标准的.qmail文件。一般来说，.qmail-文件可以用于转发，别名或者调用程序，例如ezmlm。如果没有匹配的项目，则qmail-local会查找一个.qmail-default文件。这是qmail-locals发送机制的最后一步。这个程序使用两个参数，第一个并不使用（只是为了向后兼容）。第二个参数是指定了如果一个虚拟
