如何在Docker容器的Tomcat应用中配置使用AWS SES

一、两种AWS SES发信方案可选 #

你的EC2实例已配置SES发信权限的角色，有两种路径可以实现：

• SMTP协议方案：使用你已获取的SES SMTP凭证（用户名/密码），配置标准SMTP参数
• IAM角色授权方案：直接依托EC2实例角色权限，无需SMTP密码，通过AWS SDK调用SES（前提是应用底层使用了AWS SDK）

二、定位遗留应用的邮件发送逻辑 #

既然常规配置文件里没找到SMTP相关配置，先从这几个方向排查应用的发信逻辑：

• 检查JavaMail API相关配置：Tomcat应用大多依赖JavaMail，重点看这两个位置：
  • Tomcat全局配置：Docker容器内路径为/usr/local/tomcat/conf/context.xml，查找是否有<Resource>标签定义邮件会话，示例格式如下：

    <Resource name="mail/Session"
              auth="Container"
              type="javax.mail.Session"
              mail.smtp.host="email-smtp.<你的AWS区域>.amazonaws.com"
              mail.smtp.port="587"
              mail.smtp.auth="true"
              mail.smtp.starttls.enable="true"
              mail.smtp.user="你的SMTP用户名"
              mail.smtp.password="你的SMTP密码"/>
    

  • 应用自身上下文配置：查看应用WEB-INF/context.xml，部分应用会在这里单独定义邮件资源
• 搜索源代码中的硬编码逻辑：在代码中检索javax.mail、send、SMTP等关键词，定位到发送邮件的代码块，直接修改其中的参数
• 检查环境变量：部分老应用会将配置存入环境变量，进入容器执行docker exec -it <容器ID> env，查看是否存在SMTP_HOST、SMTP_PORT、SMTP_USER这类变量

三、AWS SES具体配置参数 #

1. SMTP方式必填参数 #

无论在配置文件还是代码中，SES SMTP的核心参数固定：

• 主机名：email-smtp.<你的AWS区域>.amazonaws.com（例如email-smtp.us-east-1.amazonaws.com）
• 端口：优先使用587（TLS加密），或465（SSL加密）
• 用户名：你获取的SES SMTP用户名
• 密码：你获取的SES SMTP密码
• 加密开关：使用587端口时设置starttls.enable=true，使用465端口时设置ssl.enable=true

2. IAM角色方式（无需SMTP凭证） #

如果应用使用AWS Java SDK，可直接通过EC2实例角色授权，无需配置密码，SES客户端初始化示例：

AmazonSimpleEmailService sesClient = AmazonSimpleEmailServiceClientBuilder.standard()
                .withRegion(Regions.<你的AWS区域>)
                .withCredentials(new InstanceProfileCredentialsProvider())
                .build();

需确保EC2实例角色权限包含ses:SendEmail、ses:SendRawEmail等操作权限。

四、Docker容器内配置注意事项 #

• 修改Tomcat全局配置时，需确保配置文件可修改（可通过挂载宿主机卷或重新构建镜像实现）
• 若使用环境变量传递配置，启动容器时添加-e SMTP_HOST=xxx -e SMTP_PORT=587等参数，或在docker-compose.yml中配置环境变量
• 先验证连通性：进入容器执行telnet email-smtp.<你的AWS区域>.amazonaws.com 587，确认容器能正常访问SES的SMTP端口

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