OMS_Tutorial_SquirrelMail_zh

 

OMS_Tutorial_SquirrelMail_zh  

[OMS Tutorial] Install and configure SquirrelMail.

$Revision$,$Author$

• ().
• Author: Zhang Huangbin (michaelbibby gmail.com).

• 的 下载最新版本（本文档使用的是 1.4.13 版本）。
• 解压到服务器的 /var/www/ 目录：

  # export VERSION='1.4.13'
  # bzip2 -d squirrelmail-${VERSION}.tar.bz2     
  # tar xf squirrelmail-${VERSION}.tar -C /var/www/
  # cd /var/www/htdocs/
  # ln -s ../squirrelmail-${VERSION} mail

• 设置权限：

  # chown -R www:www /var/www/squirrelmail-${VERSION}/
  # chmod -R 755 /var/www/squirrelmail-${VERSION}/

• 创建目录，用于存放邮件附件等数据：

  # cd /var/www/squirrelmail-${VERSION}/
  # mkdir data attach
  # chown www:www data attach
  # chmod 730 attach

。

下载需要的 translation。这里使用 all_locales-1.4.13-20071220.tar.gz，包含最多种语言的翻译，你也可以只下载单个语言的翻译包。

下载后将它解压，然后将解压出来的目录和文件复制到对应的目录即可：

# tar zxf all_locales-1.4.13-20071220.tar.gz

解压后在当前目录有一个 'install' 脚本，它会复制所有需要的文件：

# sh install
Please enter path to your squirrelmail installation:

在提示符下输入 SquirrelMail 的安装地址：

/var/www/htdocs/mail/

到此，translations 的安装就完成了。再通过 SquirrelMail 的配置工具 'conf.pl' 来设置默认语言和默认的字符集：

# /var/www/htdocs/mail/config/conf.pl

选择 'Languages' 一项，再设置以下两个参数：

• Default Language（简体中文使用 'zh_CN'，繁体中文用 'zh_TW'）
• Default Charset（简体中文用 'gb2312'，繁体中文用 'big5'）

TIP: Default Charset

SquirrelMail 里的 'zh_CN' 默认使用 'gb2312' 字符集，而 phpLDAPadmin 里所有属性的值都是用 'utf-8' 编码保存的，所以如果需要使用 LDAP 全局地址簿，则需要将 SquirrelMail 的 translation 文件的编码给转换成 'utf-8' 编码，否则看到的 LDAP 属性的值都将是乱码。

这里以 'zh_CN' 为例，介绍如何使用 'iconv' 工具来转换字符集。

# cd /var/www/htdocs/mail/locale/zh_CN/LC_MESSAGES/
# cp squirrelmail.po squirrelmail.po.bak
# iconv -f gb2312 -t utf-8 squirrelmail.po.bak >squirrelmail.po

再编辑 /var/www/htdocs/mail/locale/zh_CN/setup.php 文件，将文件里的 'gb2312' 改为 'utf-8'：

$languages['zh_CN']['CHARSET'] = 'utf-8';
$languages['zh_CN']['LOCALE']  = array('zh_CN.UTF8','zh_CN');

再编辑 /var/www/htdocs/mail/functions/i18n.php 文件，将文件里的 'gb2312' 改为 'utf-8'：

$languages['zh_CN']['CHARSET'] = 'utf-8';

这样就可以了。

别忘了用 'conf.pl' 配置工具在 'Languages' 菜单里将一下参数改一下：

• Default Charset （改为 'utf-8'）

，可以在 页面找到所有的 Plugins。

• 插件的主页下载最新版本，这里以 2.2-1.4.0 版本为例。
• 解压缩，并复制到正确的位置：

  # tar zxf change_ldappass-2.2-1.4.0.tar.gz
  # cp -rf change_ldappass /var/www/htdocs/mail/plugins/
  
  # chown -R www:www /var/www/htdocs/mail/plugins/change_ldappass
  # chmod -R 755 /var/www/htdocs/mail/plugins/change_ldappass

• 启用插件：

  # /var/www/htdocs/mail/config/conf.pl

输入 'Plugins' 菜单项前的数字，然后可以看到所有已经安装的插件。输入 'change_ldappass' 前的数字启用它。再输入 'S' 保存配置，输入 'Q' 退出配置工具。

• 配置 change_ldappass：

将配置文件模板复制一份，再基于它进行修改：

# cd /var/www/htdocs/mail/plugins/change_ldappass/
# cp config_sample.php config.php

在 config.php 文件中需要修改以下内容：

$ldap_server = '127.0.0.1';
$ldap_protocol_version = 3;
$ldap_password_field = 'userPassword';
$ldap_user_field = 'mail';
$ldap_base_dn = 'o=domains,dc=openbsdonly,dc=org';
$ldap_filter = '(&(objectClass=qmailUser)(accountStatus=active))';
$query_dn = 'cn=vmail,dc=openbsdonly,dc=org';
$query_pw = 'vmailpasswd';

修改完成之后，用户就可以登录到 SquirrelMail 里，通过菜单 'Options --> Change Password' 来修改自己的邮箱密码了。

插件用于检查和显示用户的邮箱容量使用量。支持的 Quota 类型有：

• UNIX (filesystem)
• IMAP-based
• cPanel quotas

在这里我们使用的是 IMAP-based，配置非常的简单。

下载最新版本的源码，然后解压并配置。这里以 2.2-1.4.0 版本为例。

# tar zxf check_quota-2.2-1.4.0.tar.gz
# mv check_quota /var/www/htdocs/mail/plugins/

# chown -R www:www /var/www/htdocs/mail/plugins/check_quota/
# chmod -R 755 /var/www/htdocs/mail/plugins/check_quota/

# cd /var/www/htdocs/mail/plugins/check_quota/
# cp config.sample.php config.php

编辑配置文件 /var/www/htdocs/mail/plugins/check_quota/config.php，在第 28 行，将 quota_type 的值改为 '1' 即可。

$settings['quota_type'] = 1;

使用 SquirrelMail 的 'conf.pl' 工具启用这个插件，然后重新登录 SquirrelMail，即可在左上角看到 "Quota Usage" 的信息。

TIP:

如果用户邮箱为空，默认是不显示 "Quota Usage" 的。

在用户的登录的时候提供一个下拉菜单，用户可以在此选择登录 SquirrelMail 后使用的界面语言。

select_language 的安装非常简单，只需要解压后复制到正确的目录，再启用它即可。这里以 1.1-1.4.0 版本为例。

# tar zxf select_language-1.1-1.4.0.tar.gz
# mv select_language /var/www/htdocs/mail/plugins/

# chown -R www:www /var/www/htdocs/mail/plugins/select_language/
# chmod -R 755 /var/www/htdocs/mail/plugins/select_language/

使用 SquirrelMail 的配置工具 'conf.pl' 启用它。