0520openwebmail.htm

鸟哥的linux私房菜

	<hr><a NAME="theory_need"></a><img src="../images/penguin-s.gif" alt="小标题的图示" height="23" width="16" align="middle" /><span class="text_h2">架设前须知</span><br>
	<div class=block2>
		如同前面的说明，webmail 要能够正确的运作，其实还需要 www/mail 这两种服务的存在才行！此外，由于
		webmail 需要能够正确的存取主机内的邮件档案 (/var/spool/mail/account)，所以，我们必须要提供
		webmail 足够的权力来存取才行。因此，您必需要确定∶<br><span class="text_import2">
		<ul>
		<li>WWW Server (Apache) 已经顺利运作；
		<li>Mail Server (Postfix/sendmail) 已经顺利运作；
		<li>webmail 要求的前置软体必须已经安装∶例如 openwebmail 需要 
		    perl / suidperl / perl(CGI) / perl-Text-Iconv / perl-Compress-Zlib
		    等等的套件呢！其中 suid 方面的软体，则是提供 webmail 存取权力的套件。
		</ul></span>
		所以棉，在您架设 webmail 之前，请先确认您的主机提供的 WWW/Mail 
		服务是正确无误的！此外，前驱套件也必须要没有问题的安装才行！<br><br>

		底下我们以目前相当热门，并且是由台湾成大博士董仲恺主导发起的 Openwebmail
		这个套件来进行安装！这东西很不错喔！您可以在底下的连结当中下载与 Red Hat/Fedora
		有关的 RPM 档案∶
		<ul>
		<li><a href="http://turtle.ee.ncku.edu.tw/openwebmail/download/redhat/rpm/packages/" 
			target="_blank">http://turtle.ee.ncku.edu.tw/openwebmail/download/redhat/rpm/packages/</a></li>
		</ul>
		或者是下载原始档案 (tarball)∶
		<ul>
		<li><a href="http://turtle.ee.ncku.edu.tw/openwebmail/download/release/" 
			target="_blank">http://turtle.ee.ncku.edu.tw/openwebmail/download/release/</a></li>
		</ul>
		底下鸟哥将以 FC1 及 Mandrake 10.0 作为测试的基准来安装 openwebmai 喔！
	</div>
</div>


