ApacheJames3.0 配置安装

「爱情、让人受尽委屈。」 2021-09-28 23:40 1048阅读 0赞

转自：[https://blog.csdn.net/hjnth/article/details/82931569][https_blog.csdn.net_hjnth_article_details_82931569]

*  James-3.1.0 较于 2.3 功能更加完善，详情参见官网：
 *  [https://github.com/apache/james-project/\#apache-james-project][https_github.com_apache_james-project_apache-james-project]
 *  拥抱 Docker，可以将数据卷挂载到 Host 上，还可集成 ElasticSearch 或 Lucene (基于 Guice)：
 *  [https://github.com/apache/james-project/\#how-to-run-james-in-docker][https_github.com_apache_james-project_how-to-run-james-in-docker]

# What？ #

参见官方文档，此处不赘述：[https://github.com/apache/James-project][https_github.com_apache_James-project]

# How？ #

> 接下来将和大家一起逐步搭建一套私人 James 邮件服务 ^\_^

Pre：  
安装完： JDK，vim，wget、unzip

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

### 一、基础配置部署： ###

#1、下载并解压： 
       wget https://www.apache.org/dyn/closer.lua/james/server/james-server-app-3.1.0-app.zip 
       unzip james-server-app-3.1.0-app.zip 
       
       #2、添加邮箱后缀[注意：如果是在本地模拟则需在hosts中做域名映射，否则会出现意想不到的问题] 
       vim ../conf/domainlist.xml 
       2.1 autodetect、autodetectIP 值为false，不自动获取domain与IP，而使用下面设置的指定邮箱后缀 
       2.2 defaultDomain 值为你的邮箱后缀。如需处理多个邮箱后缀的邮件，则需加一个 <domainnames>节点，并将其他邮箱后缀添加到子节点domainname中即可： 
       <defaultDomain>develop.com </defaultDomain> 
       <domainnames> 
       <domainname>develop1.com </domainname> 
       <domainname>develop2.com </domainname> 
       </domainnames> 
       
       #3、进入bin目录并启动服务 
       cd james-server-app-3.1.0/bin/ 
       sh run.sh 
       
       #4、项目启动一会后，出现下面内容即为启动成功： 
       INFO xx:xx:xx,xxx | org.apache.james.app.spring.JamesAppSpringMain | Apache James Server is successfully started in xxxxxx milliseconds.

> \[可能遇到的报错\]：

nested exception is [java.net.UnknownHostException][]: xxx:xxx：将 xxx 添加映射到 /etc/hosts 后重启即可.

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

## ##

### 二、使用 mysql 存储数据： ###

> James 默认使用 JPA 以文件存储相关数据，本节将介绍如何将相关数据存储到数据库中

*  将 驱动 jar 包添加到 conf/lib 下。(如：mysql-connector-java-5.1.7-bin.jar)

wget http://www.stonelu.com/public/mysql-connector-java-5.1.7-bin.jar -P james-server-app-3.1.0/conf/lib

*  修改 conf/james-database.properties 注释掉 默认的 DERBY 存储，使用 mysql：

# Use derby as default 
       #database.driverClassName=org.apache.derby.jdbc.EmbeddedDriver 
       #database.url=jdbc:derby:../var/store/derby;create=true 
       #database.username=app 
       #database.password=app 
       database.driverClassName=com.mysql.jdbc.Driver 
       database.url= jdbc: mysql:/ /www.test.com:3306/james?rewriteBatchedStatements= true&useUnicode= true&characterEncoding=utf8 
       database.username=james #账密自行修改即可 
       database.password=james 
       
       # Supported adapters are: 
       # DB2, DERBY, H2, HSQL, INFORMIX, MYSQL, ORACLE, POSTGRESQL, SQL_SERVER, SYBASE 
       #vendorAdapter.database=DERBY 
       vendorAdapter.database=MYSQL

*  修改 conf/mailetcontainer.xml：

1.      postmaster 修改为管理员邮箱，可以为 postmaster@yourDomain
2.      repositoryPath 同时存在文件存储 (file://)、数据库存储 (db://) 的，将默认的文件存储注释掉，并释放数据库存储；对于只存在文件存储的，不进行释放。分别如下图所示：

![70][]

![70 1][]

3.    RemoteAddrNotInNetwork 所在节点注释掉

![70 2][]

*  最后启动项目即可

> \[可能遇到的报错\]：

建表报错：Index column size too large. The maximum column size is 767 bytes.

SET GLOBAL innodb\_file\_format = BARRACUDA;

SET GLOBAL innodb\_large\_prefix = ON;

执行后重启项目即可

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

## ##

### 三、启用 SMTP 认证： ###

*  修改 conf/smtpserver.xml：

第一个 helloname 节点修改为邮箱后缀 \[域名\] -> 降低发送的邮件被 (收件方邮件服务器) 扔到垃圾箱的几率

authRequired、verifyIdentity 设置为 true 能够防止此邮件服务被当做邮件中继服务，防止跨账号邮件行为，避免被域名信誉机构拉入黑名单，影响或无法正常发送邮件。

![70 3][]

![70 4][]

*  最后重启服务即可

### 四、使用 SSL/TLS 协议： ###

*  将 sunjce\_provider.jar (在 jre/lib/ext 下有) 到 lib 下（*注意*：不是 conf/lib 下）

wget http://www.stonelu.com/public/sunjce_provider.jar -P james-server-app-3.1.0/lib

*  生成 keystore：

keytool -genkey -alias james -keyalg RSA -keystore keystore

![70 5][]

*  接下来演示 SMTP 使用 SSL/TLS 协议（POP 和 IMAP 类比即可）：

![70 6][]

> Tips：

1）配置文件：

SMTP - smtpserver.xml

POP - popserver.xml

IMAP - imapserver.xml

2）端口：

POP3 - port 110, Secure POP3 - port 995  
IMAP - port 143, Secure IMAP4 - port 993  
SMTP - port 25, Secure SMTP - port 465

*  最后 重启服务即可

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

### 五、验证： ###

*  添加两个用户：Danny@develop.com、Jenny@develop1.com，密码分别为：sec123、sec456

# 添加用户的指令： AddUser <username> <password> 
       # windows： 
       james-cli.bat -h localhost -p 9999 AddUser Danny@develop.com sec123 
       james-cli.bat -h localhost -p 9999 AddUser Jenny@develop1.com sec456 
       # linux： 
       sh james-cli.sh -h localhost -p 9999 AddUser Danny@develop.com sec123 
       sh james-cli.sh -h localhost -p 9999 AddUser Jenny@develop1.com sec456

*  安装 Foxmail 客户端，并添加账号

![70 7][]

*  Jenny@develop1.com 与 Danny@develop.com 邮件互通

![70 8][]

![70 9][]

*  给外网的其他邮件服务器发送邮件

这块不太好验证，因为主流的公共邮箱 (如腾讯、Gmail) 均具有较强的反垃圾邮件能力，给前者发送的邮件绝大部分会被退回。

可以在购买域名后，做好域名解析（包括 A、MX 记录），然后在服务器上搭一套 James 邮件服务，在服务器上验证或者在服务器与本地之间进行验证都是可以的。

这里也暴露了一个非常大的问题：邮件服务可能会受到垃圾邮件的攻击，这也是邮件服务提供商面临的一个大问题，现国内外大部分服务器提供商均对 25 端口进行了限制，防止垃圾邮件泛滥。在邮件服务层面还是需要进行很多反垃圾邮件工作的，此课题已超出本文范围，在此便不进行讨论了。

![70 10][]

![70 11][]

> Tips:  
> 1）获取所有可用的指令及用法：   
>   \# windows：  
>   james-cli.bat  
>   \# linux：  
>   sh james-cli.sh

2）James 数据操作途径：  
  整体来说，有三种： xml 配置文件、james-cli 客户端操作、数据库操作 (立即生效)  
    
  例如：   
    > 添加 Domain 有三个途径：  
      配置文件：  
        domainlist.xml  
      james-cli 客户端：  
        \# windows：  
        james-cli.bat -h localhost -p 9999 AddDomain develop3.com  
        \# linux：  
        sh james-cli.sh -h localhost -p 9999 AddDomain [develop3.com][]  
      数据库操作：  
        insert into james\_domain values('develop3.com');  
          
    > 添加用户有两个途径：  
      james-cli 客户端：  
        \# windows：  
        james-cli.bat -h localhost -p 9999 AddUser Sara@develop.com sec789  
        \# linux：  
        sh james-cli.sh -h localhost -p 9999 AddUser Sara@develop.com sec789  
      数据库操作：  
        INSERT INTO james\_user VALUES('Sara@develop.com', 'MD5', MD5('sec789'));

[https_blog.csdn.net_hjnth_article_details_82931569]: https://blog.csdn.net/hjnth/article/details/82931569
[https_github.com_apache_james-project_apache-james-project]: https://github.com/apache/james-project/#apache-james-project
[https_github.com_apache_james-project_how-to-run-james-in-docker]: https://github.com/apache/james-project/#how-to-run-james-in-docker
[https_github.com_apache_James-project]: https://github.com/apache/james-project/#other-useful-commands
[java.net.UnknownHostException]: http://java.net.unknownhostexception/
[70]: /images/20210920/e7b4fb2f028d4cd4aa6bdc6dc1f77b3a.png
[70 1]: /images/20210920/91f4db1549894b4aba81621ac01849fb.png
[70 2]: /images/20210920/939b2bb218de4f108819ed56afd6d375.png
[70 3]: /images/20210920/73b1334441e6404184c0ad562e864245.png
[70 4]: /images/20210920/26a602e9e0124f3cbdd3467c9cd49652.png
[70 5]: /images/20210920/100cfc95d5994a06bd3d5f9e7febae18.png
[70 6]: /images/20210920/6c5054bf6aed4bcbbf8291af9cd65ce3.png
[70 7]: /images/20210920/246bc352843945eea6a6d60a5dab048b.png
[70 8]: /images/20210920/40619821670745ba827170e7d90f9425.png
[70 9]: /images/20210920/4c829e304a834d8685eaf2992de18b05.png
[70 10]: /images/20210920/6a2534e851e346b798f926504ce74d65.png
[70 11]: /images/20210920/7bae473e5fec4f1496b661a08f8a0896.png
[develop3.com]: http://develop3.com