如何在Windows系统上配置并运行Apache James Server 3.7.0

一、前置准备 #

• 安装Java 11（James 3.7.0 依赖Java 11，OpenJDK或Oracle JDK均可）
  • 验证版本：打开命令提示符，输入 java -version，输出需为11.x开头的版本
• 下载Apache James Server 3.7.0二进制包，选择apache-james-3.7.0-app.zip（不要下载源码包）
• 准备一个不含中文、空格的空目录作为安装路径，比如 D:\apache-james-3.7.0

二、解压安装 #

• 将下载的apache-james-3.7.0-app.zip解压到准备好的安装目录，解压后可见bin、conf、var等核心文件夹

三、基础配置 #

1. 邮件存储配置（默认文件存储，新手优先使用） #

• 打开conf\james-server.conf文件
  • 找到repository.root配置项，指定邮件存储根目录，示例：

    repository.root=file://./var/mail
    

  • 若需使用数据库存储（如MySQL），需额外修改数据源配置，新手暂用默认即可

2. 服务端口配置（规避端口冲突） #

• 在james-server.conf中找到端口相关配置：
  • SMTP默认端口为25，推荐修改为标准提交端口587：

    smtpserver.port=587
    

  • POP3默认端口110、IMAP默认端口143，若端口被占用，可修改为其他值（如1100、1430）

3. 设置邮件域名 #

• 打开conf\domainlist.xml文件
• 添加需支持的域名，示例（支持example.com）：

  <?xml version="1.0" encoding="UTF-8"?>
  <domainlist>
    <domain>example.com</domain>
    <!-- 需添加多个域名时，继续新增<domain>标签即可 -->
  </domainlist>
  

4. 创建管理员账号 #

• 打开命令提示符，进入James的bin目录：

  cd D:\apache-james-3.7.0\bin
  

• 执行命令创建管理员用户（示例：用户名admin，密码admin123，域名example.com）：

  james-cli.bat adduser admin@example.com admin123
  

• 验证用户创建结果：

  james-cli.bat listusers
  

四、服务启动与停止 #

1. 启动James服务 #

• 在bin目录下执行启动命令：

  run.bat
  

• 等待控制台输出James Server is now running，即表示服务启动成功

2. 停止James服务 #

• 方式一：在启动服务的控制台窗口按下Ctrl+C
• 方式二：新开命令提示符窗口，进入bin目录执行：

  james-cli.bat stop
  

五、功能验证 #

1. 测试SMTP发送邮件 #

• 使用邮件客户端（如Thunderbird、Outlook）配置账号：
  • SMTP服务器：localhost，端口为你设置的587（或自定义端口）
  • 账号：admin@example.com，密码：admin123
• 先创建测试用户（如test@example.com），再发送测试邮件，能正常发送即为配置有效

2. 测试POP3/IMAP接收邮件 #

• 配置邮件客户端的POP3/IMAP服务：
  • POP3服务器：localhost，端口110（或自定义端口）
  • IMAP服务器：localhost，端口143（或自定义端口）
• 使用test@example.com登录客户端，能收到之前发送的测试邮件即为正常

常见问题排查 #

• 端口被占用：修改james-server.conf中的对应端口，确保端口未被其他服务占用
• Java版本不兼容：必须使用Java 11，若系统存在多版本Java，需将JAVA_HOME环境变量指向Java 11目录
• 启动失败：查看var/logs目录下的日志文件，根据日志内容定位具体错误原因

内容的提问来源于stack exchange，提问作者cealex