<hr><a NAME="install"></a><img src="images/penguin-m.gif" alt="大标题的图示" height="34" width="25" align="middle" /><span class="text_h1">OpenWebMail 的安装∶</span><br>
<div class=block1>
	因为 openwebmail 本身就有针对 Red Hat/Fedora 释出 RPM 档案，所以我们当然就直接以编译好的
	RPM 档案来安装即可！那如果是非 Red Hat/Fedora 怎么办？没关系，可以使用原始码来安装啊！<br><br>

	<hr><a name="install_fc1"></a><img src="../images/penguin-s.gif" alt="小标题的图示" height="23" width="16" align="middle" /><span class="text_h2">FC1 的 RPM 安装</span><br>
	<div class=block2>
		请先确定 Postfix 或者 sendmail 已经安装完毕，此外， Apache 也已经安装好了！如果想要快速的架设好您的
		Postfix + SASL 认证的话，可以这样做∶(更详细的资讯请查阅∶
		<a href="http://linux.vbird.org/linux_server/0390postfix.php">
		http://linux.vbird.org/linux_server/0390postfix.php</a>)<br>

<table class="term"><tr><td class="term"><pre>
<span class="term_hd"># 0. 先确定所有的套件都已经安装了，主要有:</span>
<span class="term_write">     postfix-2.0.16-1
     cyrus-sasl-2.1.15-6
     cyrus-sasl-md5-2.1.15-6
     cyrus-sasl-devel-2.1.15-6
     cyrus-sasl-plain-2.1.15-6
     <span class="term_say">如果还有忘记写上去的，还请继续的安装啊！并且，请移除底下的套件</span>
     sendmail
     fetchmail
     mutt</span>

<span class="term_hd"># 1. 先确定一下 /usr/lib/sasl2/smtpd.conf 存在，且内容为∶</span>
<span class="term_write">     pwcheck_method: saslauthd</span>

<span class="term_hd"># 2. 确定一下 /etc/sysconfig/saslauthd 内容为∶</span>
<span class="term_write">     MECH=shadow</span>

<span class="term_hd"># 3. 确定一下 main.cf 里面有∶</span>
<span class="term_write">smtpd_sasl_auth_enable = yes
smtpd_sasl_local_domain=
smtpd_recipient_restrictions =
  reject_unknown_sender_domain
  reject_unknown_recipient_domain
  permit_mynetworks
  permit_sasl_authenticated
  reject_unauth_destination
smtpd_client_restrictions =
  permit_mynetworks
  hash:/etc/postfix/access
  permit_sasl_authenticated
  reject_rbl_client relays.ordb.org
  reject_rhsbl_client dsn.rfc-ignorant.org
smtpd_sasl_security_options = noanonymous</span>

<span class="term_hd"># 4. 然后启动 saslauth 及 postfix 应该就可以啦！</span>
</pre></td></tr></table>

		然后，请先下载 FC1 所需要的前驱套件，请连结至∶
		<a href="http://turtle.ee.ncku.edu.tw/openwebmail/download/redhat/rpm/packages/fc1/" 
		target="_blank">http://turtle.ee.ncku.edu.tw/openwebmail/download/redhat/rpm/packages/fc1/</a>
		下载所有的 RPM 套件，然后再安装 openwebmail 2.40 版，整个安装流程∶

<table class="term"><tr><td class="term"><pre>
<span class="term_hd">1. 安装 openwebmail ∶</span>
[root@test root]# <span class="term_command">rpm -ivh perl*</span><span class="term_note"> # 假设所有的RPM都放在 /root 底下。</span>
[root@test root]# <span class="term_command">yum update</span>
<span class="term_say"># 这个动作仅只是要升级刚刚的套件而已；</span>

[root@test root]# <span class="term_command">rpm -ivh openwebmail-2.40-1.i386.rpm</span>
<span class="term_say"># 注意∶在预设的情况下， openwebmail 会将档案资料安装至与 apache 有关的路径
# 也就是 /var/www/data 与 /var/www/cgi-bin 底下，所以，如果您已经将 apache
# 以 tarball 方式安装，导致拥有不同的 WWW Root 路径时，最好使用 tarball
# 来安装您的 openwebmail 啊！</span>

<span class="term_hd">2. 初始化设定∶</span>
[root@test root]# <span class="term_command">cd /var/www/cgi-bin/openwebmail</span>
[root@test openwebmail]# <span class="term_command">./openwebmail-tool.pl --init</span>
<span class="term_say"># 因为 openwebmail 支援相当多种认证机制，因此，我们必须在使用 openwebmail 
# 之前，先将 openwebmail 的相关设定做好！上面 openwebmail-tool.pl --init
# 就是在达成这样的目标。此外，这个步骤会进行蛮长的一段时间喔！请耐心等候！</span>

[root@test openwebmail]# <span class="term_command">cd etc</span>
[root@test etc]# <span class="term_command">vi dbm.conf</span>
<span class="term_say"># 找到并修改成底下几行∶</span>
<span class="term_write">dbm_ext                 .db
dbmopen_ext             .db
dbmopen_haslock         yes</span>
[root@test etc]# <span class="term_command">cd ..</span>
[root@test openwebmail]# <span class="term_command">./openwebmail-tool.pl --init</span>
Welcome to the Open WebMail!

This program is going to send a short message back to the developer,
so we could have the idea that who is installing and how many sites are
using this software, the content to be sent is:

OS: Linux 2.4.22-1.2199.nptl i686
Perl: 5.008003
WebMail: Open WebMail 2.40 20040816

Send the site report?(Y/n)
sending report...

Thank you.


<span class="term_hd">3. 进一步设定∶</span>
[root@test openwebmail]# <span class="term_command">cd etc</span>
[root#test etc]# <span class="term_command">vi openwebmail.conf</span>
<span class="term_say"># 找到这一行∶</span>
<span class="term_write">default_language                en</span>
<span class="term_say"># 改成这样子∶</span>
<span class="term_write">default_language                zh_TW.Big5</span>
</pre></td></tr></table>

		一般来说，设定成这样就足够您运作 openwebmail 了，不过，您的 WWW 主机必须要能提供
		perl 的执行环境，因为 openwebmail 就是以 perl 写成的啊！以 apache 为例，您必须要知道如何启动
		perl 的 CGI 执行环境∶

<table class="term"><tr><td class="term"><pre>
[root@test root]# <span class="term_command">vi /etc/httpd/conf/httpd.conf</span>
ScriptAlias /cgi-bin/ "/var/www/cgi-bin/"
&lt;Directory "/var/www/cgi-bin">
    AllowOverride None
    Options None
    Order allow,deny
    Allow from all
&lt;/Directory>
AddHandler cgi-script .cgi .pl
</pre></td></tr></table>

		至少上面的设定要设定妥当才行啊！好了，那么如何使用 openwebmail 呢？直接在您的浏览器上面输入∶
		<ul><span class="text_import2">http://your.linux.server/cgi-bin/openwebmail/openwebmail.pl</span></ul>
		就可以使用 openwebmail 棉！很简单吧！不过，如果万一您的认证一直无法成功的话，可以指定一下认证机制看看∶

<table class="term"><tr><td class="term"><pre>
[root@test root]# <span class="term_command">cd /var/www/cgi-bin/openwebmail/auth</span>
[root@test auth]# <span class="term_command">vi auth_unix.pl</span>
<span class="term_say"># 找到底下∶</span>
my $passwdfile_plaintext = $conf{'passwdfile_plaintext'} || '/etc/passwd';
my $passwdfile_encrypted = $conf{'passwdfile_encrypted'} || '/etc/master.passwd';
<span class="term_say"># 改成这样∶</span>
<span class="term_write">my $unix_passwdfile_plaintext="/etc/passwd";
my $unix_passwdfile_encrypted="/etc/shadow";</span>

<span class="term_say"># 或者是修改底下这个档案成为∶</span>
[root@test root]# <span class="term_command">vi \
/var/www/cgi-bin/openwebmail/etc/defaults/auth_unix.conf</span>
<span class="term_say"># 其内容只需将</span>
passwdfile_encrypted /etc/master.passwd
<span class="term_say"># 改为</span>
<span class="term_write">passwdfile_encrypted /etc/shadow</span>
<span class="term_say"># 这样就算完成了。 </span>
</pre></td></tr></table>

	</div>


	<hr><a name="install_mdk10"></a><img src="../images/penguin-s.gif" alt="小标题的图示" height="23" width="16" align="middle" /><span class="text_h2">MDK10.0 的 Tarball 安装</span><br>
	<div class=block2>
		如果您是使用 MDK 作为您的 Linux 系统时，由于 OpenWebMail 并没有针对这个作业系统来设计
		RPM 档案，所以，这里我们以 Tarball 来进行安装。首先，请先确认一下您的 Postfix
		与 Apache 已经安装妥当。底下我们就完整的来谈一谈棉！(同样的，更详细的 Postfix
		+ SASL 的 SMTP 身分认证资讯请查阅∶
		<a href="http://linux.vbird.org/linux_server/0390postfix.php">http://linux.vbird.org/linux_server/0390postfix.php
		</a>)

<table class="term"><tr><td class="term"><pre>
<span class="term_hd"># 0. 先确定一下底下这些套件都已经安装了(使用 rpm 的方式来安装的)</span>
[root@test root]# <span class="term_command">rpm -qa | egrep '(sasl|postfix|imap)'|sort</span>
cyrus-sasl-2.1.15-10mdk
imap-2002d-8mdk
libpostfix1-2.1.1-0.1.100mdk
libsasl2-2.1.15-10mdk
libsasl2-devel-2.1.15-10mdk
libsasl2-plug-anonymous-2.1.15-10mdk
libsasl2-plug-login-2.1.15-10mdk
libsasl2-plug-plain-2.1.15-10mdk
postfix-2.1.1-0.1.100mdk
<span class="term_say"># 若没有安装任何一个套件，请使用 urpmi 来安装喔！</span>
  
<span class="term_hd"># 1. 建立 saslauthd 认证机制与 smtp 认证档案∶</span>
[root@test root]# <span class="term_command">vi /etc/sysconfig/saslauthd</span>
<span class="term_write">#SASL_AUTHMECH=pam
SASL_AUTHMECH=shadow</span>
<span class="term_say"># 事实上，就是将认证机制修订成为 shadow 就是了。</span>