阿里云邮件推送（DirectMail）对接使用完全指南：从开通到生产级实践
一、认识阿里云邮件推送（DirectMail）
阿里云邮件推送（DirectMail）是一项高效、稳定、可扩展的电子邮件发送服务。它为企业与开发者提供了从触发邮件（如注册验证、密码重置、订单通知）到批量营销邮件的全场景发送能力。与传统的自建邮件服务器相比，DirectMail免去了繁琐的服务器运维、IP信誉维护和反垃圾邮件策略配置工作，让开发者能够专注于业务逻辑本身。
DirectMail的核心优势体现在三个方面：一是高到达率，依托阿里云庞大的IP资源池和智能路由策略，有效提升邮件进入收件箱的概率；二是弹性扩展，按量付费模式使得发送量可以从每天几十封平滑扩展到数百万封；三是接入灵活，提供了控制台、API和SMTP三种接入方式，适配不同技术栈和业务场景。
在开始对接之前，需要先登录阿里云控制台，点击：阿里云控制台，在产品列表中找到“邮件推送”或直接搜索“DirectMail”，点击开通服务。新开通的账户享有2000封免费发信额度，每天最多免费发送200封。对于个人开发者或初创团队而言，这个免费额度足以支撑早期的业务验证。
二、发信域名配置：邮件推送的基石
发信域名是邮件发送时的“身份证”，每个账户必须至少拥有一个发信域名。在SMTP会话过程中，发信域名就是Mail-From的后缀。邮件服务商（如Gmail、Outlook等）正是根据发信域名来统计发信频率和信誉等级，因此域名配置的质量直接影响到邮件的到达率。
2.1 新建发信域名
进入邮件推送控制台后，在左侧导航栏单击“发信域名”，点击“新建域名”按钮。填入您用于发信的域名。这里需要注意几个要点：如果您的主域名是example.com，建议使用子域名如dm.example.com或mail.example.com进行发信，这样可以避免影响主域名的其他邮件服务；如果该域名已用于其他企业邮箱或邮件推送服务，将无法再次配置，请使用其他子域名或新购域名；暂不支持中文域名等非英文域名。
2.2 域名验证与DNS解析配置
域名添加完成后，需要进行DNS验证。邮件推送要求配置六条DNS记录，分别是TXT验证记录、SPF记录、DKIM记录、DMARC记录、MX记录和CNAME跟踪记录。这六条记录各有其作用：TXT记录用于验证您对该域名的所有权；SPF记录声明哪些服务器被授权代表该域名发送邮件，防止他人伪造您的域名发信；DKIM记录通过数字签名验证邮件内容的完整性和真实性，有效防止域名被伪造；DMARC记录则定义了收信方如何处理未能通过SPF或DKIM验证的邮件。
如果您的域名购买自阿里云且与邮件推送服务在同一个账户下，可以尝试“自动配置”功能，授权邮件推送自动完成DNS解析。对于非阿里云购买的域名，则需要进行手动配置：在域名控制台添加从邮件推送控制台获取的六条记录值。配置完成后，DNS生效通常需要1到10分钟，点击控制台的“刷新”按钮即可查看验证结果。SPF记录只能有一条，如果有多个出口IP，需要合并到一条记录中。
三、发信地址与SMTP密码设置
发信域名配置成功后，下一步是创建发信地址。发信地址就是收件人收到的邮件中显示的发件人邮箱地址。
3.1 新建发信地址
在邮件推送控制台左侧导航栏单击“发信地址”，点击“新建发信地址”。在创建对话框中需要填写以下信息：选择已绑定到邮件推送的发信域名；设置发信地址的账号部分（如如果域名为dm.example.com，账号设为noreply，则完整发信地址为noreply@dm.example.com）；设置回信地址——用于接收用户回信的邮箱地址，必须是一个可以有效收信的邮件地址，且需要验证通过。如果不填回信地址，将无法收到用户的回信；选择发信类型：触发邮件或批量邮件。触发邮件适用于注册验证、密码重置、订单通知等场景，批量邮件适用于营销推广、 newsletter等场景。规范使用发信类型有助于提高发信地址在第三方接收方的信誉度。需要注意的是，每个自然月内最多可以累计删除10次发信地址，每个账户最多可创建100个发信地址。
3.2 验证回信地址
回信地址创建后需要进行验证。在发信地址列表中，点击对应地址的“验证回信地址”按钮，系统会向该邮箱发送一封包含验证码的邮件。登录回信地址邮箱获取验证码并填入对话框完成验证。验证码有效期为15分钟，需在触发验证后15分钟内完成。
3.3 设置SMTP密码
如果要通过SMTP协议发送邮件，必须为发信地址设置SMTP密码。在发信地址列表中，点击对应地址的“设置SMTP密码”操作。密码有严格的复杂度要求：长度10到20位，必须包含数字、大写字母和小写字母，至少包含2位数字、2位大写字母和2位小写字母，且不能与上一次设置的密码相同。新建的发信地址建议等待10分钟后再尝试发信。
四、三种邮件发送方式详解
阿里云邮件推送提供了三种邮件发送方式：控制台发送、API接口发送和SMTP协议发送。开发者可以根据业务场景和技术栈灵活选择。
4.1 控制台发送（零代码入门）
控制台发送是最简单、最直接的入门方式，适合测试验证、批量发送营销邮件或非技术人员操作。在邮件推送控制台左侧导航栏单击“发送邮件”，进入发送邮件页面。通过控制台发送邮件需要创建邮件发送任务，包括选择发信地址、选择已审核通过的邮件模板、上传收件人列表等步骤。发送任务创建后，系统会展示发送工作清单，每个发送任务的详细状态均可查看。
4.2 API接口发送（程序化集成）
API接口发送是将邮件推送能力集成到应用程序中的主流方式。邮件推送提供了两个核心API：SingleSendMail用于发送单条触发邮件，BatchSendMail用于批量发送邮件。API调用需要先获取AccessKey（建议使用RAM子账号的AccessKey，遵循最小权限原则），并在代码中通过阿里云SDK进行调用。
以下是使用Python SDK调用SingleSendMail发送邮件的完整示例：
from aliyunsdkcore.client import AcsClient
from aliyunsdkdm.request.v20151123 import SingleSendMailRequest
import os
# 从环境变量获取凭证，切勿硬编码
client = AcsClient(
os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
'cn-hangzhou'
)
request = SingleSendMailRequest.SingleSendMailRequest()
request.set_AcceptFormat('json')
request.set_AccountName('noreply@dm.example.com') # 发信地址
request.set_AddressType(1) # 1为发信地址，0为随机地址
request.set_ReplyToAddress('true') # 启用控制台配置的回信地址
request.set_ToAddress('user@example.com') # 收件人地址
request.set_Subject('【重要】您的账户验证码')
request.set_HtmlBody('<html><body><h1>您好</h1><p>您的验证码是：<strong>123456</strong></p></body></html>')
request.set_TagName('verification') # 邮件标签，用于分类统计
response = client.do_action_with_exception(request)
print(response)使用API发送邮件时，需要注意以下几点：SingleSendMail不支持发送附件；单次请求最多支持100个收件地址；HtmlBody和TextBody必须传其一，两者是针对不同类型的邮件内容；邮件主题长度不超过100个字符；SDK限制正文大小80K。如果需要发送附件或更复杂的邮件内容，建议使用SMTP方式。
4.3 SMTP协议发送（兼容性最强）
SMTP（Simple Mail Transfer Protocol）是标准邮件传输协议，如果您的应用程序已经集成了SMTP客户端，或者需要通过现有邮件服务器发送邮件，SMTP方式是最自然的选择。邮件推送的SMTP服务器地址为smtpdm.aliyun.com。SMTP发信需要先为发信地址设置SMTP密码（参见3.3节）。SMTP发信频率限制为12000次/180秒。端口方面，非加密端口为25，明文端口为80，SSL加密端口为465。需要注意的是，ECS默认封锁25端口，建议使用80或465端口。
以下是使用Java通过SMTP协议发送邮件的示例：
import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;
public class DirectMailSMTPExample {
public static void main(String[] args) throws Exception {
String smtpHost = "smtpdm.aliyun.com";
String smtpPort = "465";
String sender = "noreply@dm.example.com";
String password = "your_smtp_password";
String recipient = "user@example.com";
Properties props = new Properties();
props.put("mail.smtp.host", smtpHost);
props.put("mail.smtp.port", smtpPort);
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.ssl.enable", "true");
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
Session session = Session.getInstance(props, new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(sender, password);
}
});
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(sender));
message.setRecipient(Message.RecipientType.TO, new InternetAddress(recipient));
message.setSubject("【重要】您的账户验证码");
message.setContent("<html><body><h1>您好</h1><p>您的验证码是：<strong>123456</strong></p></body></html>", "text/html;charset=UTF-8");
Transport.send(message);
System.out.println("邮件发送成功");
}
}通过SMTP协议发送邮件的完整会话过程如下：客户端使用telnet连接到SMTP服务器建立会话；发送HELO或EHLO命令；发送AUTH认证命令进行用户登录；发送MAIL命令指定发件人；发送RCPT命令指定收件人；发送DATA命令准备输入邮件正文；发送点命令表示DATA结束；发送QUIT命令结束会话。
五、邮件模板与个性化变量
邮件模板是批量发送邮件的核心组件。模板定义了邮件的固定结构和可变内容，通过变量占位实现个性化发送。
5.1 创建邮件模板
在邮件推送控制台左侧导航栏单击“模板管理”，点击“新建模板”。填写模板名称、邮件标题、发件人名称和邮件正文。模板创建后处于“草稿”状态，需要提交审核。审核一般需要1到3个工作日。审核通过后方可用于发送邮件。未通过审核的模板可以重新编辑后再次提交。每个账户最多可保存100个邮件模板。模板正文大小限制为1M，邮件标题长度限制为100个字符。审核通过的模板或已发送过的模板，重新编辑后状态会被重置为草稿，需重新提交审核。
5.2 变量替换与个性化
变量是邮件模板实现个性化的关键机制。在模板正文中使用{变量名称}作为占位符，系统会在发送时自动替换为对应收件人的具体数据。变量名仅支持英文大小写字母。单个邮件模板最多可设置50个变量。系统预置了六个固定变量：{EAddr}替换收件人邮箱地址，{UserName}替换收件人真实姓名，{NickName}替换收件人昵称，{Gender}替换称呼。此外，开发者还可以自定义变量，如{Birthday}替换收件人生日。
模板正文示例：
您好，{UserName}{Gender}，
您的邮件地址是{EAddr}，
生日是{Birthday}，
欢迎使用邮件推送业务。正式发送时，需要在创建收件人列表时上传对应的列值，确保变量能被正确替换。收件人列表可以通过上传CSV文件或单条JSON格式创建，如：{"UserName":"张三","Birthday":"1990/1/1","Gender":"先生"}。模板中的图片仅支持插入网络中允许外链的HTTPS开头的图片地址链接，暂不支持插入本地图片。
六、邮件标签、收件人列表与高级功能
6.1 邮件标签
邮件标签用于分类所发送的邮件批次，便于在控制台中按标签过滤统计数据。在发送邮件时选择一个标签进行标记，之后可以在控制台中查看每个标签的发送统计。如果开启邮件跟踪功能，发信时必须使用邮件标签。
6.2 收件人列表
收件人列表存储批量发送邮件时目标地址的集合。通过控制台或BatchSendMail API发送批量邮件时，需要引用已创建的收件人列表。收件人列表可以通过上传CSV文件或JSON格式创建。
6.3 IP防护
IP防护功能用于提高SMTP和API发信的安全性。在控制台左侧导航栏单击“邮件设置 > IP防护”。勾选“开启IP防护”后，添加发信所使用的IP、IP区间或IP段到白名单中。开启后，只有白名单中的IP地址才能通过该账户的SMTP或API发信，有效防止账号被盗用。
6.4 异步通知
异步通知用于接收邮件投递结果回调。设置异步通知需要先在轻量消息队列（原MNS）控制台创建事件通知规则，再到邮件推送控制台新建异步通知。轻量消息队列可能会产生费用。设置异步通知时需要使用阿里云主账号，轻量消息队列目前不支持子账号。发信地址级的异步通知优先级高于账户级异步通知。
七、数据统计与监控
邮件推送控制台的“数据统计”页面展示了多维度的发送指标，包括发送总量、成功量、失败量、打开率、点击率等。可以按发信地址和邮件标签查询统计数据。邮件跟踪数据最多保留14天。通过定期查看统计数据，开发者可以及时发现问题、优化发送策略。无效地址率应低于5%，垃圾邮件率低于2.5%，成功率高于92%，这些指标是维持良好信誉等级的关键。
八、信誉等级与限额管理
邮件推送服务根据账户的发信质量动态评估信誉等级。信誉等级直接影响每日发送额度。提升信誉等级的核心在于提高邮件送达质量。具体包括确保无效地址率低于5%，垃圾邮件率低于2.5%，成功率高于92%；每日发送量大于300封，并接近或达到日额度的70%以上。在控制台概览页可以设置最高信誉等级限制，避免网站被人恶意利用导致邮件量突增而产生过度消费。默认最高信誉等级为10级。
九、常见问题与解决方案
Q1：发信域名验证失败怎么办？
首先检查DNS记录是否已正确添加。SPF记录只能有一条，如果有多个出口IP需合并。TXT记录单行建议不超过256字符。DNS生效需要1到10分钟，请耐心等待后刷新控制台。
Q2：SMTP发信提示认证失败？
检查发信地址是否已设置SMTP密码；确认SMTP用户名与发信地址完全一致；检查密码是否正确，注意密码复杂度要求；新建发信地址需等待10分钟后再尝试。
Q3：邮件发送后被标记为垃圾邮件怎么办？
检查邮件内容是否包含过多营销词汇或链接；确保SPF、DKIM、DMARC记录已正确配置；确认发信域名和IP的信誉度良好；避免在短时间内发送大量相似内容的邮件；对于非营销邮件，可以将发送失败的邮件以附件形式发送至antispam_fankui@alibaba-inc.com申请审核。
Q4：如何查看邮件是否成功送达？
在邮件推送控制台的“数据统计”页面查看发送状态；设置异步通知接收投递结果回调；查看退信代码，4xx表示临时性错误（会重试），5xx表示永久性错误。
Q5：免费额度用完后如何计费？
每个主账户享有2000封免费发信额度，每天最多免费发送200封。超出免费额度后按量计费，主要计费项包括邮件发送量（按封数计费）和独立IP（如使用）。
Q6：触发邮件和批量邮件有什么区别？
触发邮件用于系统自动触发的场景，如注册验证、密码重置、订单通知等，对实时性要求较高；批量邮件用于营销推广、newsletter等场景。两者对应不同的发信策略和信誉评估体系，规范使用有助于提高邮件到达率。
