Docker中Apache James邮件服务器无法连接Thunderbird求助

一、无加密IMAP(143)/SMTP(25)连接立即关闭的修复 #

Apache James默认禁用明文非加密认证连接，需调整配置开启：

1. 进入运行中的James容器：

   docker exec -it <你的容器ID或名称> bash
   

2. 修改IMAP服务配置文件conf/imapserver.xml：
   • 确保<enabled>值为true
   • 添加或修改节点：<plainTextAuthEnabled>true</plainTextAuthEnabled>
3. 修改SMTP服务配置文件conf/smtpserver.xml：
   • 设置<authRequired>true</authRequired>
   • 添加或修改节点：<plainTextAuthEnabled>true</plainTextAuthEnabled>
4. 退出容器并重启：

   docker restart <你的容器ID或名称>
   

二、SSL/TLS连接出现bad_certificate错误的修复 #

该问题源于证书与服务器身份不匹配，或Thunderbird不信任证书：

1. 重新生成匹配的密钥库 #

生成密钥时，CN(Common Name)必须与邮件服务器主机名一致（本地测试用localhost）：

keytool -genkeypair -alias myalias -keyalg RSA -keysize 2048 -keystore keystore -dname "CN=localhost, OU=Test, O=Example, L=Beijing, ST=Beijing, C=CN"

注意：密钥库密码需牢记，后续容器配置会用到。

2. 正确挂载密钥库到容器 #

启动James容器时，将密钥库挂载到容器默认配置路径（apache/james:jpa-latest默认路径为/root/conf/keystore），示例启动命令：

docker run -d \
  --name james-server \
  -p 25:25 -p 143:143 -p 465:465 -p 993:993 \
  -v ./keystore:/root/conf/keystore \
  apache/james:jpa-latest

3. 让Thunderbird信任证书 #

两种方式任选：

• 临时信任：首次连接时，在Thunderbird证书警告弹窗选择「永久接受此证书」
• 导入证书到信任列表：
  1. 从密钥库导出证书：

     keytool -exportcert -alias myalias -keystore keystore -file james.crt
     

  2. 打开Thunderbird → 选项 → 隐私与安全 → 证书 → 查看证书 → 导入，选择james.crt，勾选「信任此证书来识别网站」

三、基础配置验证 #

1. 确认用户和域名已正确添加：
   进入容器执行命令：

   james-cli listusers example.com
   

   应能看到user01@example.com

2. 确认端口映射正常：
   执行docker ps，检查25、143、465、993端口均显示为0.0.0.0:<端口>-><端口>/tcp

四、Spring Boot Spring Mail对接提前配置 #

加密连接（465/993）配置示例 #

spring.mail.host=localhost
spring.mail.port=465
spring.mail.username=user01@example.com
spring.mail.password=test
spring.mail.properties.mail.smtp.ssl.enable=true
spring.mail.properties.mail.smtp.ssl.trust=localhost
# 若使用自定义密钥库，添加以下配置（密钥库放到resources目录）：
# spring.mail.properties.mail.smtp.ssl.key-store=classpath:keystore
# spring.mail.properties.mail.smtp.ssl.key-store-password=<你的密钥库密码>

非加密连接（25/143）配置示例 #

spring.mail.host=localhost
spring.mail.port=25
spring.mail.username=user01@example.com
spring.mail.password=test
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=false

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