james使用（一）：windows环境下james3.0.1版本邮件服务器搭建及配置

我就是我 2022-05-26 00:07 680阅读 0赞

### 1.介绍 ###

james是apache基金会下一款免费的提供pop3、stmp的开源免费邮件服务器，其最新版本为james sever 3.0,网上充斥着许多2.3版本的配置，3.0使用了spring的架构，配置上有些许不同，在配置过程中爬了很多坑，特此记录，给小伙伴们指明方向。后期会继续更新james的SDK的开发，敬请期待。

### 2.工具准备 ###

准备搭建基于普通的配置版本，后期准备使用到数据库，此事后谈。

(1) james安装包: [https://pan.baidu.com/s/1\_T3BxgKyRoXZJodY2vBbDA][https_pan.baidu.com_s_1_T3BxgKyRoXZJodY2vBbDA] 密码：hntp

![70][]

其中第一个为foxmail客户端，用来进行测试，第二第三分别为 james源代码和james 安装包。

(2) jdk 由于james由java语言编写，依赖java jvm，故需要安装java jdk,james3.0.1依赖的jdk版本为(题外话：以保险起见我安装的是jdk 不是jre，读者可验证安装 并jre是否会有问题，讲道理应该没有问题，某些开源会需要jdk，安装jre是不行的，列如hadoop）。此处不再赘述java安装和配置。

我使用的java 8 链接：链接：[https://pan.baidu.com/s/1LrGQCxHWO8TND7DMwM\_CiQ 密码：yfv4][https_pan.baidu.com_s_1LrGQCxHWO8TND7DMwM_CiQ _yfv4]

(3)foxmail客户端  链接：https://pan.baidu.com/s/1QZFo46zJrtNDvJtsRuQN2Q 密码：bl1g

#### 3.1 windows 系统变量配置 ####

winsdows默认dns localhost名为本地机器名，若 C:\\Windows\\System32\\drivers\\etc\\hosts 文件中localhost未启用，启用一下，为了方便与其他服务器通信，可以配置自定义机器名，我配置的为 mocha.com,如下所示

![70 1][]

#### 3.2 解压 ####

解压安装包到自己定义的目录下，我的是：C:\\Program Files\\james\\james-server-app-3.0.1，目录如下图所示

![70 2][]

---bin:程序各种工具和运行程序目录

---lib:依赖包

---conf:配置目录，我们配置就修改这里面的配置文件

---var:jamse server存储数据目录

#### 3.3 修改配置文件 ####

按照jamse doc所说其实不用修改配置文件的，不修改都有程序里都有默认配置，但实际运行却不是，会报各种错误，经测试， 所需修改的配置文件有如下，修改时将所有文件的后缀名.template去掉，然后复制到conf目录下，最终成功的配置文件打包 放在[https://download.csdn.net/download/fanpei\_moukoy/10393236][https_download.csdn.net_download_fanpei_moukoy_10393236]

![70 3][]

修改内容有【此处我的james部署ip为192.168.10.130】

<table> 
 <tbody> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">配置文件名称</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">原内容</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">修改后内容</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">domainlist</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">&lt;defaultDomain&gt;localhost&lt;/defaultDomain&gt;</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">&lt;defaultDomain&gt;mocha.com&lt;/defaultDomain&gt;</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">imapserver</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&lt;bind&gt;0.0.0.0:143&lt;/bind&gt;</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&lt;bind&gt;192.168.10.130:143&lt;/bind&gt;</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">smtpserver</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&nbsp;<span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">&lt;bind&gt;0.0.0.0:25&lt;/bind&gt;</span></span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">&lt;bind&gt;192.168.10.130:25&lt;/bind&gt;</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">pop3server</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&lt;bind&gt;0.0.0.0:110&lt;/bind&gt;</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&lt;bind&gt;192.168.10.130110&lt;/bind&gt;</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">jmx</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">jmx.address=127.0.0.1</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(247,247,247);">jmx.address=192.168.10.130</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">mailetcontainer</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&lt;postmaster&gt;postmaster@localhost&lt;/postmaster&gt;</span></td> 
   <td><span style="font-family:Arial, Verdana, sans-serif;font-size:14px;text-align:left;background-color:rgb(255,255,255);">&lt;postmaster&gt;postmaster@mocha.com&lt;/postmaster&gt;</span></td> 
  </tr> 
  <tr> 
   <td>managesieveserver<span style="white-space:pre;"> </span></td> 
   <td>&lt;bind&gt;0.0.0.0:4190&lt;/bind&gt;</td> 
   <td>&lt;bind&gt;192.168.10.130:4190&lt;/bind&gt;</td> 
  </tr> 
 </tbody> 
</table>

***需要特别说明的是：***我这里配置除了以上几个，还配置了bin目录下的wrapper.conf文件，配置参数和为什么要配置见文章

[james使用（二）：james3.0版本服务器搭建完成,收不到邮件javax.mail.MessagingException: Unable to access mailbox解决][james_james3.0_javax.mail.MessagingException_ Unable to access mailbox]

#### 3.4 安装 ####

(1)、以管理员模式打开cmd(防止因为权限问题不能生成文件或文件夹，安装会生成文件和目录),进入解压的james bin目录下执行run.bat安装，如图

![70 4][]

若出现服务启动多少秒，如下图所示则成功

![70 5][]

(2)、然后键盘使用ctrl+c,并根据提示输入y停止当前服务，使用james命令进行安装james

如下代码所示，输入james 出现如下提示，这是james 提供的命令

C:\Program Files\james\james-server-app-3.0.1\bin>james
    Usage: james { console : start : pause : resume : stop : restart : install : rem
    ove : status }

<table>  james command  
 <tbody> 
  <tr> 
   <th>命令</th> 
   <th>&nbsp;意义</th> 
  </tr> 
 </tbody> 
 <tbody> 
  <tr> 
   <td>console</td> 
   <td>&nbsp;以console模式启动james并将日志输出到console窗口上（作用类似于上文中的run,bat）</td> 
  </tr> 
  <tr> 
   <td>start</td> 
   <td>&nbsp;启动james服务</td> 
  </tr> 
  <tr> 
   <td>pause</td> 
   <td>&nbsp;暂停james服务</td> 
  </tr> 
  <tr> 
   <td>resume</td> 
   <td>&nbsp;重置james</td> 
  </tr> 
  <tr> 
   <td>stop</td> 
   <td>&nbsp;停止james服务</td> 
  </tr> 
  <tr> 
   <td>restart</td> 
   <td>&nbsp;重新启动</td> 
  </tr> 
  <tr> 
   <td>install</td> 
   <td>&nbsp;安装james到系统服务</td> 
  </tr> 
  <tr> 
   <td>remove</td> 
   <td>&nbsp;从系统服务移除james服务</td> 
  </tr> 
  <tr> 
   <td>status</td> 
   <td><p>&nbsp;查看james服务启动状态</p></td> 
  </tr> 
 </tbody> 
</table>

接下来的操作步骤如下:

1.  安装服务到系统：james install
2.  启动服务:james start
3.  查看服务状态 james status

如图成功，running Yes

![70 6][]

(3)、使用james-cli命令配置邮件后缀域名和用户

相同的如下图所示，输入james-cli出现很多命令提示，这里我们只介绍前面常用的几个，具体命令含义，读者后续可查看官方doc或者百度,命令使用不区分大小写

![70 7][]

<table>  james-cli command  
 <tbody> 
  <tr> 
   <td>命令</td> 
   <td>&nbsp;意义</td> 
  </tr> 
  <tr> 
   <td>adduser</td> 
   <td>&nbsp;添加用户&nbsp;格式为&nbsp;adduser &lt;name&gt; &lt;passwd&gt;</td> 
  </tr> 
  <tr> 
   <td>removeuser</td> 
   <td>&nbsp;移除用户&nbsp;格式为&nbsp;removeuser xxx1@xxx2 [移除时必须跟上全称即必须@加域名]</td> 
  </tr> 
  <tr> 
   <td>listusers</td> 
   <td>&nbsp;列出所有用户</td> 
  </tr> 
  <tr> 
   <td>adddomain</td> 
   <td>&nbsp;添加域名&nbsp;域名为@后的那部分，表示隶属于哪个公司，例如网上有163.com qq.com等，此处可自定义，我定义的就是mocha.com&nbsp;</td> 
  </tr> 
  <tr> 
   <td>remvedomain</td> 
   <td>&nbsp;移除域名</td> 
  </tr> 
  <tr> 
   <td>listdomains</td> 
   <td>&nbsp;列出所有域名</td> 
  </tr> 
  <tr> 
   <td>setpassword</td> 
   <td>&nbsp;单独设置某用户的密码&nbsp;格式为setpassword &lt;username&gt; &lt;passwd&gt;&nbsp;其中username&nbsp;为全称，例如xxx1@xxx2</td> 
  </tr> 
  <tr> 
   <td>containsdomain</td> 
   <td>&nbsp;检测是否包含某域名</td> 
  </tr> 
 </tbody> 
</table>

接下来,首先执行 james start启动server，然后再执行以下两步操作

*  添加域名 mocha.com
 *  添加用户 test1@mocha.com test2@mocha.com 并设置密码为test

C:\Program Files\james\james-server-app-3.0.1\bin>james-cli -h 192.168.10.130 ad
    ddomain mocha.com
    AddDomain command executed sucessfully in 281 ms.
    
    C:\Program Files\james\james-server-app-3.0.1\bin>james-cli -h 192.168.10.130 ad
    duser test1@mocha.com test
    AddUser command executed sucessfully in 261 ms.
    
    C:\Program Files\james\james-server-app-3.0.1\bin>james-cli -h 192.168.10.130 ad
    duser test2@mocha.com test
    AddUser command executed sucessfully in 188 ms.

执行成功后利用listdomains 和listusers查看，其中-h 192.168.10.130为连接服务端地址，由于我们使用在jmx中配置时地址改成了192.168.10.130，固此处必须使用相同ip才可进行jmx连接，不能使用127.0.0.1，否则连接失败

### 4.使用foxmail客户端测试james server ###

####  4.1 登录第一个账号，如图输入用户和密码点击创建 ####

![70 8][]

#### 4.2 配置服务器 ####

在途中红色框位置输入james安装所在的ip 192.168.10.130,端口号由于使用标准协议不用修改，此处我未进行修改直接点创建成功，原因在于我已经在hosts中配置dns映射，若未配置则需要输入ip

![70 9][]

#### 4.3添加另一个账号 ####

![70 10][]

如下图所示，点击左下角【创建】，填写用户名和服务器信息，点击【创建】后确定，添加完成：

![70 11][]

#### 4.5 编写邮件并发送后，查看是否能收到邮件 ####

*后记*：我最终配置配置完的包已上传至：[*已配置好了的 james-server-app-3.0.1版本*][james-server-app-3.0.1]需要的小伙伴可以去下载，有错误或者不懂的小伙伴，可以留言。

[https_pan.baidu.com_s_1_T3BxgKyRoXZJodY2vBbDA]: https://pan.baidu.com/s/1_T3BxgKyRoXZJodY2vBbDA
[70]: /images/20220526/f6119e6398494ac7b8dfe32cb80f3fa8.png
[https_pan.baidu.com_s_1LrGQCxHWO8TND7DMwM_CiQ _yfv4]: https://pan.baidu.com/s/1LrGQCxHWO8TND7DMwM_CiQ
[70 1]: /images/20220526/4c58b20fc8f744869b587619613d747c.png
[70 2]: /images/20220526/e401a0f781554790bf2d66d2e45ea4bf.png
[https_download.csdn.net_download_fanpei_moukoy_10393236]: https://download.csdn.net/download/fanpei_moukoy/10393236
[70 3]: /images/20220526/0db40fed8d77495e9da1e227882bd0a4.png
[james_james3.0_javax.mail.MessagingException_ Unable to access mailbox]: https://blog.csdn.net/Fanpei_moukoy/article/details/80202090
[70 4]: /images/20220526/375a7397b21147bfb0e5e22548aee07f.png
[70 5]: /images/20220526/531d53f2475341f3b54963b1f8e0849c.png
[70 6]: /images/20220526/3856ad8c5aac404b892afeb65ed71a58.png
[70 7]: /images/20220526/2fd695d651ce4506ab8b080cc8fbac0f.png
[70 8]: /images/20220526/b4ad7dfe26f845fbb997e810198c9304.png
[70 9]: /images/20220526/c391a87bb81242ae9b2e0c08982cb881.png
[70 10]: /images/20220526/a7880f4dbdca48ed877f1c95eb2c4bbf.png
[70 11]: /images/20220526/f835740472f941c48d81e017823e044c.png
[james-server-app-3.0.1]: https://download.csdn.net/download/fanpei_moukoy/10393231