apache james 使用手册

一、简介

Apache James（Java Apache Mail Enterprise Server）是Apache组织的子项目之一，完全采用纯Java技术开发，实现了SMTP、POP3与NNTP等多种邮件相关协议。

James也是一个邮件应用平台，可以通过Mailet扩充其功能，如Mail2SMS、Mail2Fax等。James提供了比较完善的配置方案，尤其是关于邮件内容存储和用户信息存储部分，可以选择在文件、数据库或其他介质中保存。

James性能稳定、可配置性强，还是开源项目，所有源代码不存在版权问题，因此，James在项目中的应用日益广泛，现在常用版本为2.1，但最新版本2.3已经推出，在本文中，我们将仍以James2.1作为介绍蓝本。
二、安装与配置

James的安装配置过程非常简单。

第一步：安装JDK

请使用JDK1.3以上版本（推荐使用JDK1.4），假设安装在c:\jdk1.3。

第二步：下载James，并解压

可以到Apache网站上下载James2.1，下载将得到一个压缩文件james-2.1.zip，大小为4.45M，将此包解压到c:\james。

第三步：直接运行或需要配置JAVA_HOME

这时，可以尝试直接双击c:\james\bin\run.bat，若启动无误，将提示如下：Using PHOENIX_HOME:   C:\james

------------------------------------------------------

Using PHOENIX_TMPDIR: C:\james\temp
Using JAVA_HOME:
Phoenix 4.0.1

James 2.1
Remote Manager Service started plain:4555
POP3 Service started plain:110
SMTP Service started plain:25
NNTP Service Disabled
Fetch POP Disabled

-------------------------------------------------------

也有可能启动不了，并报JAVA_HOME找不到，这时，需要指定JAVA_HOME，比较简单的方法是在c:\james\bin\run.bat中指定JAVA_HOME，修改后的run.bat如下：……

------------------------------------------------------

rem
rem Determine if JAVA_HOME is set and if so then use it
rem
set JAVA_HOME= c:\jdk1.3
if not "%JAVA_HOME%"=="" goto found_java
……

------------------------------------------------------

      修改完后再运行run.bat，应该就可以正常启动了，若还有什么问题，请参见本文的FAQ部分。
三、项目应用

1、 项目需求

某单位，有16个职能处室，共78台电脑（操作系统为Win98/2000/xp），其中有1台为专用服务器（Win2000），已连成局域网。为使单位内部的信息交流，尤其是文件交互更加便捷，单位决定在局域网内部架设一套E-mail系统。

2、 解决方案

在专用服务器上安装James2.1，客户端使用操作系统自带的Outlook Express。

3、 服务器端配置

首先找出专用服务器的名字，假设叫unitname。

然后打开文件c:\james\apps\james\SAR-INF\config.xml。

在config.xml文件中，找到<postmaster>Postmaster@localhost</postmaster>，把此项改为<postmaster>Postmaster@unitname</postmaster>，同理，找到<servername>localhost</servername>，把此项改为<servername>unitname</servername>。其实，改这两项就是把默认的localhost改为机器名，这样做是为了让其它机器也能访问邮件系统，当然，前提是在局域网上没有与服务器重名的机器。

4、 客户端配置

假设有一个账号，用户名为holen，密码为123456，如何在Outlook中配置呢？

首先，根据用户名，可以得出该用户邮箱地址为holen@unitname ，然后在输入POP3和SMTP服务器时，直接使用服务器机器名unitname即可。

5、 帐号管理

James的账号管理是通过telnet完成的，登录命令为：

------------------------------------------------------

telnet unitname 4555

------------------------------------------------------

其中unitname也可以换成IP，4555是端口号。登录时需要用户名和密码，初始的用户名和密码均为root。若登录成功，提示如下：

------------------------------------------------------

JAMES Remote Administration Tool 2.1
Please enter your login and password
Login id:
Password:
Welcome root. HELP for a list of commands

------------------------------------------------------

需要注意的是，所有敲入的命令都不显示在屏幕上。

输入help，将出现命令的帮助，信息如下：

------------------------------------------------------

JAMES Remote Administration Tool 2.1
Please enter your login and password
Login id:
Password:
Welcome root. HELP for a list of commands
Currently implemented commands:
help                                    display this help
listusers                               display existing accounts
countusers                              display the number of existing accounts
adduser [username] [password]           add a new user
verify [username]                       verify if specified user exist
deluser [username]                      delete existing user
setpassword [username] [password]       sets a user's password
setalias [alias] [user]                 locally forwards all email for 'alias' t
o 'user'
unsetalias [alias]                      unsets an alias
setforwarding [username] [emailaddress] forwards a user's email to another email
address
unsetforwarding [username]              removes a forward
user [repositoryname]                   change to another user repository
shutdown                                kills the current JVM (convenient when J
ames is run as a daemon)
quit                                    close connection

------------------------------------------------------

常用的命令有listusers、countusers、adduser、deluser、setpassword等。

其中添加用户为adduser，例如：adduser holen 123456。

通过这个后台管理界面，管理员就可以实现账号管理及其他相应的管理功能。

6、 应用情况

这套系统在该单位经过一周的试运行后，已正式运行两个月，用户数约百人，一直很稳定，期间，因操作系统故障，服务器重启两次，其他时间，一直处于运行状态，性能稳定，响应速度快。
四、FAQ

1、 在启动james时，提示POP3或SMTP不能使用？

请检查一下，看“管理工具—>服务”里面，是不是启动了别的邮件服务器，已将110或25端口占用了。

2、 JAVA_HOME找不到？

请在run.bat中指定JAVA_HOME，若还不行，请在“我的电脑—>系统—>高级—>环境变量”中添加一项JAVA_HOME（一般不推荐这么做）。

3、 服务器启动正常，但客户端不能收发邮件？

请检查客户端配置是否正常，参照前面所讲，另外，请检查james下的config.xml，是否把localhost改成了机器名。
五、总结

总体而言，James是一款十分优秀的邮件服务器，具有性能稳定、扩展性好、可配置性强、响应速度快、源码公开等优点。同时，由于James的后台管理不够方便、缺少必要的技术支持等原因，限制了james的高端企业级应用。

就目前情况而言，James主要用于1000用户量以内的邮件系统，而且当James用于商业性项目时，开发商一般需要对James进行相应的包装，主要是后台管理这一块。