翻译：Jerry Zhou (Jerry underline ZhiJun(@)21cn.com)
原始版权由作者Dave Sill拥有
中文翻译版使用权由原作者和翻译者共同所有, 请不要用于商业用途.
转载, 刊登, 摘录请首先取得原作者和译者的同意

中文版上一版为2003年8月16日, 这个旧版本的讨论和取得请访问这里:lwq2003.justso.cn,
这个版本的讨论主页设在linuxforum 的邮件和DNS服务器版面,可以访问这里到达 lwq2006.justso.cn.
本文为完整的中文版本. 这个版本由Dave Sill收藏于http://www.lifewithqmail.org/.

谨以此翻译的劳动致谢我的父母, 姐姐一家以及很多朋友和同事.
也可以通过我的blog地址找到我: www.justso.cn

紫色小字号为译者注, 包括英文原文考量和一些基础知识.
文中将统一应用英文逗号(,) 和句号(.) 以及引号(")等英文标点符号.

如果哪位港台同胞乐意制作Big5码的版本, 请和我联系.Jerry underline ZhiJun(@)21cn.com. 如果你对里面翻译的文字有任何意见和商榷, 请e-mail译者, 我们一起来把LWQ翻译的更好! 给译者信箱发送邮件, 请指定标题为"For Translations of LWQ". 否则将被作为垃圾邮件处理, 不情之请, 希望见谅.

中文翻译版本: 2006-4-14
下面是这个版本和2003-8-16版本相比的更新修正:

1. 介绍

1.1. 适合阅读本文的读者

Life with qmail 的目标读者是那些对qmail有兴趣, 却被归类于业余爱好者, 新手的人, 那些在一台空闲(原文为: a spare PC 译者注)PC机上操作Linux, 希望日后成为经验丰富的系统管理员或邮件系统管理员的人写作的. 如果你发现文章中有缺陷或者不清楚的地方, 请用电子邮件告诉我. (英文) lwq at sill dot org. (译者的电子邮件: Jerry underline ZhiJun(@)21cn.com 译者注).

各种不同的来源存在着丰富的 qmail相关信息. 其中一些是以新手为目标, 另外一些假定读者具有比较多的经验, Life with qmail 就是一篇试图成为"胶水"性质的文章, 集合这些信息为一体, 不过读者必须首先掌握下面这些基础知识:

在UNIX环境下熟练的操作文件和目录的能力
会使用web浏览器和FTP客户端软件
能够读懂下面的使用方法

1.2. 什么是 qmail?

qmail是一个因特网邮件传送代理, (英文: Mail Transfer Agent, 简写为MTA, 译者注) 它运行在UNIX兼容系统下, 是一个直接代替UNIX下 Sendmail软件的邮件传送程序. qmail 使用简单报文传送代理协议 SMTP 传输邮件(Simple Mail Transfer Protocol).

注意: 它的名字是 "qmail" , 而不是 "Qmail".

1.3. 为什么用 qmail?

你的操作系统如果包含一个MTA, 那很有可能是Sendmail, 而你阅读了下面的文档之后, 你可能想(抛弃Sendmail, 另外)找一个更好的MTA了.

1.3.1. 安全

qmail 是面向安全而设计的. Sendmail 的历史上出现过很多严重的安全问题. 在编写Sendmail的时代, 网络是非常友好的地方, 每个在网上交流的人都能够很容易的了解对方, 几乎没有必要为了安全而设计软件, 编写代码. 而现在的因特网对于网络服务器却是险象丛生. Eric Allman, Sendmail的作者, 和目前的维护者Claus Assman 为了加强Sendmail的安全做了很多工作, 但是无论如何, 除了重新设计, 怎样的修正也不能让Sendmail达到真正的安全.

1.3.2. 性能

qmail 并行处理邮件传送, 缺省配置情况下, 能够达到20个并行邮件同时传送.

1.3.3. 可靠性

qmail保证已经接收的新邮件不被丢失, qmail使用一种新的邮箱格式, 其可靠性超过了没有文件锁的NFS存储系统.

1.3.4. 简单Simplicity

qmail 比其他实现同样功能的MTA都要小.

注意: qmail 的正式主页, http://cr.yp.to/qmail.html 有更多的 qmail 特色介绍.

1.4. 发展历史

qmail由 Dan Bernstein (DJB)编写, 关于他可以参考这里http://en.wikipedia.org/wiki/Daniel_J._Bernstein. 他现在任职于 Illinois 大学 Chicago 分校数学教授. 它在密码术研究方面的工作, 以及他关于密码术源代码的出版问题对美国政府的诉讼也是很有名的, 关于这次诉讼的情况详见 http://en.wikipedia.org/wiki/Bernstein_v._United_States 或 http://cr.yp.to/export.html 查看关于诉讼的信息. (可能wikipedia在中国大陆无法访问, 请参考使用代理或其他方式. 译者注)

第一个公开发行的 qmail 版本是1996年1月24日发表的 0.70 beta 版. 第一个 gamma 发行版是在1996年8月1日的0.90版.

第一个常规发行版本是1.0, 时间是1997年2月20日. 现在使用的1.03版本, 发行于1998年6月15日.

预期下一个版本将是2.0评估版, 即将在2.0版里面出现的一些新功能可以在http://cr.yp.to/qmail/future.html 找到.

1.5. 特点

qmail 的web页 http://cr.yp.to/qmail.html 列出了非常全面的qmail的特点. 本节即针对这个页面列出的特点予以着重介绍.

1.5.1. 安装

自动适应于UNIX的各种版本
自动适应于单主机配置
快速安装--不必作大量的配置工作

1.5.2. 安全

地址, 文件以及程序之间分隔清晰
最少限度的应用setuid编码
最少限度的应用root编码
五个不同权限信任级别区隔运行(指利用五个分隔的uid运行qmail的不同功能模块. 译者注) --深入的安全保障
可选的邮件单向散列计算功能, 包括整个邮件内容的hash计算等功能. (参考附录 E 的什么是 QUEUE EXTRA?)

1.5.3. 邮件结构

符合RFC 822 和RFC 1123 标准.
邮件地址组的完整支持.
自动转换旧格式地址为RFC 822 格式.
支持sendmail命令, 与目前的邮件用户代理兼容.
仅受限于内存大小的长邮件头支持.
主机伪装(参见 defaulthost)
用户伪装(参见 MAILUSER和 MAILHOST)
自动生成邮件跟踪列表(参见 QMAILMFTFILE )

1.5.4. SMTP 服务

兼容 RFC 821, RFC 1123, RFC 1651, RFC 1652, 和 RFC 1854 标准
全 8-bit 操作(qmail直接对邮件进行8bit操作. 译者注)
支持 RFC 931/1413/ident/TAP 回查--用来跟踪垃圾邮件和伪造邮件
转信控制--阻止未授权的外来转信请求.
自动识别本地IP地址.
每缓冲超时
跃点计算
并行访问限制(通过 ucspi-tcp)
对已知的垃圾邮件发送者, 拒绝连接(通过 ucspi-tcp)
支持授权用户转信和消息重写
可选的黑洞名单(Realtime Blackhole List, RBL)和开放转信系统修正(Open Relay Behavior-modification System, ORBS) 支持(通过 rblsmtpd)

1.5.5. 队列管理

对加入队列的邮件即时处理
并行处理限定
分割队列目录--队列很大时不降低处理速度
二次幂重试时间表排定算法--队列内越陈旧的消息得到的发送机会相对新消息越小 (参考附录 E)
每个邮件独立的重试时间表
自动安全队列--系统崩溃情况下不丢失邮件.
自动每邮件接收者检查
自动队列清除
队列观察(参看 qmail-qread)
详细的传送过程分析 (通过 qmailanalog)

1.5.6. 邮件反弹

QSBMF反弹邮件--包括机器易读和人类易读两种格式
HCMSSC 支持--不受语言约束的 RFC 1893 错误代码
发送两次反弹邮件给系统管理员(postmaster)

1.5.7. 基于域名的邮件路由

支持任意数量的本地主机名(参看 locals)
支持任意数量的虚拟域 (参看 virtualdomains)
支持域名通配符 (参看 virtualdomains)
可配置的"percent hack"支持 (参看 percenthack)
UUCP 钩 (UUCP hook)

1.5.8. SMTP 传输

兼容 RFC 821, RFC 974, 和 RFC 1123 协议
全8-bit字符支持
对关闭的主机自动延迟处理
人工路由--smarthost, localnet, mailertable (参考 smtproutes)
每缓冲超时设定
被动SMTP队列--对(低速)SLIP/PPP线路的完美支持 (通过 serialmail)
Auto TURN支持 (通过 serialmail)

1.5.9. 转发和邮件列表

兼容Sendmail的 .forward控制文件(通过 dot-forward).
散列的转发数据库(通过 fastforward)
兼容Sendmail的 /etc/aliases 控制文件(通过 fastforward)
地址通配符 (参见 .qmail-default)
邮件列表所有者--自动转移反弹邮件和假期邮件
VERPs--自动邮件列表反弹邮件接收者识别
自动防止循环成环邮件传送, 甚至可以避免对于交叉串联主机的配置方式成环邮件传送

1.5.10. 本地(邮件)传送

支持用户控制的地址分级--任意FRED(Fast Random Enquiry Display 快速随机询问显示, 译者注) mbox传送
可靠的NFS传输(参见 maildir)
支持用户可控的邮件程序传送, 比如procmail等, (参见 qmail-command)
可选的新邮件通知(参见 qbiff)
可选的NRUDT返回收条(参见 qreceipt)
条件过滤(参见 condredirect 和 bouncesaying)

1.5.11. POP3 服务

兼容 RFC 1939
支持UIDL
支持TOP
APOP钩
模块化的密码检查(通过 checkpassword)

1.6. 相关的软件包

qmail遵循经典UNIX哲学: 每个软件工具都要有专一的, 规范良好的功能; 而复杂的功能应该由一系列多个独立的简单工具联合完成, 形成一个"流水线"模式. 另外一种方式是在更为简单的工具上不断的建立和丰富越来越复杂的的功能来完成大量的复杂的功能.

qmail并没有拥有所有人要求的任意功能, 这点并不令人惊讶惊讶. 相反的, qmail拥有的是一些实现那些功能的流行的插件(add-ons). 当然了, 许多标准UNIX实用工具也都可以作为插件和qmail协同工作. 下面介绍一些插件:

dot-forward --一个兼容Sendmail的.forward控制文件的插件
fastforward -- 一个兼容Sendmail别名数据库的插件
ucspi-tcp -- 一个inetd超级服务器的替换程序
daemontools -- 一个管理后台服务程序以及日志的工具套件
qmailanalog -- 一个qmail日志文件分析工具套件
serialmail -- 用于低速网络邮件传送的工具
mess822 -- 一个对因特网邮件的进行分析的工具
ezmlm -- 一个基于qmail的管理邮件列表的工具

1.7. 体系结构

附录 D 介绍了qmail的功能和结构. 简单的说, qmail包含了一系列的程序(模块)来完成不同的任务.

1.8. 版权许可信息

qmail的版权由作者Dan Bernstein所有, qmail没有和用户权利声明一同发布. 在web页面 http://cr.yp.to/softwarelaw.html 上, 作者Dan Bernstein概要陈述了他认为用户在美国版权法下拥有的权利和义务. 在web页 http://cr.yp.to/qmail/dist.html 上描述了作者授权给qmail的源代码分发用户的权利和义务. 二进制发行遵循条款在下面这个web页面上可以找到 http://cr.yp.to/qmail/var-qmail.html, 也可以参考这里: http://en.wikipedia.org/wiki/License-free_software.

发行权限的最底线: 你可以将qmail用于任何用途, 你可以再次分发未修改的qmail源代码和有资格的var-qmail二进制发行包, 你也可以发行qmail补丁程序. 但是你不能发行修改过的qmail源代码和non-var-qmail二进制发行包.

1.9. 和其他MTA相比较

这个题目完全可以写一本书啦. 不过可能是很单调乏味的一本. 这里给出一个qmail和其他最常见的UNIX MTA的快速比较表格(中: medium, 高: high, 低: low, 是: yes, 否: no, 插件: addons, 可选的: optional. 译者注)

MTA	成熟度	安全性	特色	性能	是否兼容Sendmail	模块化
qmail	中	高	高	高	插件	是
Sendmail	高	低	高	低	-	否
Postfix	中	高	高	高	是	是
exim	中	低	高	中	是	否
Courier	低	中	高	中	可选的	是

兼容Sendmail意思是MTA运转是否类似于Sendmail, 从而可以在某种用户透明度上从此MTA和Sendmail之间过渡和切换, 比如.forward控制文件, /etc/aliases文件以及是否传送邮件到目录 /var/spool/mail等等行为.

Jonathan de Boyne Pollard 曾经回顾了很多UNIX下的MTA, web页面在http://homepages.tesco.net/~J.deBoynePollard/Reviews/UnixMTSes/ . 另外一个很详细的的比较文章请参考http://www.geocities.com/mailsoftware42/. (geocities可能在国内无法直接访问. 译者注)

1.10. 文档

1.10.1. man 帮助手册

qmail发行包包含了完整的man手册. 安装qmail之后, 他们通常位于 /var/qmail/man. 你可能需要自己手动增加这个手册目录路径到你的环境变量MANPATH里面.

Shell 解释器	命令行
Bourne (/bin/sh)	MANPATH=$MANPATH:/var/qmail/man; export MANPATH
bash, Korn	export MANPATH=$MANPATH:/var/qmail/man
C Shell	setenv MANPATH $MANPATH:/var/qmail/man

(上面表格为各个不同shell下运行的增加环境变量的命令行格式, 故不予翻译, 用户也可以参考man man来查阅直接指定man的指定目录开关的设定, 在Bourne下, 这个开关一般是 -M.译者注) (修改环境变量之后) 用型如"man name-of-qmail-man-page"的命令格式即可调出相关的手册页面.

也可以访问man手册页面的在线web页面形式, 地址是:

http://www.qmail.org/man/index.html

注意: qmail的man手册页面承载了大量的信息, 它的写作语言偏重技术术语, 可能相当晦涩难懂, 必须仔细加以研读. 你可能需要通读一遍来熟悉它. 因为很少有重复性的内容, 你必须首先知道里面都写了哪些内容,以及你感兴趣的那些内容在哪里, 否则你可能根本找不到你要的东西.

1.10.2. 文档

qmail发行版包含了一系列文档, 通常安装在/var/qmail/doc目录下. 它们包括以下内容: (本文中默认的两个位置,一个就是文档的根位置/var/qmail/doc, 这个位置的文档也通常被作者描述为qmail源代码文件目录下的doc文档, 内容是一致的. 还有一个就是qmail 的安装后的主目录下的控制文档, 通常为/var/qmail/control下面, 在很多情况下, 作者并不明确指出这两个具体位置. 译者注)

FAQ: 常见问题以及回答.
INSTALL.* 文件集: 安装文档.
PIC.*文件集: 描述了qmail如何完成核心任务的文档. 查找更多相关信息, 请参看附录体系结构.
其他几个安装相关文档.

这些文档也可以在线查看, 请到web页面:

http://www.qmail.org/man/index.html

1.10.3. 常见问题 FAQs

有两个正式的常见问题(Frequently Asked Questions, FAQ. 附相关回答)文档:

/var/qmail/doc/FAQ 目录下, 纯文本版本, 以及
web页面FAQ, 地址: http://cr.yp.to/qmail/faq.html.

web页面的FAQ更完整一些.

1.10.4. 书籍

1.10.4.1. qmail 手册 (英文书名: The qmail Handbook)

作者Dave Sill, 也是本文Life with qmail的作者, 曾经为Apress(http://www.apress.com/)出版社撰写了一本qmail书籍. 这本qmail 手册 (英文书名: The qmail Handbook), 包括了本文所有内容, 某些方面更为详细, 同时也介绍了大量的新领域.

更多信息, 请参看 http://www.apress.com/catalog/book/1893115402/. 需要在我的书店定购本书, 请到我和Amazon.com合作书店 http://www.amazon.com/exec/obidos/ASIN/1893115402/davesill.

1.10.4.2. qmail (英文书名: qmail)

据报道, John Levine为O'Reilly & Associates (http://www.oreilly.com/)出版社写作的一本qmail书籍.

1.10.4.3. Running qmail (英文书名: Running qmail)

作者Richard Blum, Sams出版. 这本书被认为接受了qmail邮件列表里面的各种观点.

定购本书, 请参看 http://www.amazon.com/exec/obidos/ASIN/0672319454/davesill.

1.10.4.4. qmail: Yuksek Performansli E-Posta Sunucu

Ismail Yenigul, 以及其他人著作的qmail 书籍. 参见 http://www.acikakademi.com/catalog/qmail/.

1.10.5. 邮件列表文档

qmail的邮件列表, 由Dan Bernstein 维护, 极为有价值的信息来源. web文档保存在以下位置:

http://www.ornl.gov/its/archives/mailing-lists/qmail/.

这个文档的一个搜索引擎位置在:

http://www-archive.ornl.gov:8000/.

其他web文档可以在以下地址访问到:

大多数关于qmail的问题的答案都可以首先在这个邮件列表的文档里面搜索到.

1.10.6. 其他Web站点

http://cr.yp.to/qmail.html : qmail的正式主页.
http://www.qmail.org/. qmail的非正式主页. 包含了大量关于功能插件和补丁的信息, 以及很多很棒的关于qmail的web页面的链接.
http://www.flounder.net/qmail/qmail-howto.html: Adam McKenna 制作的HOWTO.

1.11. 技术支持

1.11.1. 邮件列表

下面的这些列表位于主机 list.cr.yp.to. 为了防止被发送垃圾邮件者获取地址, 我没有使用完整有效的邮件地址, 以及"mailto"格式的URL.(这里隐去了真实的listname, 具体请参看qmail的正式主页介绍或者查看1.11.1.节, 也就是本节的几个小节的带有下划线的英文标题名字, 译者注)

这些邮件列表由ezmlm管理, 使用不同的地址实现不同的功能.

listname@list.cr.yp.to: 订阅地址. 发送到这个地址的邮件将会被发送给列表的所有用户. 请不要发送订阅和退订要求到这个地址, 这样作是无效的, 而且还会打扰其他订阅者.
listname-help@list.cr.yp.to: 这是"帮助"地址. 发送邮件到这个地址将会返回使用信息.
listname-subscribe: 发送空消息到这个地址订阅列表.
listname-unsubscribe: 发送空消息到这个地址退订列表.

举例, 一个订阅或者退订地址, 比如 joe@example.com, 发送邮件到这个地址订阅列表:

listname-subscribe-joe=example.com@list.cr.yp.to.

1.11.1.1. qmail

这是一个主要的qmail邮件列表.讨论和提问/回答很多有关于qmail的问题. 不过不包括有关于他们自己的列表的问题. 在这个列表提问之前请阅读Charles Cazabon的"12 Steps to qmail List Bliss" web页面位置http://pyropus.ca/personal/writings/12-steps-to-qmail-list-bliss.html .同时请首先阅读FAQ或者在这里搜索列表的过去的文章. 提问的时候, 请尽量包含充分详尽的细节, 便于其他人回答. 请注意以下这些提问要点:

你做了什么? 你的配置? 如果你不清楚哪些比较重要, 那就把qmail-showctl 的输出算上. 你都做了那些举动? 如果是新安装的qmail, 讲述一下你如何安装的.
你期待发生什么? 你想达到一个什么目的? 不要假设读者会猜到你的想法.
曾经发生了什么? 描述一下实际的结果. 包括log文件的部分剪辑, 消息的副本, 包括头部分.

注意: qmail的邮件列表使用了一个叫做qsecretary的工具来校验投递到列表的邮件是否是垃圾邮件. 每封到达列表的邮件都会首先由qsecretary返回一个确认邮件. 用户阅读确认邮件并且按照返回邮件上的指令确认你的邮件--通常就是回复qsecretary的确认信息就可以了. 经常在列表投递的订户一般使用类似Charles Cazabon编写的pymsgauth (在这里http://pyropus.ca/software/pymsgauth/.) 的自动回复程序来自动完成邮件确认. pymsgauth 校验发往列表的邮件的确是你发出的, 所以它不会确认那些冒充你的名字发送到列表的邮件.

1.11.1.2. qmailannounce

qmail的公告邮件列表. 没有投稿地址, 这是个只读的列表.

1.11.1.3. serialmail

讨论serialmail 软件的列表.

1.11.1.4. ezmlm

ezmlm 邮件列表管理器的的讨论列表.

1.11.2. 咨询者

参看 http://www.qmail.org/top.html#paidsup 的商业支持提供者名单.

1.11.3. FAQTS 知识库

http://qmail.faqts.com/ 一个qmail相关问题的数据库, 包括问题解答.如果你在FAQ里面找不到回答, 试试搜索这个知识库. 它的专长在于回答"如何去作"的问题.

2. 安装

这一节介绍qmail的安装. 如果你是个经验丰富的系统管理员, 你完全可以按照qmail的发布源文件里面的INSTALL文件的指导完成安装. INSTALL文件是正式的安装指导. 这个指导比 Life with qmail, 也就是本文的指导复杂很多. INSTALL文件假定读者是一个经验丰富的系统管理员或者邮件管理员. 而且INSTALL这个文件也比较陈旧, 反映不了Bernstein(qmail作者)最近的操作规程建议.

注意: 如果你选择使用下面的安装指导, 请你一定要通读下面整个小节以熟悉全部安装过程.

2.1. 不同的安装发布形式以及相互的比较

2.1.1. 二进制安装对比源代码安装

由于qmail对于预先编译的二进制代码包的发行有限制性的许可, 通常qmail都是由源代码安装的.

如果你不是很熟悉源代码和二进制的区别, 想像一下你订了一个pizza饼. "二进制"形式的pizza饼送来了立刻就能吃, 而"源代码"pizza饼就像全部制作pizza的材料, 面粉, 发酵粉, 干酪, 沙司还有浇头调料, 以及烹饪pizza的指导, 你必须自己作pizza. 虽然有点费劲, 不过如果你仔细的按照指导来作, 结果是一样的, 甚至更好. 自己作的pizza更新鲜, 你也可以按照自己的配置调整浇头调料, 并且你更多的了解了你的pizza以及它是如何"工作"的.

安全的运行一个因特网服务并不容易. 一个不适当配置的服务可能给你的主机系统带来被攻击以及被用来攻击其他站点的风险--有可能让管理员承担法律责任的安全风险. 更多的知道你的网络服务如何运行的, 就更有可能让他们正确和安全的工作.

2.1.2. Tarball 对比特定操作系统安装包 (Tarball vs. OS-specific package)

一些操作系统提供一种自动源代码安装机制. 回到上文我们的pizza制作分析里面. 这就好像把所有的pizza的成分和制作指导都打包到一起, 这样你简单的按一下按钮pizza就能把自己烤好啦.

觉得这样作很不错, 是吧?

实际上, 那可不是一个想当然的好主意. 组装这些包是个相当困难的工作, 它们有时并不是按照假定的方式工作的. 这是软件, 而且和其他软件一样, 他们会有bugs. 即使不提那些bugs, 那些安装的方便也是用牺牲你自己烤的pizza饼的很多优点来达到的. 比如你自己调整浇头调料的的能力, 还有知道怎么作pizza饼, 以及pizza如何工作等等.

如果qmail仅仅是一个pizza, 哪自安装方式还是可以接受的. 不过qmail可是个相当复杂的系统. 安装和维护qmail的人都需要对它相当的了解才能平稳的运行它. 自安装方式的qmail更容易安装, 不过用户手动安装方式更容易调整配置和查找故障. 你可能就安装一次qmail, 但是你可能要几次才能调整好它, 或者当邮件并不是按照你想要的方式运行的时候, 设法找出并解决问题.

由于这些原因, 我建议使用源代码的tarball方式安装, 而不是Red Hat RPM或者其他自安装包方式.

2.2. 准备工作

安装qmail之前, 尤其如果是你第一次安装qmail, 有几个需要注意的地方.

如果可能, 尽量在一个"试验"系统上安装qmail. 这样的话可以有机会犯错, 不至于在正在工作的服务器上安装时丢失重要的邮件或者中断mail服务.
如果你没有空闲的计算机系统, 而你要安装的系统上面已经运行sendamil, smail或者其他的MTA, 这些MTA还在进行邮件投递, 你可以在这种系统上完成大部分的qmail 安装而不中断现有的邮件服务.
如果从其他MTA移植到qmail--即使你在qmail上已经很有经验--首先制订一个安装计划, 也是非常必要的.

2.3. 系统要求

qmail 必须安装在UNIX或者类UNIX系统上, 一些系统要求:

安装需要大约10兆空间. 安装之后可以删除目标文件释放出大约4兆空间.
一个完整的C开发环境, 包括编译器, 系统头文件, 以及函数库. 构建指导将告诉你如何显示你是否拥有这些必要的部分.
二进制代码, 文档, 和配置文件需要几兆空间.
邮件队列需要一个安全的文件系统. qmail 的可靠性要求文件系统兼容传统的BSD FFS语义. 大多数现代的本地文件系统都符合这个要求除了一个很重要的例外: link()系统调用常常是异步的--这意味着link()操作返回时不会将数据写入磁盘. Bruce Guenter 的syncdir 库可以用来解决这个问题. 更多信息请参见附录里面相关软件包 syncdir.
邮件队列需要的足够的磁盘空间. 小型单用户系统仅仅需要2兆. 大型系统可能需要2吉(2G).
兼容的操作系统. 多数变种UNIX都可以. 参考qmail源代码里面的README文件, 里面有已知的兼容系统版本列表.
最好有权使用域名服务器. 没有这个条件, qmail就只能按照smtproutes配置文件里面配置的远程主机发送邮件.
足够的网络带宽. qmail是为良好接入网络的系统设计的, 所以你不可能在一个28.8k的拨号线路上运行一个邮件列表. serialmail软件包是为在低速连接上的系统运行qmail而设计的. 更多信息请参见附录内serialmail相关的节.

注意: 邮件队列所在的文件系统必须允许使用可执行文件和设置setuid()文件. 一些操作系统自动挂载(mount) /var 目录选项为非suid 和非可执行.这种情况下, 必须在 /var/qmail/bin 内禁止这些选项, 或者, 将这个文件夹放置在其他没有这两项限制的文件系统上. 稍后我将在建立目录小节提到如何使用符号链接来解决这个问题. 如果/var 挂载为非suid, 你可能在qmail-send 日志内看到如下的错误消息:

delivery : deferral: Sorry,_message_has_wrong_owner._(#4.3.5)

注意: 本文或者INSTALL 文件的说明, 是不能作为qmail 在苹果X 操作系统上的安装指导的, Eben Pratt 存档了如何在苹果X 系统上安装qmail 的文档, 参考这里 http://netdevice.com/qmail/#osx.

2.4. 下载源代码

好了, 你已经准备好安装qmail的系统了. 第一步就是下载qmail和插件的源代码. 当然了, 你需要qmail, 还有ucspi-tcp和daemontools.

qmail, http://www.qmail.org/netqmail-1.05.tar.gz
ucspi-tcp, http://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz
daemontools, http://cr.yp.to/daemontools/daemontools-0.76.tar.gz

用你的web浏览器, 或者web客户端(比如wget), FTP客户端下载这些源代码.

注意: 如果这些链接的其中任何一个失效, 都有可能由于他们已经升级了, 如果是这种情况, 你需要到http://cr.yp.to/software.html 查找相应软件包的链接下载最新版本. 有可能升级版本不兼容下面的指导内容, 所以请一定阅读这些发行版本的"Upgrading from previous version..."小节中的注意事项.

注意: 本文安装指导使用netqmail 发行版, netqmail 包含了qmail 1.03 tarball版和一个补丁, 这个补丁修正了一些漏洞, 不足和兼容性问题. 在这里访问netqmail http://www.qmail.org/netqmail/ netqmail 的CHANGES 文件内有更多的相关信息.

2.5. 编译源代码

2.5.1. 检验编译(源代码)环境

首先你要确定的是你有编译程序的必要的工具. 如何确定取决于你使用的UNIX变种. 虽然不能保证可靠, 但最简单的断定方式就是去试.

注意: 下面任何一个测试通过了, 你都可以停下来直接跳到下一节.

在计算机的命令提示行下, 敲入 cc 然后回车.

    $ cc
    cc: No input files specified
    $

如果你得到类似上面的反应, 表明你的缺省搜索访问路径上有一个可用的C编译器. 如果没有类似反应, 也不意味着你必然没安装任何C编译器. 也有可能那个编译器不在你的缺省搜索访问路径上, 当然, 也有可能你根本没有编译器. 接着来试这几个命令:
- /usr/bin/cc
- /usr/bin/gcc
- /usr/local/bin/cc
- /usr/local/bin/gcc
- /usr/ccs/bin/cc
如果他们中间没有一个命令起作用, 你可能要多试点和平台有关的命令啦. 在命令提示符下, 区别于你使用的平台不同, 分别敲入以下命令:
- 对于 Red Hat Linux, 使用: rpm -qa | grep gcc 或者 rpm -qa | grep egcs
- 对于 FreeBSD: 默认安装已经包括了GCC编译器.
如果你找不到编译器, 你必须确定它的位置或者安装一个. 请联络你的操作系统销售商或者操作系统技术支持.

这节我们将要实现编译qmail的步骤. 剪切/粘贴(意思是复制或者粘贴脚本和命令行. 译者注) 会很方便, 不过也不是必须的.

2.5.2. 解压发行包

如果你一直按照这个指导来作, 那么现在你已经有了一个C编译器, 以及源代码的tarball副本. 下一步, 拷贝或者移动tarball包到工作目录. 目录/usr/local/src 对于qmail 和ucspi-tcp安装是个不错的位置. 而daemontools 应该建立在/package下.

现在你需要成为root用户, 如果你还没有, 那就成为root吧.

    su      
    umask 022
    mkdir -p /usr/local/src
    mv netqmail-1.05.tar.gz ucspi-tcp-0.88.tar.gz /usr/local/src
    mkdir -p /package
    mv daemontools-0.76.tar.gz /package
    chmod 1755 /package

现在你可以解开软件包了.

    cd /usr/local/src
    gunzip netqmail-1.05.tar.gz
    tar xpf netqmail-1.05.tar
    cd netqmail-1.05
    ./collate.sh  # 在这儿要注意错误信息
    cd ..
    gunzip ucspi-tcp-0.88.tar.gz
    tar xpf ucspi-tcp-0.88.tar
    rm *.tar      # 此步骤可选, 除非硬盘空间很紧张
    cd /package
    gunzip daemontools-0.76.tar.gz
    tar xpf daemontools-0.76.tar
    rm *.tar      # 此步骤可选, 除非硬盘空间很紧张

那么, 现在应该有下面几个目录 /usr/local/src/netqmail-1.05, /usr/local/src/ucspi-tcp-0.88, and /package/admin/daemontools-0.76.

2.5.3. 建立目录

qmail安装程序会自行创建需要的子目录, 你只需要创建qmail的"home"目录.

    mkdir /var/qmail

然后直达下一节.

注意: 如果你想把qmail的全部或者部分文件安装到除了/var的其他地方, 可以在/var/qmail下建立软链接到其他位置.

举个例子, qmail配置文件可以存放在/etc/qmail下面, 如下操作:

    mkdir /etc/qmail
    ln -s /etc/qmail /var/qmail/control

2.5.4. 创建用户和组

最容易的创建用户和组的方式是创建一个小脚本文件然后执行它. 在源代码目录下你可以找到一个名字是INSTALL.ids的文件, 它包括了在你的系统平台下创建用户和组的命令行. 复制这个文件并命名另外一个名字, 编辑它来运行命令既快捷又简单.

    cd /usr/local/src/netqmail-1.05/netqmail-1.05
    cp INSTALL.ids IDS

接下来, 用你最顺手的编辑器, 删除文件其余部分, 除了保留你的平台需要的命令部分. 举个例子, 下面是为FreeBSD平台编辑之后留下的部分:

    pw groupadd nofiles
    pw useradd qmaild -g nofiles -d /var/qmail -s /nonexistent
    pw useradd alias -g nofiles -d /var/qmail/alias -s /nonexistent
    pw useradd qmaill -g nofiles -d /var/qmail -s /nonexistent
    pw useradd qmailp -g nofiles -d /var/qmail -s /nonexistent
    pw groupadd qmail
    pw useradd qmailq -g qmail -d /var/qmail -s /nonexistent
    pw useradd qmailr -g qmail -d /var/qmail -s /nonexistent
    pw useradd qmails -g qmail -d /var/qmail -s /nonexistent

然后运行这个脚本, 用chmod将脚本设置为可执行或者用sh来运行它.

第一种方法:

    chmod 700 IDS
    ./IDS

第二种方法:

    /bin/sh IDS

这个脚本运行完毕, 你的所有的用户和组就已经添加完毕, 你可以继续下一节的安装了.

可是如果你的系统在INSTALL.ids 上没有提到怎么办? 那你就必须手动创建用户和组了. 使用你比较顺手的编辑器编辑这个文件/etc/group, 增加下面两行:

    qmail:*:2107:
    nofiles:*:2108:

注意: 首先确定2107和2108没有被使用, 如果已经被占用, 选择2个文件中未用的数字.

下一步, 使用vipw(大多数系统都有这个命令, 如果没有你就必须用编辑器手动编辑, 不过这次可是/etc/passwd文件)在文件尾部增加下面这些行:

    alias:*:7790:2108::/var/qmail/alias:/bin/true
    qmaild:*:7791:2108::/var/qmail:/bin/true
    qmaill:*:7792:2108::/var/qmail:/bin/true
    qmailp:*:7793:2108::/var/qmail:/bin/true
    qmailq:*:7794:2107::/var/qmail:/bin/true
    qmailr:*:7795:2107::/var/qmail:/bin/true
    qmails:*:7796:2107::/var/qmail:/bin/true

注意: 首先确定7790-7796这些未被占用以及和刚才上面编辑的2107, 2108是同一个组id. 如果任意一个用户ID(UID)被占用, 必须选用其他未被占用的用户id.

你不必一定把这些行加到文件尾部, 这样作只是最容易说明问题的方式.

你现在已经可以进入下一节了.

2.5.5. 编译

现在你可以开始编译qmail了. 进入/usr/local/src/netqmail-1.05/netqmail-1.05 目录, 我们开始吧!

    cd /usr/local/src/netqmail-1.05/netqmail-1.05

在检验编译环境小节, 你定位了你的C编译器. 如果它的名字不是cc或者不在你访问的环境变量PATH定义的任何目录下, 你必须修改conf-cc和conf-ld. 假设你的编译器名字是gcc, 并且gcc在你的环境变量PATH内可见, 那么简单来说, 编辑conf-cc和conf-ld然后置换所有"cc"为"gcc"就可以了.

现在敲入下面的命令:

    make setup check

这个编译完成之后, 你需要作一些安装后配置工作. 运用下面两个脚本用来让工作更简单.

如果你的DNS配置恰当, 运行这个脚本:

    ./config

如果由于某些原因config 脚本不能在DNS找到你的主机名, 你就必须运行config-fast脚本: (这个原因一般来说是由于config在dns反查主机IP对应的规范的主机名时候没有记录或者出错造成的. 现代商业dns一般都不提供IP反查. 所以安装过程可能更多机会是直接使用config-fast 脚本, 而不是config 脚本. 译者注)

    ./config-fast the.full.hostname

举个例子, 如果你的域名是example.com, 你的计算机的主机名是dlphin, 你的config-fast 命令行应该这样写:

    ./config-fast dolphin.example.com

注意: 你可能计划在小型本地局域网使用伪域名比如".local", 举例来说, 如果你的主机名是"mash", 你可能要用 ./config-fast mash.local , 如果你这样作了, 要确定配置qmail在返回地址上使用了合乎逻辑的因特网域名. (参见第3节, 配置.)

qmail现在已经安装到你的系统内, 并且准备运行了! 下一节将要介绍运行和测试qmail.

2.6. 安装 ucspi-tcp

刚才你解压了qmail, ucspi-tcp, 和daemontools 的tarball包, 现在进入ucspi-tcp目录.

    cd /usr/local/src/ucspi-tcp-0.88

刚才在编译一节, 如果你修改了conf-cc和conf-ld文件, 你必须在这个目录作同样的修改.

然后, 运行:

    patch < /usr/local/src/netqmail-1.05/other-patches/ucspi-tcp-0.88.errno.patch
    make
    make setup check

ucspi-tcp安装完毕.

2.7. 安装 daemontools

进入daemontools安装目录

    cd /package/admin/daemontools-0.76

再说一次, 如果你在编译qmail和ucspi-tcp的时候修改了conf-cc和conf-ld文件, 你必须在在src目录作同样的修改.

然后, 运行:

    cd src
    patch < /usr/local/src/netqmail-1.05/other-patches/daemontools-0.76.errno.patch
    cd ..
    package/install

在BSD系统上(没有 /etc/inittab), 你必须重新启动计算机再运行svscan, 这是后台服务器的管理服务程序.

使用 "ps -ef | grep svscan" 或者"ps waux | grep svscan" 检查svscan是否在运行.

注意: 在Solaris下, 你必须修改/etc/inittab中关于svscan的启动条目, 将

  SV:123456:respawn:/command/svscanboot

改为:

  SV:123456:respawn:/command/svscanboot </dev/null >/var/log/svscan 2>&1

或者改为:

  SV:123456:respawn:/command/svscanboot </dev/null >/dev/msglog 2>&1

选择那种方式, 这取决于你是想把启动svscan的出错消息记录到log文件里面还是显示到控制台上. 这样作的必要性请参考下面的文章:

http://marc.theaimsgroup.com/?l=log&m=100327801309834&w=2

注意: 一个Slackware的用户报告x1之前的SV /etc/inittab条目必须被移动, 否则启动后无法运行svscan.

2.8. 运行 qmail

2.8.1. /var/qmail/rc

/var/qmail/boot 目录包含了不同配置的qmail启动脚本示例: /var/spool/mail 方式和$HOME/Mailbox 方式, 使用procmail或者.forward 控制文件, 以及这些方式的不同组合配置. 你可以随意考查这些方式, 不过这里我们选用下面的脚本:

#!/bin/sh

# Using stdout for logging
# Using control/defaultdelivery from qmail-local to deliver messages by default

exec env - PATH="/var/qmail/bin:$PATH" \
qmail-start "`cat /var/qmail/control/defaultdelivery`"

注意: 这个脚本使用了反引号(`), 而不是单引号('). 最好拷贝和粘贴上文的脚本而不是自己键盘输入, 后者容易出错. (反引号非常小,请仔细看. 译者注)

用你的编辑器将上面的脚本保存为 /var/qmail/rc, 然后执行下面这些命令:

    chmod 755 /var/qmail/rc
    mkdir /var/log/qmail

现在你需要决定一下, 除了由.qmail 文件指示传送的邮件外, 其他邮件将采用何种默认传输方式, (.qmail 文件是指示文件传送路径的重要文件, 后面还会讨论. 译者注)下面的列表大致阐述了几种一般性的选择:

邮箱格式	名称	保存位置	缺省的传输方式	注释
mbox	Mailbox	$HOME	./Mailbox	最常见的格式, 大多数MUA都可以正确识别
maildir	Maildir	$HOME	./Maildir/	更可靠, 少数MUA支持的格式
mbox	username	/var/spool/mail	参见 INSTALL.vsm文件	传统的UNIX邮箱

更多信息请参考 INSTALL.mbox, INSTALL.maildir 和 INSTALL.vsm 文件.

选择缺省的邮箱格式, 只要选择上表里面的"缺省传输方式"的值, 填写到/var/qmail/control/defaultdelivery里面就可以了. 例如, 如果选择标准的qmail /Mailbox 传送格式, 这样作就行了:

    echo ./Mailbox >/var/qmail/control/defaultdelivery

注意: defaultdelivery并不是标准的qmail控制文件. 而是上文/var/qmail/rc 文件的要素. 对于qmail-start来说, defaultdelivery 变量只是在没有实际的 .qmail 文件指定传送指令的情况下作为 .qmail 文件的内容出现的. 把这个指令加入到单独的控制文件内, 就不必再在指令内重复引用shell元字符, 避免了出现多行杂乱的命令参数.

2.8.2. 系统启动文件

2.8.2.1. qmailctl 脚本

如果你手动执行/varqmail/rc 脚本, qmail只会部分被运行起来. 可是我们希望希望每次系统启动后, qmail都能自动被启动; 每次系统停止时候qmail自动被关闭.

创建一个如下的 /var/qmail/bin/qmailctl 文件可以完成这个愿望:

#!/bin/sh

# description: the qmail MTA

PATH=/var/qmail/bin:/bin:/usr/bin:/usr/local/bin:/usr/local/sbin
export PATH

QMAILDUID=`id -u qmaild`
NOFILESGID=`id -g qmaild`

case "$1" in
  start)
    echo "Starting qmail"
    if svok /service/qmail-send ; then
      svc -u /service/qmail-send /service/qmail-send/log
    else
      echo "qmail-send supervise not running"
    fi
    if svok /service/qmail-smtpd ; then
      svc -u /service/qmail-smtpd /service/qmail-smtpd/log
    else
      echo "qmail-smtpd supervise not running"
    fi
    if [ -d /var/lock/subsys ]; then
      touch /var/lock/subsys/qmail
    fi
    ;;
  stop)
    echo "Stopping qmail..."
    echo "  qmail-smtpd"
    svc -d /service/qmail-smtpd /service/qmail-smtpd/log
    echo "  qmail-send"
    svc -d /service/qmail-send /service/qmail-send/log
    if [ -f /var/lock/subsys/qmail ]; then
      rm /var/lock/subsys/qmail
    fi
    ;;
  stat)
    svstat /service/qmail-send
    svstat /service/qmail-send/log
    svstat /service/qmail-smtpd
    svstat /service/qmail-smtpd/log
    qmail-qstat
    ;;
  doqueue|alrm|flush)
    echo "Flushing timeout table and sending ALRM signal to qmail-send."
    /var/qmail/bin/qmail-tcpok
    svc -a /service/qmail-send
    ;;
  queue)
    qmail-qstat
    qmail-qread
    ;;
  reload|hup)
    echo "Sending HUP signal to qmail-send."
    svc -h /service/qmail-send
    ;;
  pause)
    echo "Pausing qmail-send"
    svc -p /service/qmail-send
    echo "Pausing qmail-smtpd"
    svc -p /service/qmail-smtpd
    ;;
  cont)
    echo "Continuing qmail-send"
    svc -c /service/qmail-send
    echo "Continuing qmail-smtpd"
    svc -c /service/qmail-smtpd
    ;;
  restart)
    echo "Restarting qmail:"
    echo "* Stopping qmail-smtpd."
    svc -d /service/qmail-smtpd /service/qmail-smtpd/log
    echo "* Sending qmail-send SIGTERM and restarting."
    svc -t /service/qmail-send /service/qmail-send/log
    echo "* Restarting qmail-smtpd."
    svc -u /service/qmail-smtpd /service/qmail-smtpd/log
    ;;
  cdb)
    tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp
    chmod 644 /etc/tcp.smtp.cdb
    echo "Reloaded /etc/tcp.smtp."
    ;;
  help)
    cat <<HELP
   stop -- stops mail service (smtp connections refused, nothing goes out)
  start -- starts mail service (smtp connection accepted, mail can go out)
  pause -- temporarily stops mail service (connections accepted, nothing leaves)
   cont -- continues paused mail service
   stat -- displays status of mail service
    cdb -- rebuild the tcpserver cdb file for smtp
restart -- stops and restarts smtp, sends qmail-send a TERM & restarts it
doqueue -- schedules queued messages for immediate delivery
 reload -- sends qmail-send HUP, rereading locals and virtualdomains
  queue -- shows status of queue
   alrm -- same as doqueue
  flush -- same as doqueue
    hup -- same as reload
HELP
    ;;
  *)
    echo "Usage: $0 {start|stop|restart|doqueue|flush|reload|stat|pause|cont|cdb|queue|help}"
    exit 1
    ;;
esac

exit 0

这个脚本可以在线下载, 地址是http://www.lifewithqmail.org/qmailctl-script-dt70.

(建议所有直接使用, 或者拷贝-粘贴web页面指令和文件格式脚本指令的读者, 都要注意脚本编码转换的问题. 本文讲到的qmail 是在Unix/Linux 类型服务器上运行的, 而UNIX 的回行和DOS/Windows的回车在脚本内表示的ACSII码是完全不同的, 如果遇到这个问题, 在之后的脚本执行中, 可能出现非常奇怪的错误信息. 有兴趣的读者可以在搜索引擎上查找深入介绍内容. 细心的读者还会注意到, 英文原文和翻译版本, 在代码前后都加上了<PRE></PRE>格式符, 其目的就是为了保证指令代码不会被web页面的格式代码"污染". 译者注)

你可以自己输入这个脚本, 不过我推荐你用浏览器下载上面链接的文件.

将上面这个qmailctl 脚本设置为可执行脚本, 然后链接到你的用户执行程序目录:

    chmod 755 /var/qmail/bin/qmailctl
    ln -s /var/qmail/bin/qmailctl /usr/bin

2.8.2.2. supervise 脚本

为 qmail 的服务创建 supervise 目录

    mkdir -p /var/qmail/supervise/qmail-send/log
    mkdir -p /var/qmail/supervise/qmail-smtpd/log

建立 /, var/qmail/supervise/qmail-send/run 文件

#!/bin/sh
exec /var/qmail/rc

建立 /var/qmail/supervise/qmail-send/log/run 文件:

#!/bin/sh
exec /usr/local/bin/setuidgid qmaill /usr/local/bin/multilog t /var/log/qmail

建立 /var/qmail/supervise/qmail-smtpd/run 文件:

#!/bin/sh

QMAILDUID=`id -u qmaild`
NOFILESGID=`id -g qmaild`
MAXSMTPD=`cat /var/qmail/control/concurrencyincoming`
LOCAL=`head -1 /var/qmail/control/me`

if [ -z "$QMAILDUID" -o -z "$NOFILESGID" -o -z "$MAXSMTPD" -o -z "$LOCAL" ]; then
    echo QMAILDUID, NOFILESGID, MAXSMTPD, or LOCAL is unset in
    echo /var/qmail/supervise/qmail-smtpd/run
    exit 1
fi

if [ ! -f /var/qmail/control/rcpthosts ]; then
    echo "No /var/qmail/control/rcpthosts!"
    echo "Refusing to start SMTP listener because it'll create an open relay"
    exit 1
fi

exec /usr/local/bin/softlimit -m 2000000 \
    /usr/local/bin/tcpserver -v -R -l "$LOCAL" -x /etc/tcp.smtp.cdb -c "$MAXSMTPD" \
        -u "$QMAILDUID" -g "$NOFILESGID" 0 smtp /var/qmail/bin/qmail-smtpd 2>&1

注意: concurrencyincoming并不是标准的qmail控制文件. 它是上面脚本的一个要素. 并且, 第一个LOCAL 行上面的是"破折号 + 数字1", 下面的tcpserver行上的参数是"破折号 + 小写字母l" . (由于英文小写字母l和数字1容易混淆, 原作者特意补充的注意事项. 由译者将被提到两行修改成为红色. 这也是为什么作者希望读者直接拷贝脚本而不是自行输入避免脚本出错的主要原因之一. 另外注意这个脚本中很多字体很小的引号和反引号. 译者注)

注意: Solaris系统下一般位置的id程序不能正常工作, 请使用这个位置的 /usr/xpg4/bin/id:

    QMAILDUID=`/usr/xpg4/bin/id -u qmaild`
    NOFILESGID=`/usr/xpg4/bin/id -g qmaild`

注意: 根据你的操作系统和硬件平台的不同, 可能需要调整softlimit命令的的内存限制参数. 如果你的系统出现连接25端口失败和无法接收远程系统发送的邮件, 或者看到了类似下面这样的错误消息:

  /usr/local/bin/tcpserver: error while loading shared libraries:
  libc.so.6: failed to map segment from shared object: Cannot
  allocate memory

试一下把这个参数调整到3000000到4000000.

建立concurrencyincoming 控制文件.

    echo 20 > /var/qmail/control/concurrencyincoming
    chmod 644 /var/qmail/control/concurrencyincoming

建立 /var/qmail/supervise/qmail-smtpd/log/run 文件

#!/bin/sh
exec /usr/local/bin/setuidgid qmaill /usr/local/bin/multilog t /var/log/qmail/smtpd

将各个run文件设置为可执行文件:

    chmod 755 /var/qmail/supervise/qmail-send/run
    chmod 755 /var/qmail/supervise/qmail-send/log/run
    chmod 755 /var/qmail/supervise/qmail-smtpd/run
    chmod 755 /var/qmail/supervise/qmail-smtpd/log/run

然后建立log文件目录:

    mkdir -p /var/log/qmail/smtpd
    chown qmaill /var/log/qmail /var/log/qmail/smtpd

最后, 建立 supervise 目录到 /service 目录的链接:

    ln -s /var/qmail/supervise/qmail-send /var/qmail/supervise/qmail-smtpd /service

/service 目录是 daemontools 安装时建立的目录.

注意: 建立这个链接之后 qmail 系统会很快自动被启动起来, 如果你还不想立刻运行qmail, 运行下面这个,命令来停止qmail:

    qmailctl stop

2.8.2.3. SMTP 访问控制

允许本地主机通过SMTP方式发送邮件:

    echo '127.:allow,RELAYCLIENT=""' >>/etc/tcp.smtp
    qmailctl cdb

2.8.3. 停止并且禁用(其他)已经安装的MTA

虽然有可能同时运行qmail 和现存的MTA, 比如Sendmail, 不过我建议你除非你知道自己到底在干什么, 否则可不要这么干. 说实话, 如果你正在读我这段话, 你可能也不知道自己在干嘛. :-)

如果现存的MTA是Sendmail, 你应该能利用运行Sendmail的init.d脚本的"stop"参数来停止它的运行. 例如下面命令中的一个可能是有效的:

    /etc/init.d/sendmail stop
    /sbin/init.d/sendmail stop
    /etc/rc.d/init.d/sendmail stop

如果你找不到任何一个init.d/sendmail 下的脚本, 你可以用 "ps -ef|grep sendmail" 或者 "ps waux|grep sendmail" 命令找出 sendmail 的PID, 然后用下面的命令来停止Sendmail: (kill 命令加上Sendmail的PID作参数, 译者注)

    kill PID-of-sendmail

如果你的MTA不是Sendmail, 检查相关文档找出正确的停止MTA的方法.

你应该考虑一下把旧的MTA彻底的从你的系统里面删除. 至少禁用它的 init.d 脚本, 防止下一次系统重启动的时候旧的MTA也被试图重启.

对于使用rpm方式安装Sendmail的 Red Hat Linux, 执行下面的命令来删除Sendmail:

    rpm -e --nodeps sendmail

注意: 如果你使用基于RPM方式的Linux, 比如 Red Hat, 删除MTA可能带来进一步的问题. 系统的某些应用程序将会试图重新安装Sendmail, 一些MUA程序将无法安装, 因为他们找不到安装好的MTA. Mate Wierdl 提供了一个占位程序, 称作 "fake_mta", 安装这个程序之后可以防止出现以上的问题. 简单的RPM安装包可以在下面的地址取得 http://www.csi.hu/mw/fake_mta-1-1memphis.noarch.rpm.

检查一下没有其他程序在监听SMTP服务端口(25). 旧的MTA, inetd, 或者 xinetd 等程序都有可能造成问题. (按照以上步骤执行后, 再) 运行下面的命令应该是没有输出结果的(除非这个时候 qmail-smtpd 服务也在运行).

    netstat -a | grep smtp

如果有什么程序在运行, 首先确定不是qmail, 那么先运行下面的命令:

    qmailctl stop

然后重复 netstat 检查:

    netstat -a | grep smtp

如果你还是能看到这个命令有一些输出, 你就必须在qmail 的SMTP服务运行起来之前把肇事程序找出来.

最后, 将现存的 /usr/lib/sendmail 替代为 qmail 版本.

    mv /usr/lib/sendmail /usr/lib/sendmail.old                  # 忽略错误提示  ignore errors
    mv /usr/sbin/sendmail /usr/sbin/sendmail.old                # 忽略错误提示  ignore errors
    chmod 0 /usr/lib/sendmail.old /usr/sbin/sendmail.old        # 忽略错误提示 ignore errors
    ln -s /var/qmail/bin/sendmail /usr/lib
    ln -s /var/qmail/bin/sendmail /usr/sbin

注意: 创建 sendmail 的链接是很重要的, 即使不管以前的MTA, sendmail 命令也是一个会被很多程序调用来发送邮件的重要命令.

最后步骤是建立两个系统别名.

2.8.4. 建立系统别名

在所有 qmail 安装上面都要建立四个系统别名:

别名	目的
postmaster	RFC 2821 标准要求, 指向邮件系统管理员(也就是你)
mailer-daemon	反弹邮件事实上的标准接收者
root	转发特权用户, 根(root)用户的邮件给系统管理者
abuse	事实上的邮件滥用(垃圾邮件)举报地址

建立这些系统别名, 取决于你想让这些邮件发送到哪里(一个本地用户或者一个远程地址)并且适当的创建一个.qmail 文件集合. 举个例子, 加入你想让本地用户 dave 接收发给系统管理员和邮件管理员的邮件, 就这么作:

    echo dave > /var/qmail/alias/.qmail-root
    echo dave > /var/qmail/alias/.qmail-postmaster
    ln -s .qmail-postmaster /var/qmail/alias/.qmail-mailer-daemon
    ln -s .qmail-postmaster /var/qmail/alias/.qmail-abuse  
    chmod 644 /var/qmail/alias/.qmail-root /var/qmail/alias/.qmail-postmaster

在 INSTALL.alias 文件里面有更详细的细节.

2.8.5. 运行 qmail

如果依照上文, 你创建 /service 之后就停止了qmail, 你现在应该重新启动 qmail:

    qmailctl start

2.9. 测试安装

qmail 现在应该是正在运行的状态. 首先运行 qmailctl stat 来检验那些服务启动并运行中:(下面命令后部分为演示结果, 并不是必然如此的系统输出. 译者注)

    # qmailctl stat
    /service/qmail-send: up (pid 30303) 187 seconds
    /service/qmail-send/log: up (pid 30304) 187 seconds
    /service/qmail-smtpd: up (pid 30305) 187 seconds
    /service/qmail-smtpd/log: up (pid 30308) 187 seconds
    messages in queue: 0
    messages in queue but not yet preprocessed: 0

所有的四个服务都应该是"up"(启动了)1秒钟以上. 如果不是这样, 你可能就是在写脚本的时候写错了一些东西或者你漏过了创建一个甚至多个必要的文件, 目录或者链接. 返回上面的安装指导, 一步一步的再检查一下你的工作. 你也可以下载并运行 inst_check 脚本, 在这里下载 http://lifewithqmail.org/inst_check. 举个例子:

    # sh inst_check
    ! /var/log/qmail has wrong owner, should be qmaill
    ...try: chown qmaill /var/log/qmail
    #

如果 inst_check 发现了问题, 解决问题后重新运行这个检查脚本. 当所有情况被判断为正确的时候, inst_check 将会报告:

    Congratulations, your LWQ installation looks good!

readproctitle 程序维持着由svscan 管理的各个服务的错误消息的日志. 使用 ps 或者其他进程列表命令. 举个例子, 你可以看到类似下面这样的输出:

    # ps -efl | grep "service errors" | grep -v grep
    000 S root      1006  1001  0  76   0    -   334 pipe_w Mar31 ?        00:00:00
    readproctitle service errors: ...unable to start qmail-smtpd/run: exec format error
    #

这个例子里面, 问题出在 /service/qmail-smtpd/run 这个脚本的第一行--很有可能由于脚本文件是 DOS 格式 (DOS使用回车符-换行符结束一行的方式和Unix的仅仅用换行符方式不同).

有时候为了检验配置错误, 手动运行一下服务也会很有帮助的. 举个例子, 如果你的 qmail-smtpd/log 服务没有运行, 那么执行下面的命令:

    cd /service/qmail-smtpd/log
    svc -d .
    ./run
    如果没有错误, 输入一行字符然后按回车键
    如果还是没有错误, 输入CTRL-D (文件结束符)

这个时候, 你应该能够识别问题所在并且解决它了. 这个做完之后, 返回服务目录, 如果有必要, 运行命令:

    svc -u .

一旦那些服务的启动时间都大于1秒钟后, 依照 TEST.deliver 和 TEST.receive 文件里面的指令去校验服务是否正确的工作. 注意, 应用这些指令, 日志将由multilog 程序记录到 /var/log/qmail 下, 而不是 splogger 记录到类似 /var/log/maillog 的文件里面.

注意: 如果你选择了 maildir 邮箱格式作为默认的传送方式, 在运行这些指令之前, 你必须在你的主目录和别名的主目录创建 Maildir 目录. 参见 maildir 小节查找如何恰当的创建这个目录.

3. 配置

你已经从源代码tarball方式, 或者自编译包方式, 或者var-qmail包方式安装了 qmail. 这一节的内容就是按照你的需要配置qmail.

3.1. 配置文件

所有的qmail系统配置文件, 除了在~alias下的 .qmail 文件, 都位于 /var/qmail/control 目录下. qmail-control 的man手册页包括了一个像下面这样的表:

控制文件	默认值	被用于	使用目的
badmailfrom	none	qmail-smtpd	From 地址黑名单
bouncefrom	MAILER-DAEMON	qmail-send	反弹邮件的发送者
bouncehost	me	qmail-send	反弹邮件的发送者主机名
concurrencyincoming	none	/service/qmail-smtpd/run	最大并行 SMTP 连接数
concurrencylocal	10	qmail-send	最大并行本地传送数
concurrencyremote	20	qmail-send	最大并行远程传送数
defaultdelivery	none	/var/qmail/rc	默认的 .qmail 文件
defaultdomain	me	qmail-inject	默认的域名
defaulthost	me	qmail-inject	默认的主机名
databytes	0	qmail-smtpd	邮件最大字节数 (0 等于无限)
doublebouncehost	me	qmail-send	双重反弹的发送者的主机名
doublebounceto	postmaster	qmail-send	接收双重反弹邮件的用户
envnoathost	me	qmail-send	对缺少"@"符号的地址配置的缺省域名
helohost	me	qmail-remote	在SMTP HELLO命令里面使用的主机名
idhost	me	qmail-inject	在Message-ID 里面使用的主机名
localiphost	me	qmail-smtpd	替代本地 IP 地址的名字
locals	me	qmail-send	进行本地传送的域
me	系统的正式域名 FQDN	various	许多控制文件的默认要求
morercpthosts	none	qmail-smtpd	二级rcphosts(接收主机)数据库
percenthack	none	qmail-send	可以使用"%"模式转信的域
plusdomain	me	qmail-inject	"+"加号拖尾地址替代的域
qmqpservers	none	qmail-qmqpc	QMQP 服务器IP地址
queuelifetime	604800	qmail-send	邮件在队列内可保留秒数
rcpthosts	none	qmail-smtpd	我们的主机接收邮件的域
smtpgreeting	me	qmail-smtpd	SMTP 问候信息
smtproutes	none	qmail-remote	人为指定的SMTP路由
timeoutconnect	60	qmail-remote	SMTP连接超时秒数
timeoutremote	1200	qmail-remote	远程服务器连接超时秒数
timeoutsmtpd	1200	qmail-smtpd	SMTP客户端超时秒数
virtualdomains	none	qmail-send	虚拟域和用户

查找这些特殊控制文件的更多信息, 请参考上面表格 "被用于" 列下的各个模块的 man 手册页.

3.2. 中继转信

3.2.1. 介绍

什么是转信? 转信是 MTA 通过SMTP接收到一封既不是发给本地地址也不是从本地发送者发来的邮件之后, MTA转发这个邮件的动作就是转信.

在垃圾邮件时代之前, MTA被配置为开放转信是很常见的: 各种各样的服务器接受来自任何人的邮件, 转发给任何人.

现代的绝大多数 MTA 都被配置为或者完全禁止转信, 或者只允许某些被信任的用户或者系统使用中继转信功能.

Chris Johnson 为qmail 的用户写了一个非常好的文档. 我鼓励你去看一看: http://www.palomine.net/qmail/relaying.html.

3.2.2. 禁止转信

如果你是按照 qmail 的正式安装指导安装的话, 那么转信在默认情况下已经被关闭了. 这个功能是通过把local和virtualdomains(指本地主机)文件里面列出的有充分资格的域名写入 /var/qmail/control/rcpthosts 文件来完成的. rcpthosts 这个文件名是来源于SMTP对话中的的RCPT(接收者)命令. 在SMTP对话里面, RCPT是用来确认邮件接收者地址的, 然后, rcpthosts 列出可以出现在RCPT地址里面的有效的主机名.

3.2.3. 允许有选择的转信

大多数单用户和小型工作组服务器可以完全禁止转信, 可是如果你维护的是一个分布式的用户社区, 你就必须有一个方式能够允许你的用户, 而且只能是你的用户通过的你的系统转信. 本文是通过使用 tcpserver 来设置RELAYCLIENT 环境变量, 使 qmail-smtpd 重载 rcpthosts 文件完成这个功能的.

如果你是按照这个文档的指导安装的话, 有选择的转信已经在默认情况下安装好了. 如果需要给客户端转信权利, 首先在 /etc/tcp.smtp 文件里面增加类似下面的行:

    IP address of client:allow,RELAYCLIENT=""

(斜体IP address of client代表客户端的IP地址. 译者注) 然后重建SMTP的访问许可数据库:

    qmailctl cdb

或者运行下面的命令(重建数据库):

    tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp
    chmod 644 /etc/tcp.smtp*

如果你是按照正式安装指导安装的, Chris Johnson写了另外一个非常好的如何配置qmail允许选择主机转发邮件的文档, 参见: http://www.palomine.net/qmail/selectiverelay.html.

3.2.4. 使用smart host中继转信

如果在一个典型的家庭宽带上网条件下建立邮件服务器, 那么将有非常大的可能, 这个服务器的IP地址会被列入黑名单, 比如SORBS(http://www.dnsbl.sorbs.net/lookup.shtml)的黑名单, 这样作是为了防止垃圾邮件. 绝大多数ISP都给他们的用户提供SMTP服务器用来转信, 这些服务器通常不在黑名单内. 举个例子, Road Runner(美国某ISP. 译者注)在辛辛那提(美国地名. 译者注)使用smtp-server.cinci.rr.com 这个服务器来为她的用户提供SMTP转信服务. 你可以让qmail 将所有向外传送的SMTP 访问都通过这个服务器, 你可以这样作:

  echo ":smtp-server.cinci.rr.com" > /var/qmail/control/smtproutes

smtproutes 文件可以提供更多的路径选择功能, 请参考qmail-remote 的man 帮助文档.

3.3. 多主机名

如果你的主机名已知配置了多个名字, 例如, 所有的来自user@host1.example.com 的地址也可以被写成 user@example.com 或者 user@mail.example.com, 那么你就必须告诉 qmail 哪一个地址是它应该本地传送的地址, 哪一个地址是它应该接受的远程主机发送的地址.

如果要这样作, 只要把所有的名字加入下面两个控制文件就行了:

rcpthosts, 这个文件通知 qmail-smtpd 接收这个主机可以接受的地址. 还有
locals, 这个文件通知 qmail-send 哪些地址是本地传送地址.

给 qmail-send 发送一个HUP(挂起)信号来通知它重新读取 locals文件. 如果你使用的是本文的 qmailctl 脚本, 那么运行下面的命令就可以了:

    qmailctl reload

3.4. 虚拟域

虚拟域和上节提到的多主机名类似, 不过这里面有一些很重要的不同之处. 首先如果 example.net 是 virtual.example.net 虚拟域的宿主主机, 那么一个发送给 joe@virtual.example.net 的邮件将不会被发送给即使是同一个邮箱的 joe@example.net, 这里虚拟域的名字空间是冲突的.

使用 qmail, 虚拟域将在 virtualdomains 文件里面配置, 文件内由型如下面这行的条目构成:

    user@domain:prepend

qmail 转换 user@domain 为 prepend-user@domain 并且将这个转换后的名字作为本地域一样对待. user@ 这个部分是可选的, 如果缺少这个部分, 这个名字将匹配所有 @domain 域下面的地址.

回到上文的 example 剧情里面, 如果 example.net 邮件管理员希望创建 virtual.example.com 虚拟域, 并且将这个域置于用户 john 的管理之下, virtualdomains 文件下面的虚拟域条目应该这样写:

    virtual.example.com:john

这样, 发往 joe@virtual.example.com 的邮件将会被修改为发往 john-joe@virtual.example.com , 然后进行本地传送. 更多信息, 请参见 .qmail 小节, 以及扩展地址细目. 那里将介绍 john 如何管理他的虚拟域.

使用多主机名的时候, 所有的虚拟域都必须在rcphosts列出, 这样 qmail-smtpd 才会知道那些地址的邮件才应该被接受. 但是不像多主机名方式, 虚拟域不可以在locals里面设置相应条目.

修改 virtualdomains文件之后, 发送给 qmail-send 一个 HUP (挂起) 信号, 通知它重新读取配置文件. 如果你使用本文的 qmailctl 脚本, 你可以运行如下命令:

    qmailctl reload

同时, 不要忘了在 rcpthosts 里面增加虚拟域条目.

注意: 必须设置域名服务器(DNS)的邮件交换器(MX)记录, 以使虚拟域指向正确的邮件服务器. 这是名字服务器管理员的工作, 超出了本文讨论的范围.

3.5. 别名

qmail的标准别名机制是由qmail的本地传送机制自然派生出来的.qmail-local 试图传送地址为 localpart@host 的邮件给本地叫做 localpart 名字的用户. 如果没有匹配这个名字的用户存在, 邮件将会被发送给别名 alias 用户, 别名用户是qmail系统里面通常主目录位于 /var/qmail/alias 的伪用户.

举例, 如果你想要创建一个叫做 info@example.com 的别名, 这个别名用户将把上文收到的所有无主邮件转发给用户 tom, 在我们举例的 example.com 上, 这样作的方式是: 作为 root 用户, 运行下面的命令:

    echo \&tom > /var/qmail/alias/.qmail-info

.qmail 小节, 以及扩展地址细目介绍了如何创建 .qmail文件, 这些文件确定了那些别名存在, 以及如何处理哪些发给他们的邮件的.

附录新手常见问题介绍了两个关于别名应用的复杂案例. 那些别名使用了大写字母和小数点("."), 以及 .qmail 文件的 man 手册页面, 其中包含了完整的关于 .qmail 文件用法的文档.

注意由于别名在 qmail 里面的实现方式, 别名是不能够优先与一个已知用户的传送的. 例如, 如果 rachel 是一个普通用户, 那么~alias/.qmail-rachel 别名是无效的.

fastforward 软件包另外提供了一个可行的别名机制, 它将多个别名放入单独一个和Sendmail别名数据库兼容的文件里面.

下一节, qmail-users, 描述了其他实现别名的机制.

3.6. 关于 qmail-users

qmail-users 是一个分发地址给用户的系统. 由 /var/qmail/users 下的一系列文件构成. assign 文件是一个分配表. 有两种分配表的格式: 单体方式和通配符方式.

注意: assign 文件包含了一系列分配表, 每行一个, 后面接一个包含了一个单独的小数点(.)的行. 如果你手动创建assign文件, 不要忘记小数点那一行.

3.6.1. 单体分配表

一个单体分配表看起来是这个样子的:

=address:user:uid:gid:directory:dash:extension:

这个表的含义是: 作为 address 地址接收的邮件将会被使用用户 user 来传送, 使用指定的 uid 和 gid, 并且由 directory/.qmaildashextension 这个文件决定邮件如何被传送.

3.6.2. 通配符分配表

通配符分配表看起来是这个样子的:

+prefix:user:uid:gid:directory:dash:prepend:

这个表的含义是: 作为 prefixrest 地址里面匹配的邮件地址接收的邮件, 将会被使用用户 user 来传送, 使用指定的 uid 和 gid, 并且由 directory/.qmaildashextension 这个文件决定邮件如何被传送.

3.6.3. qmail-user 程序

qmail-user 有两个辅助程序: qmail-newu 和 qmail-pw2u.

qmail-newu 程序处理 assign 文件并且在 /var/qmail/users 下生成一个名为 cdb 的静态数据库(CDB)文件. CDB是二进制格式, 所以在内含数千条分配表的情况下, 仍然可以被 qmail-lspawn 快速访问.

qmail-pw2u 把系统用户数据库 /etc/passwd 转换为一系列适于assign 使用的分配表. qmail-pw2u 使用一组文件来修改翻译规则.

include: 要包括的用户
exclude: 不要包括的用户
mailnames: 用户的可替换的"邮件帐户名字"
subusers: 用户控制的额外的地址, 使用可选的 .qmail 扩展方式
append: 其他分配表

注意: 如果你使用qmail-pw2u, 不要忘记在增加和删除用户, 或者改变UID和GID之后, 重新运行一下qmail-pw2u和qmail-newu. 标准的运行次序如下所示:

    qmail-pw2u </etc/passwd >/var/qmail/users/assign
    qmail-newu

3.7. 反垃圾邮件

Chris Hardie 写了一个极好的的qmail反垃圾邮件 HOWTO. 可以在这个地址访问到它: http://www.summersault.com/chris/techno/qmail/qmail-antispam.html.

3.8. 病毒扫描

Jason Haar编写了 Qmail-Scanner, 一个为qmail设计的内容扫描装置. 更多信息请参见 http://qmail-scanner.sourceforge.net/.

Qmail-Scanner 包括了一个简单策略阻止组件(例如, 阻止*.scr文件, 或阻止"Yellow!"这样的标题), 同时也直接支持许多不同的防病毒"插件", 包括ClamAV Antivirus扫描器 http://www.clamav.net/.

4. 使用方法

这一节介绍了qmail 针对普通用户的使用方法. 如果你在 qmail 系统上读信和发信, 那么你阅读本节就可以找到如何用qmail 达成你的目的了.

4.1. .qmail 文件

传送用户邮件通常是由一个或者几个 ".qmail"(发音 dot kyoo mail) 文件控制的. 这些文件位于用户的主目录, 文件名由 .qmail 开头. .qmail 的man 手册页面描述了 .qmail 文件使用方法.

.qmail 文件包括了一个传送指令清单, 每行一个指令. 每行的第一个字符决定了选择那种传送方式.

字符	传送类型	值
#	无 (注释)	忽略
\|	程序	由shell 执行的命令
/ 或者 .	mbox邮箱格式 (如果路径最后一个字符不是一个斜杠)	mbox 的路径名 (包括斜杠"/"或者点".")
/ 或者 .	maildir邮箱格式 (如果路径最后一个字符是一个反斜杠)	maildir 的路径名 (包括斜杠"/"或者点".")
&	转发	转发邮件的地址
字母或者数字	转发	转发邮件的地址 (包括第一个字符)

4.1.1. 程序传送

如果.qmail 文件内指令由程序传送, qmail 将启动一个 shell (/bin/sh) 来执行这个命令, 然后使用标准把邮件的一个副本传送给这个命令. qmail-command 的man 帮助文档对这个过程有详细描述.

程序传送是非常强大的, 被用来实现的功能范围非常广阔, 例如邮件过滤, 自动回复, 以及通过第三方传送代理比如procmail来传送邮件.

例如:

    |preline /usr/ucb/vacation djb

这个指令操作qmail 启动preline, 将 /usr/ucb/vacation 和 djb 作为参数传送给 preline, 并且使用标准输入将邮件的副本传送给这个命令.

4.1.2. mbox 格式邮箱的邮件投递

mbox 是标准的UNIX邮箱格式, 在一个独立文件内存放多个邮件, 每个邮件由一个"From" 的开头的行开始. 这一行看起来像一个邮件头字段, 不过那不是邮件头, 那仅仅是传送代理添加的, 作为一个标记,便于找到每个邮件的开始部分.

例如:

    ./Mailbox

这个设置表示邮件将被追加到 $HOME/Mailbox 文件上, 每个邮件由"From"开头的行引领. 一个只存放了一个邮件的, 简单的mbox 的邮箱看起来是下面这个样子的:

    From user1@example.net Thu May 13 18:34:50 1999
    Received: (qmail 1287205 invoked from network); 13 May 1999 18:34:49 -0000
    From: user1@example.net
    To: user2@example.com
    Subject: hey

    What's up?

第一行是 qmail 传送邮件时添加的.

4.1.3. maildir 格式邮箱的邮件投递

maildir 是 Dan Bernstein 为了表明 mbox 邮箱格式的缺陷而创造的格式. 一个 maildir 邮箱包含三个子目录, new, cur, 和 tmp. 在各个子目录下的每个邮件根据状态的不同分别存储在各个子目录下独立的文件中. 未读邮件存储在new中, cur存储已读邮件, tmp 是为那些正在传送过程中的邮件使用的. maildir 的man手册页详细描述了maildir格式的细节.

maildir 格式的优点之一就是保证邮件传输的安全, 即使在不锁定情况下, 不同邮件代理同时更新邮件, 也能保证传输的可靠. 这意味着maildir 邮箱可以安全的建立在以NFS性质挂接的文件系统上.

例如:

    ./Maildir/

这个设置表示将把邮件存储在 $HOME/Maildir 下面的 maildir 格式的邮箱.

注意: qmail-local 可以将邮件传送到 maildir 格式邮箱, 但是不能创建这种邮箱. 你需要使用qmail 附带的maildirmake 程序来创建 maildir 格式邮箱. 例如: "maildirmake ~/Maildir". 不过要确定你使用maildir的拥有者运行maildirmake, 而不是 root 用户. 另外的方式, 你的 useradd 和 adduser 命令可能支持"skeleton"骨架目录, 例如: /etc/skel, 然后可以直接复制这个目录给所有新用户.

4.1.4. 转发邮件

转发邮件就是将邮件重发到指定地址. 这些写入.qmail文件内的地址不能包含注释部分和多余的空格.

下面的写法是错的:

    &<user@example.com>
    & user@example.com
    &Joe User <user@example.com>

下面的是正确的写法:

    &user@example.com
    user@example.com
    &user

前两个将邮件副本转发给 user@example.com, 最后一个将邮件副本转发给本地用户 user.

4.1.5. 扩展地址

qmail 支持用户控制扩展地址. 在基本地址 username@hostname.domain 上扩展的扩展地址为: username-extension@hostname.domain ,用户同样可以接收发往扩展地址的邮件. 在本节其余部分, 我们讨论的范围都是在本地系统上, 所以我们将不再使用"@hostname.domain" 部分.

给用户 username 的邮件传送指令由 ~username/.qmail 文件指定. 对于型如username-extension 的扩展地址的传送指令由用户目录下的~username/.qmail-extension 文件指定.

举一个例子, dave-lwq@sparge.example.com 这个扩展地址的传送将由文件 ~dave/.qmail-lwq 来控制.

扩展地址可以拥有多个字段, 例如 dave-list-qmail 这个扩展地址, 由 ~dave/.qmail-list-qmail 来控制. 在这个例子里面, dave-list-qmai 这个地址被用来订阅 qmail 的邮件列表, ~dave/.qmail-list-qmail 则负责归档这个列表的邮件到单独的邮箱里面.

.qmail 文件可以用-default 后缀进行匹配。所以 dave-list-qmail 可以由 ~dave/.qmail-list-default 操作. 这个文件可以一对多方式用一个.qmail文件控制所有型如 dave-list-加上任何后缀的地址. 注意 dave-list 不能由 ~dave/.qmail-list-default 控制, 因为在"list"后面没有"-".

qmail 会使用最接近的匹配方式. 例如, qmail在传送一个标志着送给dave-list-qmail这个地址的邮件时, 会按照下面顺序查找.qmail控制文件, 并按照最先匹配的.qmail文件传送这个邮件.

    .qmail-list-qmail
    .qmail-list-default
    .qmail-default

如果没有找到相匹配的.qmail文件, 传送失败, 并且将邮件反弹给发送者.

4.2. 发送邮件

邮件用户通常并不直接发送邮件. 典型的方式是利用邮件用户代理(Mail User Agent, MUA)程序, 例如 pine 或者 mutt 编写并发送邮件. MUA程序调用MTA传送邮件. 这个处理邮件到MTA的调用过程称为注入(injection).

有两种方式完成注入, 一种利用SMTP协议(Simple Mail Transfer Protocol, SMTP), 或者利用MTA提供的的特定程序.

4.2.1. SMTP 方式

MUA程序可以使用TCP协议连接到标准的SMTP协议端口25, 可以是本地主机或者指定的邮件服务器. MUA和MTA后续进行的回话导致两个结果:

邮件被传送给MTA, 或者
返回一份错误报告给MUA

SMTP没有身份认证的机制, 所以发送邮件的过程是不要求用户名和密码的. 但是, 大多数MTA拒绝接收既不是来自本地用户也不是发送给本地用户的邮件的. 如果一个恰当的格式的邮件被MTA拒绝, 最大的可能就是转信限制造成. 参见转信小节查看更多的如何配置转信的信息.

4.2.2. /var/qmail/bin/sendmail 文件

很多年以来, UNIX MTA一直都是Sendmail. 由于Sendmail的应用十分普遍, 许多程序员假定它是默认的MTA. 结果, Sendmail的本地注入机制成为标准的本地邮件注入的应用编程接口(Application Programmer's Interface, API). qmail 以及其他非Sendmail的MTA因此也提供一个sendmail程序应用于本地注入方式上, 它的工作方式和真正的Sendmail 的 sendmail程序一样.

qmail 的用于替换Sendmail相应部分的 sendmail 程序, 通常位于 /var/qmail/bin/sendmail, 典型的Sendmail的程序位于下面这些位置:

/usr/lib/sendmail
/usr/sbin/sendmail

在qmail系统里面, 使用命令"ls -l path-to-sendmail"将会显示出, sendmail实际上是一个指向/var/qmail/bin/sendmail 的符号连接.

  $ ls -l /usr/lib/sendmail
  lrwxrwxrwx   1 root     root           29 Feb 19 11:04 /usr/lib/sendmail -> /var/qmail/bin/sendmail

4.2.3. qmail-inject

除了模仿 sendmail 的 API之外, qmail 也拥有自己的注入程序: qmail-inject. 实际上, qmail提供的sendmail 程序只是一个qmail-inject的外壳程序.

作为一个API标准, sendmail可能更好用, 因为它使用广泛. qmail的API由qmail-inject提供, 只能在qmail系统下运行, 而sendmail接口几乎是全球通用的.

举一个例子, 可以这样发送一个空白邮件给 joe@example.com:

 echo To: joe@example.com | /var/qmail/bin/qmail-inject

4.3. 环境变量

一些qmail程序设定和使用环境变量, 下面的表格列出了这些变量并且描述了他们的用法.

名字	Man 帮助页	设置/使用	使用目的
DATABYTES	qmail-smtpd	使用	重载control/databytes文件
DEFAULT	qmail-command	设置	在.qmail文件名中匹配"-default"的地址部分
DTLINE	qmail-command	设置	邮件头Delivered-To部分
EXT	qmail-command	设置	地址扩展
EXT2	qmail-command	设置	第一个破折号后面的EXT的一部分
EXT3	qmail-command	设置	第二个破折号后面的EXT的一部分
EXT4	qmail-command	设置	第三个破折号后面的EXT的一部分
HOME	qmail-command	设置	用户的主目录
HOST	qmail-command	设置	接收地址的域名部分
HOST2	qmail-command	设置	在最后的点前面的HOST部分
HOST3	qmail-command	设置	在倒数第二个的点前面的HOST的一部分
HOST4	qmail-command	设置	在倒数第三个的点前面的HOST的一部分
LOCAL	qmail-command	设置	接收地址的local部分
LOGNAME	qmail-inject	使用	在邮件头From中的用户名(4)
MAILHOST	qmail-inject	使用	在邮件头From中的主机名(2)
MAILNAME	qmail-inject	使用	在邮件头From中的个人姓名(2)
MAILUSER	qmail-inject	使用	在邮件头From中的用户名(2)
NAME	qmail-inject	使用	在邮件头From中的个人姓名(3)
NEWSENDER	qmail-command	设置	转发的发送人地址(参考帮助文档"man dot-qmail")
QMAILDEFAULTDOMAIN	qmail-inject	使用	重载ontrol/defaultdomain 文件
QMAILDEFAULTHOST	qmail-inject	使用	重载control/defaulthost 文件
QMAILHOST	qmail-inject	使用	在邮件头From中的主机名(1)
QMAILIDHOST	qmail-inject	使用	重载control/idhost 文件
QMAILINJECT	qmail-inject	使用	指定几个选项(参见下面的表格)
QMAILMFTFILE	qmail-inject	使用	包含下一级跟踪的邮件地址列表的文件
QMAILNAME	qmail-inject	使用	在邮件头From中的个人姓名(1)
QMAILPLUSDOMAIN	qmail-inject	使用	重载 control/plusdomain 文件
QMAILSHOST	qmail-inject	使用	信封上发送者地址中的主机名
QMAILSUSER	qmail-inject	使用	信封上发送者地址中的用户名
QMAILUSER	qmail-inject	使用	在邮件头From中的用户名(1)
RECIPIENT	qmail-command	设置	信封上接收者的地址
RELAYCLIENT	qmail-smtpd	使用	忽略 control/rcpthosts 文件然后在接收地址后添加值
RPLINE	qmail-command	设置	邮件头返回路径
SENDER	qmail-command	设置	信封上发送者地址
UFLINE	qmail-command	设置	UUCP风格的"From"行
USER	qmail-command	设置	当前的用户
USER	qmail-inject	使用	邮件头From中的用户名 (3)

QMAILINJECT 标志位 QMAILINJECT Flags
字母	使用目的
c	为From部分使用地址注释风格
s	不考虑任何传入邮件的返回路径部分
f	删除所有传入邮件的From部分
i	删除所有传入邮件的Message-ID部分
r	使用每接收者VERP
m	使用每邮件VERP

5. 高级话题

5.1. 关于 procmail

procmail 是一个流行的邮件传送代理( Message Delivery Agent , MDA). MDA的功能是从MTA为特定用户或者邮箱接收邮件, 然后按照用户的要求传送邮件的程序. procmail 可以用来针对邮件主体或者不同的邮件头内容过滤邮件. 举一个例子, 从某个特定的人发来的邮件可以被定向传送到某个专门为这个人准备的邮箱.

在qmail上应用procmail有两个技巧. 第一个, procmail 通常被配置成传送邮件到/var/spool/mail 下的mbox 格式的邮箱. 你可以重新设置安装procmail到缺省的$HOME 路径下, 或者指导用户不要依赖procmail 将邮件投递到默认的mbox位置. 除非你为$HOME 邮件投递方式打补丁, 否则, procmail依然会使用/var/spool/mail 作为临时文件.

另外一个问题是qmail-command和procmail使用的退出码是不同的. procmail使用的是标准UNIX退出码: 零代表成功, 非零代表失败, 失败的原因由/usr/include/sys/errno.h 定义. qmail-command 使用某个非零码指示永久错误, 其余作为临时码. 解决方式可以应用一个小的shell脚本为 qmail-command 翻译退出码. 这样的一个shell脚本曾经在qmail 邮件列表刊登, 现在被存档在这个位置http://www.ornl.gov/lists/mailing-lists/qmail/1998/04/msg00487.html.

同样的情况, 旧版本的procmail(3.14之前)不能直接传送邮件给maildir格式的邮箱. 最好的办法是升级你的procmail到最新版本. 另外一个解决办法是使用safecat, 这个程序将标准输入的邮件写入指定的maildir格式的邮箱. 用户可以使用 procmail 处方(传送指令)来使用safecat 保存邮件. 也可以完全跳过procmail, 使用maildrop.

最后, procmail 认为邮件将被接收到mbox格式的邮箱, 常规的qmail传送程序仅仅包括实际的邮件, 而不包括"From"起始行. 这里可以使用preline 命令来格式化邮件, 以保证procmail的要求. 上面链接提到的脚本就包括了 preline.

举一个例子, 假设用户"dave"希望用procmail来处理他的邮件. 他的系统管理员设置procmail来传送邮件到默认的$HOME, 并且已经配置好了上面的退出码翻译脚本程序, 假设名字是 /usr/local/bin/qmail-procmail, 那么他的.qmail文件应该是这个样子的:

    |/usr/local/bin/qmail-procmail

5.2. POP 和 IMAP 服务器

qmail包括一个POP服务器, qmail-pop3d, 不过并没有作为qmail 安装过程的一部分. 你可以选用其他POP或者IMAP服务器, 尽管他们大多数都是为Sendmail编写的, 在qmail下运行这些服务器时, 需要作一些额外的修改工作.

5.2.1. qmail-pop3d

qmail-pop3d 是qmail自带的很不错的POP服务器. 很多qmail站点都使用它作为POP服务器. 它是模块化的, 可以通过不同的认证模块支持多种认证方案.

注意: qmail-pop3d只支持maildir格式的邮箱, 所以如果你的用户登录到POP服务器并且在本地运行MUA程序, 这些程序必须支持maildir格式的邮箱. 如果所有用户都是通过POP来读取邮件, 那么服务器端的邮箱格式就不是什么问题了.

5.2.1.1. qmail-pop3d的结构

qmail-pop3d服务器包括三个模块:

qmail-popup: 取得用户名/密码
checkpassword: 鉴别用户名/密码
qmail-pop3d: POP后台服务程序

典型的, qmail-popup由inetd 或者 tcpserver运行, 在110端口监听, 一旦有连接, 它将提示输入用户名和密码, 然后它调用checkpassword来校验用户名/密码, 通过校验后调用qmail-pop3d.

5.2.1.2. 安装 qmail-pop3d

1. 完整安装并测试qmail. 如果你希望所有用户都可以用 POP 方式访问邮箱, 那么首先确定 defaultdelivery 文件内容已经设置为 ./Maildir/. 如果你是按照本文的安装小节安装的qmail, /var/qmail/rc脚本已经被安装到恰当位置, 那么在文件 control/defaultdelivery 中已经配置了这个参数. 如果不是这样安装的, 则这个参数可能是在/var/qmail/rc 的 qmail-start 命令行上实现的.

2. 从http://www.qmail.org/top.html#checkpassword下载checkpassword 程序. 如果你不需要其他特别的东西, 也可以在http://cr.yp.to/checkpwd.html 下载标准的checkpassword程序.

3. 按照安装指导编译并安装checkpassword程序. 确定你安装程序到 /bin/checkpassword 下.

注意: 如果你安装的是标准checkpassword, 解开源代码之后别忘记打修补错误返回码的补丁:

patch < /usr/local/src/netqmail-1.05/other-patches/checkpassword-0.90.errno.patch

4. mkdir /var/qmail/supervise/qmail-pop3d

5. 创建一个/var/qmail/supervise/qmail-pop3d/run 脚本, 包括如下内容:

#!/bin/sh
exec /usr/local/bin/softlimit -m 2000000 \
    /usr/local/bin/tcpserver -v -R -H -l 0 0 110 /var/qmail/bin/qmail-popup \
        FQDN /bin/checkpassword /var/qmail/bin/qmail-pop3d Maildir 2>&1

这里 FQDN 是你建立的POP服务器的完整的有资格的正式域名, 例如, pop.example.net.

注意: 由softlimit命令指定的内存使用限度是可以依赖于你是用的的硬件平台和操作系统作适当提高的. 当连接到110端口失败或者POP3连接以难以理解的方式失败情况下, 或者你查看到如下错误信息:

  /usr/local/bin/tcpserver: error while loading shared libraries:
  libc.so.6: failed to map segment from shared object: Cannot
  allocate memory

试着将这个参数提高到3000000或者5000000.

6. mkdir /var/qmail/supervise/qmail-pop3d/log

7. 创建包括以下内容的/var/qmail/supervise/qmail-pop3d/log/run 文件.

#!/bin/sh
exec /usr/local/bin/setuidgid qmaill /usr/local/bin/multilog t \
    /var/log/qmail/pop3d

8. 建立log日志文件夹并且设置相应的run脚本, 将脚本链接到 /service 目录:

    chmod +t /var/qmail/supervise/qmail-pop3d   # if daemontools < 0.75
    mkdir /var/log/qmail/pop3d
    chown qmaill /var/log/qmail/pop3d
    chmod 755 /var/qmail/supervise/qmail-pop3d/run
    chmod 755 /var/qmail/supervise/qmail-pop3d/log/run
    ln -s /var/qmail/supervise/qmail-pop3d /service

9. 将下面内容加入qmailctl脚本的"start"部分

    if svok /service/qmail-pop3d ; then
      svc -u /service/qmail-pop3d /service/qmail-pop3d/log
    else
      echo qmail-pop3d supervise not running
    fi

10. 将下面内容加入qmailctl脚本的"stop"部分

    echo "  qmail-pop3d"
    svc -d /service/qmail-pop3d /service/qmail-pop3d/log

11. 将下面内容加入qmailctl脚本的"stat"部分

    svstat /service/qmail-pop3d
    svstat /service/qmail-pop3d/log

12. 将下面内容加入qmailctl脚本的"pause"部分

    echo "Pausing qmail-pop3d"
    svc -p /service/qmail-pop3d

13. 将下面内容加入qmailctl脚本的"cont"部分

    echo "Continuing qmail-pop3d"
    svc -c /service/qmail-pop3d

14. 将下面内容加入qmailctl脚本的"restart"部分

    echo "* Restarting qmail-pop3d."
    svc -t /service/qmail-pop3d /service/qmail-pop3d/log

5.2.2. Qpopper

如果你需要一个在mbox格式邮箱下工作的的POP后台服务程序, 你可以选用 Qualcomm的 Qpoper. 可以在这里找到 http://www.eudora.com/products/unsupported/qpopper/.

5.2.3. Binc IMAP

Andreas Hanssen 编写了 Binc IMAP服务器, Binc IMAP被设计为和qmail-pop3d使用相同的认证机制(checkpassword), 所以它很适合于qmail 邮件服务器. 和qmail-pop3d一样, 它只支持maildir格式的邮箱. 参见http://www.bincimap.org/.

5.2.4. Dovecot

Timo Sirainen 编写了Dovecot, 这是一个mbox 和 maildir 格式邮箱都予以支持的 IMAP 和 POP 服务器. 以安全为设计目标. 可以在这里访问到它 http://dovecot.procontrol.fi/.

5.2.5. imap-maildir

David R. Harris 整理了有关 University of Washington IMAP 服务器的关于 maildir 格式支持的补丁, 并且存档了安装过程. 参见http://www.davideous.com/imap-maildir/ .

5.2.6. Courier-IMAP

Sam Varshavchik 编写了一个只支持maildir邮箱的IMAP 服务器. 可以在这里 http://www.courier-mta.org/imap/ 访问.

5.2.7. Cyrus

Carnegi Mellon 大学的Cyrus 项目包含了一个IMAP 服务器, 可以在这里找到它 http://asg.web.cmu.edu/cyrus/imapd/. Rick Updegrove 写了一个qmail到cyrus的脚本用来将邮件传送给Cyrus 存储, 这个http://msgs.securepoint.com/cgi-bin/get/qmail0308/41/1/1.html.

5.3. POP 和 IMAP 客户端

5.3.1. fetchmail

fetchmail 是一个从POP或者IMAP服务器接收邮件并且再次本地注入的程序. fetchmail从qmail服务器接收邮件是没有问题的, 不过作为qmail的客户端, 要让它良好的工作, 有两个技巧.

这里是一个在qmail系统上为某个用户配置的.fetchmailrc例子:

poll mail.example.net proto pop3 nodns
    user dsill with password flubgart is dave here
    fetchall forcecr

这个文件指示fetchmail 通过POP3协议连接mail.example.net服务器, 使用账户dsill , 密码flubgart, 登录并接收所有邮件, 然后传送这些邮件到 dave@localhost. forcecr 标志使fetchmail将每个邮件通过SMTP方式注入本地系统前对邮件的每行以回车符结束. qmail要求如此.

5.3.2. getmail

getmail 从POP服务器接收邮件然后传送到maildir格式的邮箱. 实际上它是个Python 脚本, 所以你在使用getmail之前需要安装Python解释器.

getmail 由 Charles Cazabon 编写, 他在这个位置 http://pyropus.ca/software/getmail/ 为getmail维护了一个网页.

5.4. Multi-RCPT 与 Single RCPT 传送方式的比较

假如你是一个MTA, 你的一个用户发送一封邮件给 hostx.example.com上的三个人. 那么你有以下几种方式可以达成目标.

你可以建立一个连接到hostx主机, 发送邮件的一个拷贝给第一个用户, 发送一个拷贝给第二个用户, 发送一个拷贝给第三个用户, 然后关闭连接.
你可以开始三个进程, 每一个都建立一个和hostx的SMTP连接, 给每个用户发送一份邮件的副本, 然后关闭连接.
你可以建立一个SMTP连接, 然后发送一个标志着传送给所有三个用户的副本, 然后关闭连接.

第一个方法明显劣于第三个. 甚至邮件很小的情况下, 整个邮件传送也需要最长的时间. 如果邮件很大, 那么将会使用很长时间并且浪费大量网络带宽.

所以, 划掉第一个.

第二个和第三个方法有点意思.

第三个方法仅仅建立一个连接到hostx, 而且只发送一个邮件的副本, 这个方式取得了最有效的带宽利用率.

第二种方式建立多个连接, 并且传送了邮件的多个副本, 这是非常浪费带宽的, 不过由于SMTP协议的现状, 这个方式可以得到更少的来回往返延迟, 从而比第三中方式更快. 而且比第三种方式更简单, 进而MTA可以被编写使用一个更直接了当的方式来传送邮件. 最后, 由于每个接收者接收到属于他自己的哪一份邮件副本, 这样才有可能让MTA实现VERPs(参见下一节)

qmail 总是使用第二种方式(single RCPT). 而且没有补丁让qmail实现第三种方式(multiple RCPT)的传送-- 因为那将是一个非常大的修补工作.

虽然有些病态的案例表明第二种方式比第三种方式更慢, 整体上, 系统的简单性和VERP取得的优势比这个更为重要.

Single RCPT 传送方式比multiple RCPT方式的确使用了更多的带宽, 不过差别常常是被夸大了的. 绝大多数邮件至多只有两个接收者, 而他们通常是本别两个主机上的用户, 对于这样的情形, multi-RCPT没有任何优势. 甚至情况特殊些, 在一个邮件列表服务器上, 相对来说, multi-RCPT看起来会有很大帮助可是潜在的增益是非常微小的, 因为SMTP利用的往往只是带宽的很细碎的份额, 在绝大多数连接上, HTTP通常占用了最大的部分.

举一个例子, 如果你的上行带宽的10%用于SMTP, 假设你的SMTP带宽由于使用multiple RCPT被降低了25%, 那么实际上应用multiple RCPT仅仅让你的SMTP需求的总带宽需求降低到了7.5%.

5.5. 关于 VERP

一旦一个邮件未能被传送, MTA的反应应该是按照信封上的返回路径(envelope return path, ERP)发送一个反弹邮件. 反弹邮件应该包括接收者的地址, 未能发送的原因, 以及故障是暂时的还是永久的信息. 尽管某些MTA做的不是正确的事情, 他们发送反弹邮件给邮件头的From区域标志的地址, 或者反弹邮件干脆不能识别接收者.

对于大多数用户到用户的邮件, 这种问题没什么大不了. 人们可以按照反弹定时和邮件内容来处理. 可是对于邮件列表, 糟糕的反弹将会严重的多. 订阅者移动, 转发邮件到他们的新地址, 如果新地址发生传送问题, 并且反弹邮件只包含了新地址, 那就无法知道到底是哪个订户的邮件被反弹了.

Dan Bernstein 为这个问题提出一个解决方案称为VERP(Variable Envelope Return Path). 使用VERP, 发送给每个邮件列表订户的邮件都拥有唯一的返回路径. 这让反弹控制可以控制查找有问题的订阅者.

举一个例子, 一个典型的非VERP邮件列表拥有的返回地址型如listname-owner@domain. 而对于VERP类型的邮件列表, 返回地址型如listname-owner-subscriber=sdomain@ldomain, 这里订户的地址 subscriber@sdomain被嵌入到列表拥有者"owner"和符号"@"之间了. (订阅者邮件地址的"@"符号被置换成等号"=".)

ezmlm邮件列表管理器使用VERP来自动控制反弹. 对于列表暂时的传送问题造成的某些邮件丢失, 这个管理器也提供让订阅者从列表存档文件中单独接收的功能. T

Russell Nelson 为qmail下的Majordomo写了一个反弹控制器, 不过他没有再继续维护这个软件. 可以在这里http://www.qmail.org/bounceman-0.4.shar 访问到它.

5.6. 故障处理

5.6.1. 进程

一个恰当运行着的, 完整的, 最小化安装的qmail 应该拥有下面的四个进程.

由用户qmails 运行的 qmail-send
由用户qmailq运行的qmail-clean
由用户qmailr运行的qmail-rspawn
由用户root运行的qmail-lspawn

取决于你使用的何种UNIX, 下面两个命令的一个可能列出这些进程, 而且可能还要多一点:

    ps -ef | grep qmail
    ps waux | grep qmail

举个例子:

[dave@sparge dave]$ ps waux|grep qmail
dave      2222  0.0  0.8   836   348  p4 S    10:25   0:00 grep qmail
qmaild     351  0.0  1.0   840   400  ?  S N  12:43   0:00 /usr/local/bin/tcpserver -v -x /etc/tcp.smtp.cdb -u 49491 -g 31314 0 smtp /var/qmail/bin/qmail-smtpd-
qmaild    2220  0.0  1.0   844   420  ?  S N  10:25   0:00 /usr/local/bin/tcpserver -v -x /etc/tcp.smtp.cdb -u 49491 -g 31314 0 smtp /var/qmail/bin/qmail-smtpd-
qmaill     365  0.0  0.8   748   344  ?  S N  12:43   0:00 splogger qmail
qmailq     368  0.0  0.7   736   292  ?  S N  12:43   0:00 qmail-clean
qmailr     367  0.0  0.6   732   272  ?  S N  12:43   0:00 qmail-rspawn
qmails     350  0.0  0.8   776   336  ?  S N  12:43   0:00 qmail-send
root       340  0.0  0.6   724   252  ?  S N  12:43   0:00 /usr/local/sbin/supervise /var/supervise/qmail-send /var/qmail/rc
root       341  0.0  0.6   724   252  ?  S N  12:43   0:00 /usr/local/sbin/supervise /var/supervise/tcpserver-qmail /usr/local/bin/tcpserver -v -x /etc/tcp.smtp
root       366  0.0  0.7   736   276  ?  S N  12:43   0:00 qmail-lspawn ./Mailbox
[dave@sparge dave]$

如果你在supervise下运行qmail或qmail-smtpd, 像上面的例子那样, 你应该能看到上面那些进程. 如果你在tcpserver下运行qmail-smtpd, 你将看到一个父tcpserver进程加上每个活动的SMTP访问建立的连接的tcpserver进程.

如果你使用splogger (或者 multilog 或者 cyclog) 来控制日志, 你应该还有一个 splogger(或者 multilog 或者 cyclog) 进程由用户qmaill运行着.

同时, 如果qmail忙于传送本地和远程邮件, 你将会看到最高上限为 concurrencylocal 个数的qmail-local进程, 或者最高上限为 concurrencyremote 个数的qmail-remote 进程.

5.6.2. 日志

5.6.2.1. multilog

multilog, 是daemontools 软件包内的一部分, 功能是将日志记录到指定文件夹内一系列文件上.

日志文件夹将在multilog命令行上指定, 所以你可以检查你的qmail运行脚本来确定文件夹的位置.

log文件夹内文件数量以及每个log文件的最大长度, 是由multilog的选项决定的. log日志文件名是以文件开始记录时刻的TAI (Temps Atomique International) 时间戳命名的. daemontools里面的另外一个命令 tai64nlocal , 可以转换TAI时间戳为易读的本地时间戳.

一个标准的multilog日志条目看起来是下面这样的:

@4000000038c3eeb104a6ecf4 delivery 153: success: did_1+0+0/

"@4000000038c3eeb104a6ecf4"是TAI时间戳, 为可选部分, 不过推荐在日志条目里面加上这个段, "delivery 153: success: did_1+0+0/" 是日志消息本身.

5.6.2.2. splogger

splogger 使用syslog 日志记录系统给消息打时间戳, 然后将消息送往syslog后台服务程序. Syslog的配置文件为 /etc/syslog.conf. 发送给syslog的消息拥有功能和优先级属性. syslog按照定义在/etc/syslog.conf里面的条目过滤消息, 并依据功能和优先级将消息发往以下目标: log日志文件, 远程日志主机, 或者控制台. splogger 默认情况下将记录到mail 功能下面, 所以用grep命令在syslog.conf文件里面查找"mail"可以显示出qmail的日志消息的配置.

典型的位置包括:

/var/log/syslog
/var/adm/SYSLOG
/var/log/maillog

典型的syslog日志条目看起来是这样的:

Jun  3 11:35:23 sparge qmail: 928424123.963558 delivery 153: success: did_1+0+0/

"Jun 3 11:35:23" 是syslog时间戳

"sparge" 是发送这条消息的系统名子.

"qmail:" 是splogger 放置在所有qmail日志条目前的标签.

"928424123.963558" 是一个可选的TAI 时间戳 (参看下一节)

"delivery 153: success: did_1+0+0/" 是日志消息本身.

5.6.2.3. 日志消息

下面是一段从本地系统发送一个邮件到远程系统的日志片断:

1 @4000000038c3eeb027f41c7c new msg 93869
2 @4000000038c3eeb027f6b0a4 info msg 93869: bytes 2343 from <dave@sill.org> qp 18695 uid 49491
3 @4000000038c3eeb02877ee94 starting delivery 2392: msg 93869 to remote lwq@w3.to
4 @4000000038c3eeb0287b55ac status: local 0/10 remote 1/20
5 @4000000038c3eeb104a13804 delivery 2392: success: 209.85.127.177_accepted_message.
   /Remote_host_said:_250_CAA01516_Message_accepted_for_delivery/
6 @4000000038c3eeb104a4492c status: local 0/10 remote 0/20
7 @4000000038c3eeb104a6ecf4 end msg 93869

第 1 行指出qmail接收到一条新邮件, 邮件的队列ID是93869. 队列ID是 /var/qmail/queue/mess/NN/ 包含这个邮件的队列文件的 i-node 节点值. 队列ID将在这个消息存在于队列的过程中保持全局唯一.

第 2 行表明邮件来自 dave@sill.org, 并且大小为2343字节.

第 3 行表明qmail-remote开始传送这个邮件到lwq@w3.to, 并且为这个传送指定了ID 2392.

第 4 行指出 0 个本地传送和 1 个远程传送处于等待状态.,

第 5 行显示出 ID 2392 这个传送已经成功完成, 并且返回远程主机的回应, 这个回应里面常常包含了远程邮件管理员对于跟踪这个传送的有用信息. 在我们这个例子里面, "CAA01516"是远程系统的传送ID.

第 6 行指出 0 个本地传送和 0个远程传送处于等待状态. 也就是传送已经完成了.

第 7 行指出这个消息已经被传送完毕并且被移出队列. 这个时候, 队列ID 93869, 已经可以重用于其他传送ID了.

5.7. 大型服务器

同时参考 qmail-ldap

5.7.1. 可伸缩的并行运算

使用快速NFS网络文件服务器储存用户文件夹. 在文件服务器上建立多个平等优先级SMTP服务器传送maildir格式邮箱.

5.8. 从 Sendmail 转移到 qmail

查看Dan Bernstein 的 Sendmail->qmail 网页 http://cr.yp.to/qmail/sendmail.html.

5.9. 邮件列表管理器

邮件列表管理器(MLM)是帮助邮件列表所有者运行邮件列表的的程序. 它的功能由两部分组成: 管理订阅者列表, 还有就是控制对订阅者的邮件再发.

大多数(全部?)UNIX邮件列表管理器都可以和qmail 合作运行.

5.9.1. ezmlm

ezmlm 是qmail的作者Dan Bernstein为qmail编写的邮件列表管理器. 它依赖于qmail服务器的几个特点工作, 最显著的, 就是它使用VERPs 来可靠的处理反弹邮件. ezmlm 在众多邮件列表管理器(MLM)中显得有点独特, 它不是处理传送到中央MLM地址的命令, 而是将命令附加在列表名字后面. 例如, 发送邮件到"foo-subscribe@list.example.net" 来订阅 "foo@list.example.net" 的邮件列表, .

关于ezmlm的更多信息, 参见 http://www.ezmlm.org/, 这是ezmlm的非正式web站点. ezmlm-idx的正式站点, 介绍了这个非常棒的add-on插件ezmlm-idx, 它包括了很多有用的特色.

5.9.2. Majordomo

Majordomo 是最受欢迎的UNIX MLM之一. 只要作很少的简单修改就可以使它和qmail很好的合作了. Russ Allbery曾经写了一个关于qmail和Majordomo的FAQ, 可以在这个位置访问http://web.archive.org/web/20050308091420/http://www.eyrie.org/~eagle/faqs/mjqmail.html.

5.10. 补丁 Patches

qmail拥有各种各样的源代码补丁. 为了安装补丁, 下载补丁并且进入qmail源代码目录树, 使用patch 命令施加补丁.

    cd /usr/local/src/qmail/qmail-1.03
    patch -p0 </tmp/patchfile

注意: 参考 patch 的 man 帮助页取得更多信息. 这仅仅是个例子. 你可能需要使用最新版本的GNU patch 来施加补丁, 参见http://www.gnu.org/software/patch/patch.html.

终止 qmail-send 来停止qmail, 或者如果你安装了 qmailctl 脚本, 那么这样:

    qmailctl stop

然后重新编译和安装新的二进制代码:

    make setup check

然后重新启动:

    qmailctl start

最后测试qmail, 尤其是你打补丁的部分.

注意: 虽然http://www.qmail.org/列出了qmail的大量补丁, 但是他们中的任何一个都没有得到qmail作者的认可. 这些补丁可能引入qmail原本没有的安全, 可靠性, 效率以及功能性问题. 绝大多数qmail安装只是要求某些推荐的补丁. 请不要安装任何你不是明确需要的补丁.

5.10.1. 推荐的补丁

qmail.org 有一个"Recommended Patches"小节 http://qmail.org/top.html#patches . 这些补丁用于几个已知的qmail的bug.

注意: 所有推荐补丁都已经包括在 netqmail发行版中. 请参考http://www.qmail.org/netqmail/.

5.10.1.1. errno.h 补丁

这个补丁修复 errno.h 头文件缺失问题. 参考http://article.gmane.org/gmane.mail.qmail.general/13960 查看这个补丁, 以及的详细的解释.

Mate Wierdl 为所有 Dan Bernstein 的软件, 其中包括 qmail, daemontools 和 ucspi-tcp 编写了关于 errno.h 的补丁. 可以在这里找到这些补丁文件: http://www.thedjbway.org/patches/djb_errno_patches.tgz.

5.10.1.2. qmail-local TAB 补丁

这个补丁修补处理.qmail文件内对TAB 字符开头命令解析的小bug. 参见http://www.ornl.gov/lists/mailing-lists/qmail/2000/10/msg00696.html

5.10.1.3. IP 0.0.0.0 补丁

这个补丁将使qmail把 0.0.0.0 这个IP地址作为本地主机处理. http://www.suspectclass.com/~sgifford/qmail/qmail-0.0.0.0.patch .

5.10.2. DNS

在历史上, DNS 的回答被限制在512字节以内. 一些大型站点返回的 MX 记录要长于这个限度. 这样qmail和其他很多程序都会遇到这个DNS返回查询记录过长的问题. 有两种种方式来修补qmail, 其中任何一个都够用了.

5.10.2.1. Christopher K. Davis 的补丁程序, http://www.ckdhr.com/ckd/qmail-103.patch

Chuck Foster 写了一个补丁修正, 可以配合任何一种DNS 解析库工作, 无论多老的库, 这个补丁使用一个保护字节来避免"置于缓冲区中的字节数"这个库bug. 通过一次性重分配缓冲区为65536大小, 而不是申请分配恰好合适的缓冲区大小来解决问题, 所以它可能要比Chuck 的补丁内存使用效率低. (尽管如此, 这个补丁也只是当返回大小大于PACKETSZ 情况下才进行缓冲区重分配, PACKETSZ 的默认大小为512字节). 缓冲区重分配后, 将强制一次TCP查询, 而不是要求DNS 解析库去作解析(这样避免了qmail 和名字服务器之间的额外来回交互过程, 尽管qmail 和名字服务器可能都在一个服务器上, 或者都在本地网络内, 这些来回交互过程并不是什么问题).

5.10.2.2. 提高包缓存长度到65536

如果DNS反馈设置有切断位, 在近来的BIND解析库下工作时, 解析器编码为自动进行TCP查询. 虽然取决于你的系统如何管理系统内存页的情况下, 内存的最大浪费成为潜在存在的可能性, 不过这却是最简单的修补. 作这个修补, 只需要替换 dns.c 文件内的PACKETSZ为 65536, 然后重新编译安装qmail就行了.

5.10.2.3. 从djbdns 运行 dnscache

dnscache 顾名思义, 是一个DNS的缓存服务器. 它知道如何掌握很长的DNS 返回记录, 去掉不必要的查询信息, 所以通过它返回的结果通常比直接查询更小, 并且通常可以为所有服务提高DNS查询性能. 由于它不用给qmail打补丁, 这是一个可以接受的方式, 遗憾的是, 它并不能完全解决问题, 通过它返回可能对qmail 还是过大. 参见相关软件包下的 djbdns 节取得更多信息.

5.10.3. qmail-ldap

这个补丁, 由 Andre Oppermann等人编写, 实现了qmail的Lightweight Directory Access Protocol (LDAP)支持. LDAP像一个网络电话簿. 使用 qmail-ldap, 它可以使一个POP服务器支持数千计的众多用户. 参见http://www.nrg4u.com/.

5.11. QMTP

QMTP 是 Quick Mail Transfer Protocol 的缩写, 由Dan Bernstein设计的用来替代SMTP的协议. 这个协议定义在 http://cr.yp.to/proto/qmtp.txt . QMTP比SMTP更简单, 更快速以及兼容SMTP. qmail包含一个QMTP服务器, qmail-qmtpd, 它运行起来非常类似于 qmail-smtpd. QMTP通常使用端口209.

qmail并不包括QMTP的客户端, 不过 serialmail 软件包包括一个客户端. maildirqmtp 命令接收maildir格式邮箱并以QMTP协议传送邮箱内的邮件到指定的QMTP服务器.

QMTP不是一个drop-in方式的SMTP的替代品, 在因特网上的使用也不是很普遍.

Russ Nelson 为qmail-remote写了一个支持QMTP的补丁. 可以在这里 http://www.qmail.org/qmail-1.03-qmtpc.patch 取得这个补丁. 他也编写了一个tarball安装方式的程序, 可以展开到 /service 目录下进行QMTP服务. 可以在这里http://www.qmail.org/qmtpd-service.tar.gz 取得这个tarball包.

5.12. 在SMTP对话过程中拒绝无效接收者

当一个远端服务器连接到 qmail-smtpd服务并提交了一个邮件时, qmail-smtpd服务会依据 control或 rcpthosts的内容来检查收件人的地址. 如果接受者的服务器名或域名(就是邮件地址在@符号后面的部分)在这两个列表内存在,qmail-smtpd 会接受这封邮件, 并将邮件放置于发送队列内, qmail-send 将开始尝试传送邮件. 如果通过名字在本地接收者内查找不到接收用户或者别名, 即本地接收者无效, qmail-send 会生成一个反弹邮件并将邮件传送到回复地址, 这个回复地址在SMTP对话过程中确定.

在一个秩序并礼貌的世界, 任何策略或计谋都是有好的结果的. 但很不幸, 除此之外, 还有很多行为恶劣的垃圾邮件制造者. 一些垃圾制造者试图把邮件发送到你服务器上"可能"存在的用户邮箱, 他们使用常用名字字典或数据库, 甚至他们穷举所有可能的字母组合来构成一本名字字典, 向整个字典或数据库内所有"可能"存在的人发送垃圾邮件.

在qmail 系统内, 这种垃圾邮件行为会造成巨大的系统负担, 邮件队列内充斥垃圾, 并且耽搁了合理合法邮件的传送.

一些MTA 在SMTP 对话过程中对本地邮件接收者进行确认并对不匹配的邮件予以拒绝, 这免去了邮件服务器大量的不必要工作, 但也带来了负面影响, 使用这种校验方式, 垃圾邮件制造者可以迅速确定那些邮件地址在你的服务器上是存在的.

有几种方式可以在qmail 上实现在SMTP 对话过程中校验用户名是否存在. Eben Pratt 建立了一个列表, 在这里http://netdevice.com/qmail/rcptck/ . 绝大多数这种解决方案都要求提供一个有效或无效接收者的数据库或者相应模式. 其中一个不使用数据库的解决方式是Paul Jarc 的qmail-realrcptto, 可以在这里找到它http://code.dogmap.org./qmail/.

5.13. TLS and STARTTLS

关于在qmail 上使用传输层加密(TLS), Scott Gifford 写了一个非常详细彻底的一步一步介绍文档, 包括在SMTP 上使用STARTTLS 和在POP3D 上使用STLS, 专门用于netqmail , 可以在这里访问这个文档: http://www.suspectclass.com/~sgifford/ucspi-tls/ucspi-tls-qmail-howto.html.

附录 A. 致谢

首先, 感谢Dan Bernstein 编写了这样一个强大而优雅的系统. 经过近十年的使用, qmail依然给我深刻的印象.

我也感谢那些qmail 邮件列表的成员. 作为最有帮助的, 最有耐心的, 以及最知识渊博和有趣的撰稿人之一, Russell Nelson 应该被特别提及, 他对于qmail 社区的贡献仅次于DJB. 其次是Charles Cazabon, 他紧接着Russ 之后, Charles 是最近邮件列表的主要撰稿者, 比其他人更多的给出正确答案. Charles 还写了两个非常有用的实用程序--getmail 和pymsgauth, 同时还是The qmail Handbook 的技术编辑, 他的文章被认为是此书成功的重要原因, 因此他也得到了不少奖赏和赞誉.

感谢每一个评论或者对这个文档作出贡献的人, 他们包括:

Vince Vielhaber
Chris Green
Christopher K. Davis
Scott Schwartz
Fred Lindberg
Russell P. Sutherland
Alex Miller
Tim Hunter
Frank D. Cringle
Mahlon Smith
Rogerio Brito
Tony Hansmann
Matthias Andree
Tillman Hodgson
Stefan Witzel
Scott Gifford
有太多可被提及的其他的人了....

特殊感谢Henning Brauer捐赠了lifewithqmail.org 域名, 并维护服务器!

Life with qmail 使用Simple Document Format (SDF) 编写, SDF是一个非常酷的基于Perl 的标记语言, 可以产生HTML, 纯文本, PostScript, POD以及其他格式. 这个工具使工作变得特别容易, 参见http://search.cpan.org/author/IANC/sdf-2.001/ 查找关于这个工具的更多信息.

附录 B. 相关软件包介绍

B.1. dot-forward

Sendmail 使用.forward(发音 dot forward)文件来允许用户控制传输他们收到的邮件. qmail使用一种类似的机制: .qmail文件. dot-forward软件包给予qmail使用.forward文件的能力. 那些使用Sendmail和其他使用.forward控制文件的系统可以利用dot-forward程序来避免使用.forward文件的等效物.qmail文件, 在转移到qmail 品太过程中不用将.forward 文件转换为.qmail 文件, 或者简单地对于用户来说, 在使用qmail平台时尽量少的改变用户原来使用Sendmail时看得到的东西., 比如直接使用. forward文件的习惯.

dot-forward程序是一个小软件包, 很容易安装配置. 源代码可以在http://cr.yp.to/software/dot-forward-0.71.tar.gz.这里取得.

dot-forward 由Dan Bernstein编写, 他为这个软件维护了一个web页面http://cr.yp.to/dot-forward.html.

B.2. fastforward

fastforward是另一个Sendmail兼容插件. Sendmail使用保存在一个单一文件内的中心别名数据库, 通常是 /etc/aliases. qmail使用/var/qmail/alias下的一系列文件, 一个别名一个文件. 如果你要从Sendmail迁移到qmail, dot-qmail文件还不想转换Sendmail格式的的别名文件, 那么fastforward赋予qmail按照原样使用Sendmail别名文件的能力.

源代码可以在 ftp://cr.yp.to/software/fastforward-0.51.tar.gz 这里取得.

fastforward 由Dan Bernstein 编写, 他在 http://cr.yp.to/fastforward.html 这里维护了一个web页面.

B.3. ucspi-tcp

qmail的SMTP服务器并不是按照一个独立的后台服务程序运行的, 必须依靠例如 inetd, xinetd 或者 tcpserver 这些助手程序运行. 当这些助手程序接受一个到达25端口, SMTP端口, 的TCP连接之后, 将执行一个qmail-smtpd的副本.

inetd 是标准网络服务器"super-server". 可以通过配置/etc/inetd.conf 来运行qmail-smtpd, 不过推荐的工具是tcpserver, 它是ucspi-tcp软件包的一部分. ucspi-tcp是UNIX Client-Server Program Interface for TCP的缩写, 发音是 ooks-pie tee see pee.

tcpserver 优于 inetd的几条原因:

tcpserver 允许限制并行访问服务的数量. inetd使用连接率限制机制在"太忙"情况下阻断服务.
tcpserver 可以被配置为拒绝某些主机连接或者认可并标志本地主机, 使qmail-smtpd 可以分别对待.
tcpserver 是唯一的qmail 作者认可的服务器.

源代码可以在这里ftp://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz取得.

Gerrit Pape 为ucspi-tcp作为 man 帮助页分发的文档可以在这里http://smarden.org/pape/djb/ 访问到.

ucspi-tcp由Dan Bernstein编写, 他在这里http://cr.yp.to/ucspi-tcp.html维护了一个web页.

B.4. daemontools

daemontools软件包包含了一系列控制和监视服务的实用工具. 不强制使用, 但高度推荐, 特别是对于比较繁忙的系统. 它包括:

superivse, 监视服务并在服务停止后重新启动之.
svc, 用来要求supervise 停止, 暂停, 或者重启动服务器.
multilog, 维护服务的日志, 可以自动回转记录以保持低于配置大小.
seruidgid, 使用普通用户的UID和GID为超级用户运行程序.

daemontools的源码可以在这里http://cr.yp.to/daemontools/daemontools-0.76.tar.gz取得.

Gerrit Pape 为daemontools作为 man 帮助页制作的发行文档可以在这里http://smarden.org/pape/djb/访问到.

daemontools 由Dan Bernstein编写, 他在这里http://cr.yp.to/daemontools.html 维护了一个web页面.

B.5. qmailanalog

qmailanalog处理qmail的日志文件并且生成一系列的报告. 报告指示出系统正在工作的类型和工作量. 如果你需要有多少邮件被发送和接收的统计, 以及他们有多大, 他们被处理的有多快, qmailanalog都能显示出来.

作为一个意外收获, matchup 程序合并qmail 的每个邮件投递的多个日志行为一行 -- 有点类似于Sendmail的日志.

qmailanalog的源代码可以在这里http://cr.yp.to/software/qmailanalog-0.70.tar.gz取得.

qmailanalog 由Dan Bernstein编写, 他在这里http://cr.yp.to/qmailanalog.html维护了一个web页面.

注意: qmailanalog 依赖于由accustamp 使用的小数秒格式的日志条目时间戳. 为了使用它和multilog生成的TAI64N格式的日志, 你必须将他们转换成旧格式. 一个完成这个转换工作的程序可以在这里http://www.qmail.org/tai64nfrac取得.

B.6. rblsmtpd

如果你从未被垃圾邮件骚扰, 可以说你太幸运了. 绝大多数的电子邮件用户都太熟悉Unsolicited Bulk E-mail (UBE)了, UBE也被称为"spam". 绝大多数垃圾邮件都是色情站点的广告, 邮件锁链或其他诡计. 回到过去的的旧时光, 直到1998年左右, 绝大多数因特网上的MTA都是开放转信的, 也就是说, 他们将会接收任何人给人和人的邮件, 甚至没有发信人也没有本地收信人的邮件. 垃圾邮件发送者利用这些开放转信服务, 尽可能找到他们能找的服务器传送他们的垃圾邮件. 这样就隐藏了他们的踪迹, 栽赃给那些"无罪的"开放转信站点, (通过浪费开放转信站点的资源) 为垃圾邮件制造者节省了大量的CPU和带宽.

从那个时期开始, 这样的开放转信的站点被认为是非常糟糕的, 几个反垃圾邮件义务组织创造了一个机制来识别开放转信和其他垃圾邮件的通常来源, 这样他们就能够避免来自垃圾邮件商的SMTP连接.

rblsmtpd 是一个 RBL SMTP后台服务程序. 它位于tcpserver和qmail-smtpd之间, 并且拒绝系统认定的那些列表里面系统的连接.

举一个例子, 在tcpserver下运行rblsmtpd, 试试下面这样的写法:

#!/bin/sh
QMAILDUID=`id -u qmaild`
NOFILESGID=`id -g qmaild`
MAXSMTPD=`cat /var/qmail/control/concurrencyincoming`
exec /usr/local/bin/softlimit -m 2000000 \
  /usr/local/bin/tcpserver -v -R -H -l 0 -x /etc/tcp.smtp.cdb -c "$MAXSMTPD" \
    -u "$QMAILDUID" -g "$NOFILESGID" 0 smtp /usr/local/bin/rblsmtpd\
    -r relays.ordb.org /var/qmail/bin/qmail-smtpd 2>&1

rblsmtpd 以前是作为一个分立的软件包, 现在被捆绑在ucspi-tcp 里面.

rblsmtpd 由Dan Bernstein 编写, 他在这里http://cr.yp.to/ucspi-tcp/rblsmtpd.html 维护了一个web页面.

RBL 硬编码不再free 之后, Charles Cazabon 制作了一个补丁用来移去默认的RBL 硬编码, 替换为为rblsmtpd 程序, 这个程序可以在这里访问到 http://pyropus.ca/software/misc/rblsmtpd-nodefaultrbl.patch.

B.7. serialmail

qmail 是为高速连接, 不间断运行设计的. serialmail 这个工具集让qmail更好的适用于断断续续的, 低速的连接. 在这样的系统上使用serialmail, qmail被配置为传送所有远程邮件到一个单独的maildir文件夹. 一旦网络连通, serialmail的maildirsmtp 命令将用来上传这个maildir到ISP的邮件中心. 如果ISP支持QMTP(参看高级话题下的 QMTP), maildirqmtp也能用得上.

serialmail 可以被用于ISP方面, 用来实现 AutoTURN, 这是一个由客户端发起的SMTP 连接, 导致服务器开始反向连接到客户端 , 然后发送服务器端的邮件队列给客户端的过程. 这个和ETRN SMTP机制很相似.

serialmail的源代码可以在这里http://cr.yp.to/software/serialmail-0.75.tar.gz 得到.

serialmail 由Dan Bernstein编写, 他在这里http://cr.yp.to/serialmail.html维护了一个web页面.

B.8. mess822

mess822 是一个处理 RFC822兼容邮件的库和一系列应用程序. 这些程序包括:

ofmipd: 一个后台服务程序,从客户端接收邮件并基于数据库记录改写From邮件头部分.
new-inject: 一个qmail-inject的替代程序, 支持用户控制的主机名改写.
iftocc: 一个.qmail应用程序, 用来检查是否邮件被发送到指定地址.
822header, 822field, 822date, 和 822received: 从邮件中摘录信息.
822print: 用来打印邮件.

mess822的源代码可以在这里 http://cr.yp.to/software/mess822-0.58.tar.gz取得.

mess822 由Dan Bernstein编写, 他在这里http://cr.yp.to/mess822.html维护了一个web页面.

B.9. ezmlm

ezmlm 是一个为qmail设计的高效, 易用的邮件列表管理器(MLM). 如果你熟悉 LISTSERV 或者 Majordomo, 你会知道邮件列表管理器能作什么. 更多在qmail下的关于邮件列表的信息可以在高级话题下面的邮件列表管理器找到.

ezmlm的源代码可以在http://cr.yp.to/software/ezmlm-0.53.tar.gz这里取得.

ezmlm 由 Dan Bernstein编写, 他在这里http://cr.yp.to/ezmlm.html维护着一个web页面.

Fred Lindberg 和 Fred B. Ringel 为ezmlm开发了一个扩展, 叫做ezmlm-idx, 后者增加了大量的有用特色, 我特别推荐使用它. 可以在 http://www.ezmlm.org/ 这里访问 ezmlm-idx, 这个页面现在有Bruce Guenter 维护.

B.10. safecat

safecat 将文件可靠的写入maildir 邮箱中. 在使用procmail 处方时候有个特别的用处, 用来将邮件填入 procmail. 举一个例子, 下面的处方将所有Maildir中的邮件存档.

:0w
|safecat Maildir/tmp Maildir/new

safecat 由 Len Budney 编写, 他在这里http://jeenyus.net/~budney/linux/software/safecat.html.为safecat 维护了一个web页面.

B.11. djbdns

djbdns 是qmail作者编写的DNS服务器. 它包括 tinydns, 一个DNS内容服务器, 和 dnscache, 这是一个 DNS 缓冲服务器.

djbdns的正式页面在 http://cr.yp.to/djbdns.html.

B.12. maildrop

maildrop是一个和procmail类似的邮件过滤器.

maildrop 由 Sam Varshavchik 编写, 他在这里http://www.courier-mta.org/maildrop/.为maildrop维护了一个web页面.

B.13. syncdir

syncdir 是一个小型库, 可使 link() 系统调用同步. 在一个不能同步执行 link() 的文件系统上运行qmail队列时, syncdir是必要的. 例如 Linus的 ext2fs, Reiserfs, SGI的 XFS以及BSD的使用softupdates的FFS系统.

syncdir 由 Bruce Guenter编写, 可以在这个web页面http://untroubled.org/syncdir/访问. 安装指导在这个位置http://www.ornl.gov/lists/mailing-lists/qmail/2001/12/msg00949.html.

附录 C. 因特网邮件工作原理

C.1. 邮件如何从A点到达B点

当一个主机上的用户想要发送一个邮件给另一个主机上的用户时, 许多事情发生了, 这个场景后面的东西很多是不必要知道的那么确切的.

假设一个用户 Alice, alice@alpha.example.com 想要发送一个邮件给 Bob, bob@beta.example.com, 下面是发送接收过程:

1. Alice 用她的邮件用户代理(MUA)编写邮件, 比如使用 mutt 或者 pine. 她在 To 这一栏指定接收者, Subject 这一栏填写邮件主题, 加上邮件本身的文本部分. 整个邮件看起来是下面这样的:

    To: bob@beta
    Subject: lunch

    How about pizza?

2. 当她觉得这封邮件已经满意之后, 她指示 MUA 发送邮件.

3. 这时候, MUA 会加上附加的邮件头部分, 比如日期 Date 和邮件ID(Message-Id) 并且修改Alice输入的值(例如, 将 bob@beta 替换为"Bob <bob@beta.example.com>") 下一步, MUA 将邮件注入邮件系统. 有两种方式进行注入: MUA 运行一个由邮件系统提供的为注入邮件为目的的程序; 或者使用SMTP协议和本地或者远程邮件服务器建立连接, 在本例内, 我们假定 MUA 使用本地注入程序将邮件传送给 MTA, 对于不同的MTA, 注入细节都是不同的, 不过对于UNIX系统, 使用sendmail 程序注入已经成了事实上的标准. 使用这种方式, MUA 可以将邮件头和邮件主体放置在一个文件内, 由空行分隔, 然后传递这个文件到 sendmail 程序.

4. 如果注入成功--邮件句法正确, 并且 sendmail 调用适当--那么现在邮件由 MTA 负责. 不同的 MTA 细节是完全不同的, 通常MTA首先检查邮件头决定邮件将发往何处. 然后建立一个到主机beta的SMTP连接, 转发邮件给 beta 系统上的MTA. SMTP对话要求邮件被分成两部分发送: 第一部分是信封, 这个部分确定了接收者的地址(bob@beta.example.com)和返回地址(alice@alpha.example.com), 以及第二部分邮件本身, 包括邮件头和邮件主体.

5. 如果beta主机的MTA拒绝这个邮件, 可能原因是在beta系统上没有这个bob用户, 在alpha 上的MTA发送一个反弹邮件给返回地址, 也就是 alice@alpha, 通知她邮件发送出现了问题.

6. 如果 beta主机上的 MTA接收了邮件, 它查看接收者地址, 决定是发送给本地local 还是远程 remote系统的邮件. 这个例子里面, 接收者是本地用户, 然后MTA或者传送邮件给 mail delivery agent (MDA), 比如 /bin/mail或者传送给 procmail.

7. 如果传输失败了, 可能是Bob的邮箱超过了使用限额, beta 主机上的 MTA 将发送一个反弹信息给信封上的返回地址, 即 alice@alpha.

8. 如果传输成功, 邮件将在Bob的邮箱中等待, 直到他使用MUA来阅读和显示邮件.

C.2. 其他资料 C.2. More information

关于因特网邮件工作方式的更多信息, 请查看下面的信息:

Internet mail, 由qmail作者撰写 http://cr.yp.to/im.html .
SMTP, 由qmail作者撰写 http://cr.yp.to/smtp.html
Internet mail message header format, 由qmail作者撰写 http://cr.yp.to/immhf.html

C.2.1. 因特网的RFC文档

Internet Requests for Comment, 缩写为Internet RFC是关于因特网标准的正式文档. 大部分Internet RFC 文档已经度过了评论阶段, 进入稳定状态, 他们定义了包括诸如 TCP, FTP, Telnet和各种各样得邮件标准和协议.

RFC 821, Simple Mail Transfer Protocol (obsoleted by RFC 2821) http://www.ietf.org/rfc/rfc0821.txt
RFC 822, Standard for the Format of ARPA Internet Text Messages (obsoleted by RFC 2822) http://www.ietf.org/rfc/rfc0822.txt
RFC 931, Authentication Server. http://www.ietf.org/rfc/rfc0931.txt
RFC 974, Mail Routing and the Domain System. http://www.ietf.org/rfc/rfc0974.txt
RFC 1123, Requirements for Internet Hosts -- Application and Support. http://www.ietf.org/rfc/rfc1123.txt
RFC 1413, Identification Protocol. http://www.ietf.org/rfc/rfc1413.txt
RFC 1423, Privacy Enhancement for Internet Electronic Mail: Part III: Algorithms, Modes, and Identifiers. http://www.ietf.org/rfc/rfc1423.txt
RFC 1651, SMTP Service Extensions. http://www.ietf.org/rfc/rfc1651.txt
RFC 1652, SMTP Service Extension for 8bit-MIMEtransport. http://www.ietf.org/rfc/rfc1652.txt
RFC 1806, Content disposition. header. http://www.ietf.org/rfc/rfc1806.txt
RFC 1854, SMTP Service Extension for Command Pipelining. http://www.ietf.org/rfc/rfc1854.txt
RFC 1891, SMTP Service Extension for Delivery Status Notifications. http://www.ietf.org/rfc/rfc1891.txt
RFC 1892, The Multipart/Report Content Type for the Reporting of Mail System Administrative Messages. http://www.ietf.org/rfc/rfc1892.txt
RFC 1893, Enhanced mail system status codes. http://www.ietf.org/rfc/rfc1893.txt
RFC 1894, An Extensible Message Format for Delivery Status Notifications. http://www.ietf.org/rfc/rfc1894.txt
RFC 1939, Post Office Protocol - Version 3. http://www.ietf.org/rfc/rfc1939.txt
RFC 1985, SMTP Service Extension for Remote Message Queue Starting (ETRN). http://www.ietf.org/rfc/rfc1985.txt
RFC 1991, PGP Message Exchange Formats. http://www.ietf.org/rfc/rfc1991.txt
RFC 2015, MIME Security with Pretty Good Privacy. (PGP). http://www.ietf.org/rfc/rfc2015.txt
RFC 2045, MIME Internet message bodies. http://www.ietf.org/rfc/rfc2045.txt
RFC 2046, MIME Media Types. http://www.ietf.org/rfc/rfc2046.txt
RFC 2047, MIME Headers. http://www.ietf.org/rfc/rfc2047.txt
RFC 2048, MIME Registration Procedures. http://www.ietf.org/rfc/rfc2048.txt
RFC 2049, MIME Conformance Criteria. http://www.ietf.org/rfc/rfc2049.txt
RFC 2142, Mailbox names for common services. http://www.ietf.org/rfc/rfc2142.txt
RFC 2183, Content Disposition header. http://www.ietf.org/rfc/rfc2183.txt
RFC 2821, Simple Mail Transfer Protocol. http://www.ietf.org/rfc/rfc2821.txt
RFC 2822, Internet Message Format http://www.ietf.org/rfc/rfc2822.txt

一个综合性的邮件相关RFC列表可以在Internet Mail Consortium的web网站上找到 http://www.imc.org/mail-standards.html.

附录 D. 体系结构

D.1. 模块化系统结构

因特网MTA可以完成多种任务. 早期如 Sendmail和 smail的设计是整体式的, 换句话说就是他们是一个大而复杂的程序, 其中一部分是SMTP服务器, 另一部分是SMTP客户端, 另外的是本地邮件注入, 还有管理邮件队列的部分,等等.

qmail是模块化的, 每个功能都是由单独的程序执行的, 结果程序更小, 更简单, 而且更不容易出现功能和安全方面的问题. 为了进一步增强qmail的安全性, qmail模块以不同的权限模式运行, 模块之间互不"信任", 他们并不以为其他模块总是按照他们假定的方式去运行.

这些是qmail的核心模块:

模块	功能
qmail-smtpd	接收/拒收通过SMTP传递的邮件
qmail-inject	本地邮件注入
qmail-rspawn/qmail-remote	控制远程传输
qmail-lspawn/qmail-local	控制本地传输
qmail-send	处理队列
qmail-clean	清除队列

模块化也有一些不利因素, 整体式的MTA, 模块之间的相互作用定义良好, 而且模块之间只是交换最小的必要信息. 这是个大好事, 但模块化方式使处理某些事情变的困难起来. 举个例子, 为了debug目的, 运行sendmail 并使用"-v"选项, 使 Sendmail 打印它的活动跟踪消息到标准输出, 由于所有的包括邮件注入, 队列控制, 别名处理, .forward文件处理, 以及远程SMTP转发邮件等等都是由一个 sendmail 二进制程序控制, 那么可以很容易的跟踪整个邮件传送过程直到邮件被送抵目的地. 这样的等价物在qmail里面是不存在的, 如果在qmail上执行这样的"debug"过程, 需要实质性的改变源码以及在模块到模块之间的过程调试, 这增加了的很大复杂性.

D.2. 文件结构

/var/qmail 是qmail的文件结构的根. 在qmail 编译安装的时候可以选择改变这个目录的位置, 不过最好还是不作改动的安装到默认位置, 这样其他的管理员就知道到哪里能找到需要的东西. 如果你真的想重新定位部分或者全部的qmail 目录树, 最好的办法是使用符号连接方式. 详细信息请参看创建目录小节中的细目.

目录	内容
alias	系统级别名定义的.qmail文件
bin	二进制程序和可执行脚本
boot	启动脚本
control	配置文件
doc	文档(不包括man 手册页)
man	man 手册页
queue	未送出的邮件
users	qmail-users 的数据库文件

D.3. 队列结构

在qmail的安装目录下的 INTERNALS文件更充分的讨论了有关的细节信息. 下面是一些更宽泛的队列结构的概述.

子目录	内容
bounce	永久传送错误
info*	信封发送者地址
intd	由qmail-queue构建的信封
local*	本地信封接收者地址
lock	文件锁文件
mess*	邮件文件
pid	由qmail-queue使用用来获得 i 节点编号
remote*	远程信封接收者地址
todo	完整的信封

注意: 由"*"标志的目录包含了一系列分开的由"0", "1",..., (最大数字直到conf-split 减去 1)这些数字命名的子目录. 这里conf-split 是由源代码目录下的conf-split 文件设定的一个参数, 在编译源码时确定, 默认是23. 分离出多个子目录是为了在繁忙的服务器上降低单个目录里面的文件数量. conf-split 必须是个质数.

在mess组目录下的文件由它们的 i 节点编号命名. 这就意味着你不能使用标准的UNIX工具, 比如mv, dump/restore还有 tar来手动地移动这些文件. 这里有两个用户提供的实用工具, 可以使用它们来正确地重命名队列文件. 可以在这里http://www.qmail.org/ 找到这些工具.

注意: 当qmail正在运行地时候, 修改队列文件是不安全的. 如果你想更改队列, 首先停止 qmail, 然后仔细的处理队列, 然后重启qmail.

D.4. 图片

在 /var/qmail/doc 下面有一系列的以 PIC 名字开头的文件. 这些是qmail处理不同情况的文本"图片". 它们显示了qmail 在各个模块之间处理的控制流, 在处理问题和建立复杂系统配置的时候这些图片将大有裨益.

文件名	处理场景
PIC.local2alias	传递给本地别名的本地注入邮件
PIC.local2ext	传递给扩展地址的本地注入邮件
PIC.local2local	传递给本地用户的本地注入邮件
PIC.local2rem	传递给远程地址的本地注入邮件
PIC.local2virt	传递给本地虚拟域上的一个地址的本地注入邮件
PIC.nullclient	注入到空用户的邮件
PIC.relaybad	使用本地主机转信失败的尝试
PIC.relaygood	使用本地主机转信成功的尝试
PIC.rem2local	通过SMTP为本地用户接收邮件

这些图片也可以在线观看, 地址如下:

http://www.qmail.org/man/index.html

如果你想看qmail的"真实"图片, 那么请查看Andre Opperman 的 "big qmail picture", 地址在http://www.nrg4u.com/ .

附录 E. 一些不常见的问题 Infrequently Asked Questions

一些没有资格称为常见问题的问题, 可是还是很重要也不容易回答的.

E.1. qmail如何处理延期发送的邮件?

每个邮件都有自己的重试时间表, 越长时间不能发送的邮件, 得到qmail重发的机会就越少. 重试时间表是不可更改的. 下面的表格显示了一个发往远程接收者的邮件, 如果这封邮件每次都无法发送, 直到这封邮件被反弹, 整个重试时间表如下. 本地传送邮件使用一个相似的不过频率更高的时间表.

重试次数	秒	天-小时-分钟-秒
1	0	0-00:00:00
2	400	0-00:06:40
3	1600	0-00:26:40
4	3600	0-01:00:00
5	6400	0-01:46:40
6	10000	0-02:46:40
7	14400	0-04:00:00
8	19600	0-05:26:40
9	25600	0-07:06:40
10	32400	0-09:00:00
11	40000	0-11:06:40
12	48400	0-13:26:40
13	57600	0-16:00:00
14	67600	0-18:46:40
15	78400	0-21:46:40
16	90000	1-01:00:00
17	102400	1-04:26:40
18	115600	1-08:06:40
19	129600	1-12:00:00
20	144400	1-16:06:40
21	160000	1-20:26:40
22	176400	2-01:00:00
23	193600	2-05:46:40
24	211600	2-10:46:40
25	230400	2-16:00:00
26	250000	2-21:26:40
27	270400	3-03:06:40
28	291600	3-09:00:00
29	313600	3-15:06:40
30	336400	3-21:26:40
31	360000	4-04:00:00
32	384400	4-10:46:40
33	409600	4-17:46:40
34	435600	5-01:00:00
35	462400	5-08:26:40
36	490000	5-16:06:40
37	518400	6-00:00:00
38	547600	6-08:06:40
39	577600	6-16:26:40
40	608400	7-01:00:00

E.2. 为什么我无法给一个有很多MX记录的大站点发送邮件?

如果你得到下面的错误提示:

deferral: CNAME_lookup_failed_temporarily._(#4.4.3)/

出问题的原因是qmail不能处理名字服务器返回的大尺寸查询返回. 安装 djbdns 来解决这个问题. 参考高级话题下面的补丁小节.

不过也有一些人使用这样的系统但是却没有遇到这样的问题. 本质上说, 这取决于对你本地名字服务器查询的定时和排序, 名字服务器对于"aol.com"的ANY查询返回的可能是大于512 字节的 UDP 数据包, 或者可能不是.

"可能不是" 这种情况可能是碰巧查询的A记录和MX记录超时, 而NS记录没有超时. 由于 .COM的服务器设置的TTL记录生命期为2天, 而AOL的TTL只有1个小时, 这种超时现象会经常在较少的某些比较忙的名字服务器上发生. 比较忙碌的名字服务器更大的可能在所有开放时间把这些记录放在他们的高速缓存中. 查询超时而又没有打补丁的qmail将会试着去查询CNAME记录.

一个更好的测试方式是发送邮件到nosuchuser@large-mx.ckdhr.com这里; 如果邮件被清除出了你的邮件队列, 并且从ckdhr.com反弹信息给你, 就表明你的MTA可以发送邮件给拥有超过512字节MX列表记录的主机. (如果使用单一查询项目, 在一个TTL生命期中, 尽管查询结果超过了512字节, 可是由于单一查询不依赖于定时和排序, 这个问题将不会被表现出来)

E.3. QUEUE_EXTRA 是什么?

QUEUE_EXTRA是一个编译时的配置参数, 用它来确定每个邮件传送的一个附加的接收者. 这个参数首先用于日志记录. 例如, FAQ里面描述的如何使用QUEUE_EXTRA来保存所有的进出邮件.

要使用QUEUE_EXTRA, 编辑 extra.h 使用"Trecipient\0"这个格式确定附加的接收者, QUEUE_EXTRA的长度由QUEUE_EXTRALEN确定("\0"算成一个字符). 举一个例子:

    #define QUEUE_EXTRA "Tlog\0"
    #define QUEUE_EXTRALEN 5

关掉正在运行的qmail. 如果你按照本文安装顺序, 运行下面的命令:

    qmailctl stop

如果你没有qmailctl脚本, 你可以使用你的启动/关闭脚本, 或者给qmail-send发送一个TERM信号.

然后重编译qmail, 使用命令:

    make setup check

设置 ~alias/.qmail-log 来定义你想要记录的内容. 比如, 需要记录邮件 ID(Message-ID), 那么就这样编写这个文件内容:

    | awk '/^$/ { exit } /^[mM][eE][sS][sS][aA][gG][eE]-/ { print }'

最后, 重新启动qmail.

附录 F. 错误讯息

qmail的错误讯息以及他们的含义.

参见 RFC 1893 标准文档内括号内每个错误信息的说明部分.

这个附录是不完整的.

附录 G. 新手常见问题(Gotchas)

这个"gotchas" 是qmail 新手经常遇到的问题.

G.1. qmail 不能给超级用户发邮件.

为了防止qmail-local以特权用户运行命令的可能性, qmail忽略所有UID是0的用户. 这个文档请看 qmail-getpw 的 man 手册页.

不过这并不意味着qmail不能给root用户传送邮件, 只是邮件传送必须由一个非特权用户来执行. 典型情况, 为root用户创建一个系统别名文件 ~alias/.qmail-root.

G.2. qmail不能给没有主目录的用户发邮件.

这是另外一个安全特色, 也是一个新手的很好的练习机会. 看看 qmail-getpw的man 手册页面找答案吧.

G.3. qmail 不能给名字里面含有大写字符的用户投递邮件.

qmail 将整个"本地部分" -- 邮件地址中"@" 符号左面的所有部分转换为小写. man 手册页面里面没有提到和表示, 不过代码里面有相关表示. 实际上在qmail-getpw 的 man 手册页面里面有关于qmail忽略使用大写字符名字用户的文档.

G.4. qmail处理扩展地址的时候, 用冒号(:)替换掉了点(.).

这是qmail另一个安全特色. 是为了防止扩展地址里面".."和文件树冲突, 点(.)置换为冒号(:)之后, qmail就可以确定使用的每个用户的所有 .qmail 文件都位于他们的主目录下面. 这个问题存档于 dot-qmail 的 man 手册页里面.

G.5. qmail 处理扩展地址的时候把大写字符转换成了小写字符.

qmail转换本地地址的整个部分为小写字符. 文档参见 dot-qmail 的 man 手册页.

G.6. qmail 不使用 /etc/hosts 文件

qmail 从不使用 /etc/hosts 来确定一个主机名关联的IP地址. 如果你在控制文件内使用主机名而不是IP地址, qmail必须能够访问名字服务器.

即使在没有名字服务器的情况下, 也可以运行qmail, 在control 文件内的主机由 IP 地址确定, IP地址两边必须加上方括号([ ]). 例如:

    [10.1.2.219]

实际上, 方括号不总是必要的--不过用上它们无论如何是恰当的.

G.7. qmail 不在日志记录 SMTP 的活动.

由于很多原因, qmail 对于 SMTP 的连接, 拒信, 非法命令或者有效命令都不记录, tcpserver可以用来记录连接, recordio 可以用来记录整个 SMTP 对话. recordio 是 ucspi-tcp 的一部分. 这个过程存档在FAQ里面. 可以在这个地址 http://cr.yp.to/qmail/faq/servers.html#recordio 访问到它.

G.8. qmail 不生成邮件延迟通知.

如果在几个小时内 Sendmail 无法传递邮件, 代表性的是4个小时, 它就会发送一个邮件延迟通知给邮件原始发送者. 这个通知有点像反弹邮件, 不过还不表示邮件传送永久失败了.

qmail 并不发送这样的警告. 未发送邮件在队列内等待发送直到超过 queuelifetime 规定的时间后还未能发送, 才会被反弹给邮件原始发送者.

G.9. qmail 由于/var/qmail/queue/lock/trigger 文件丢失、权限设置错误或者错误的文件属性设置等原因变的很慢

qmail-queue 和 qmail-send 使用一个称作 /var/qmail/queue/lock/trigger 的命名管道进行通讯. 如果这个管道陷入混乱, qmail-send 将在大约半个小时内无法注意到新邮件.

最好的方式是正确设置qmail, 在源代码目录下使用"make check"命令检查. 如果不能这样作, 那么像下面这样确定一下:

# ls -l /var/qmail/queue/lock/trigger
prw--w--w-   1 qmails   qmail           0 Jul  5 21:25 /var/qmail/queue/lock/trigger

特别注意那一行开头的"p"(表明这是一个命名管道), 状态(特别是任意用户可写标志位), 以及用户和用户组的归属.

G.10. DNS 或者 IDENT 查询使 SMTP 变慢

如果 qmail-smtpd 对连接的反应变慢, 原因可能使由于DNS反相查询或者 IDENT 查询. 如果你使用 tcpserver 运行 qmail-smtpd, 删除 "-h", "-p", 和 "-r" 选项, 并增加 "-H", "-P", "-R", 和 "-l hostname" 选项.

参看 http://cr.yp.to/ucspi-tcp/tcpserver.html 这里的 tcpserver 的文档查看这些选项的说明.

G.11. 回车(Carriage Return)和换行(CRLF)不同

qmail-inject 和其他本地注入机制比如 sendmail 不能正确接受DOS风格的回车/换行符. 不像 Sendmail, qmail 要求本地注入邮件使用 Unix 换行(只有 LF). 这和PHP 脚本遇到的问题一样.

G.12. 日志回滚造成qmail-send 和 tcpserver 停止

如果你使用第二节描述的受到监控的日志服务, 日志服务将会因为以下任何原因停止: 磁盘满, run 脚本打字错误, 日志目录配置错误, 等等. 而管道将被填满, 导致服务被阻塞, 或者被挂起. 解决这个问题(参看故障处理)之后, 所有部分都会恢复正常.

G.13. qmail-smtpd 不能使地址的本地部分生效

假如 example.com 被列入control/rcpthosts 文件, 发给 anything@example.com 的邮件在SMTP会话期间将会被接受. 如果 anything 不是一个合法用户或者别名, qmail 将发送一个反弹邮件给信封上的发送者地址.

一些单纯的转信测试假设如果邮件被接受, 那么一定会被传送, 这是错的. 如果某人宣称你的系统使开放转信的, 你要查看通过转信的邮件的副本--包括完整的邮件头, 特别是 Received 部分--比较一下这些部分和你的日志记录.

要在qmail 中增加接收者认证, 请参考这小节: 在SMTP对话过程中拒绝无效接收者.

G.14. 设置防火墙导致远程无法连接 SMTP/POP3/IMAP 服务器

如果安装了 SMTP, POP3 和 IMAP 服务器, 你可以在本机或者本地网络的主机连接到这些服务器, 但是无法从远程服务器连接, 很有可能是防火墙的问题.

第一个查看的地方是服务器本身. 举例, Red Hat Linux, 使用 iptables 在默认配置下是阻塞 SMTP 服务的. 其他包过滤机制比如 ipchains 也会和这个问题有关系.

也有可能是你的因特网服务提供商 (ISP) 阻塞了某些端口来防止垃圾邮件骚扰或者强制执行他们的服务条款(Terms of Service, TOS). 确认不是包过滤的原因以及你没有违反ISP的服务条款(TOS)之后, 可以联系你的ISP的技术支持解决问题.

G.15. 如果USER 和 LOGNAME 没有设置的话, qmail-inject 将设置邮件发送方字段(From)为匿名(anonymous)

如果通过 qmail-inject 发送邮件, 并且邮件不包括 From 字段, qmail-inject 将查找环境变量来得知是那个用户发送的邮件. 查找变量的顺序为: QMAILUSER, MAILUSER, USER, 然后 LOGNAME.

普通用户登录期间通常要设置USER和LOGNAME变量, 不过某些批处理任务, 比如以 cron 执行的任务, 将不会设置这两个环境变量.

为了使你的 cron 任务发送的邮件有一个合法的 From 字段, 请在发信之前设置一个环境变量就可以了.

G.16. 停止qmail-send进程的时候, 它不总是立即退出.

在还有邮件传送的情况下, 向qmail-send发送 KILL 信号是不能使qmail-send立刻退出的. qmail-send退出前将等待所有的qmail-local和qmail-remote进程完成任务, 这样qmail-send才能记录下传送结果. 由于这个原因, "qmailctl restart" 或者 "qmailctl stop" 这样的命令可能在qmail-send依然在运行的情况下, 报告qmail-send进程已经被停止了. 所以, 请使用"qmailctl stat"来检查"stop"和"restart"命令的实际执行结果.

还要注意, qmail-send 退出前将遍历邮件队列, 所以当存在非常大的邮件队列情况下停止qmail-send 会有一个非常明显的时间延迟.

G.17. 不能通过把邮件传送到/dev/null 将邮件丢弃.

假设这样写一个传送指令:

/dev/null

因为qmail 认为/dev/null 是一个mbox 格式的邮箱, 而/dev/null 是个特殊文件, 所以这样作将导致qmail 无法传送邮件.

最好的丢弃邮件的方式是建立一个.qmail 文件, 这个文件内可以包含无效的指令, 但一定要非空(.qmail 的空文件将被作为按照defaultdelivery 内缺省指令或者qmail-start 命令行指令进行传送) , 在这个文件里面只放上注释语句就可以作到了.

举例如下, 一个仅包含注释的.qmail 文件:

或者:

# throw messages away undelivered

(注释语句可以随便些上点什么. 译者注)
这样的.qmail 文件可以丢弃邮件, 而不予传送.

G.18. qmail-send 正在运行过程中修改邮件队列是危险的

在qmail-send 运行过程中, 如果你不是非常确切的知道你正在作什么, 修改/var/qmail/queue 下面的文件或目录是非常危险的, 可能会导致邮件队列崩溃, 举例来说, 邮件将处于未定义的状态, 日志文件中出现奇异错误信息, 重复传送邮件, 出现假的反弹邮件等等错误都可能发生. 一旦发生这些情况, 你必须找到并运行一个队列检查程序(有两个可以在 qmail.org 找到)或者创建一个新的空邮件队列.

如果你要修改邮件队列, 首先停止qmail, 仔细处理队列, 然后重启qmail. 注意, qmail-send 停止也会造成这样的队列崩溃, 所以你应该知道如果你遇到这样的情况应该怎么作.

附录 H. 关于本文 Life with qmail 的常见话题

另外一个支持LWQ 的方式是去我的书店买东西, 这是Amazon.com 的联盟书店, 使用这个地址访问: http://www.amazon.com/exec/obidos/redirect-home/davesill.

感谢你的衷心支持! Thanks for your support!

H.10. 这个版本的LWQ有那些变化呢?

修正了许多的小错误, 无效链接等等.
增加了 /dev/null/ 部分. 感谢Payal Rathod.
扩展了nosuid 注意事项部分. 感谢Tony Hansmann.
增加了到Cazabon 的nodefaultrbl 的补丁的链接. 感谢Jeremy Kister.
在qmail-pop3d 指令中添加了mkdirs. 感谢Larry Weldon.
增加了checkpasswd 的关于errno 补丁的注意事项. 感谢tlad.
增加了smarthost relay 子章节. 感谢Silver Dirk.
改善了Qmail-Scanner 的措辞. 感谢Jason Haar.
增加了Yenigul 的书的章节. 感谢Ismail Yenigul.
增加了abuse@ 别名. 感谢Charles Cazabon.
增加了ucspi-tls 章节. 感谢Scott Gifford.
增加了修改邮件队列可能发生问题的提示.
H.10.1. 2004-06-30版本的LWQ有什么更改?
- 加入了新的qmail 的logo, 感谢Michael Kadrie.
- 修正了一些打字输入错误.
- 更新了Macintosh OS X 的注意事项.
- 更新了ClamAV 链接.
- 在高级话题内增加了接收者验证章节.
- 修改了"setuid/exe required for queue filesystem" 的措辞.
H.10.2. 2004-03-28版本的LWQ有什么更改?
- 更新了关于Levine 的书的信息.
- 修改了"What changed in the 2004-03-01 version of LWQ?"章节的输入错误.
- 在G16内增加了关于qmail-send 在退出前扫描邮件队列的注释.
H.10.3. 2004-03-01版本的LWQ有什么更改?
- G.16 内"kill"的表达被替换为更好的词"term".
- 增加了softlimit-too-low 示例错误信息.
- 修正了E.2, CNAME查询错误.
H.10.4. 2004-01-26版本的LWQ有什么更改?
- 更新了netqmail 1.05部分.
- 更新了一些小输入错误.
H.10.5. 2003-11-10版本的LWQ有什么更改?
- 更新了一些小输入错误.
H.10.6. 2003-10-30版本的LWQ有什么更改?
- 为netqmail 调整了安装部分.
- 更新了Binc IMAP 入口.
H.10.7. 2003-08-16版本的LWQ有什么更改?
- 增加了这个变更记录节. 感谢 Jerry Asher 提出的这个要求.
- 增加了关于 noexec 和 nosuid 系统需求节.
- 在测试节增加了 inst_check 脚本和例子的链接.
- 增加了Mate Wierdl 的errno 补丁的链接.
- 在系统要求节增加了OS X 的注意事项.
- IMAP 服务器节增加了Cyrus 条目. 感谢 Rick Updegrove.
- 在IMAP 服务器节增加了Dovecot 条目.
- 重新表述了地址扩展节. 感谢 Adrian Ho.
- 重新定制了 POP 的 run 脚本格式, 更容易复制和粘贴. 感谢 Woody Preston.
- 在Chunck Foster 的DNS 补丁部分修正了一处拼写错误. 感谢 Josh Parreco.
- 在QMTP 节修正了两个拼写错误. 感谢 Marek Gutkowski.

邮件服务器

Life with qmail -- 中文版

目录

3.2.4. 使用smart host中继转信

5.10.2.3. 从djbdns 运行 dnscache