一、认识阿里云邮件推送（DirectMail）

阿里云邮件推送（DirectMail），简单来说，就是一套高效可靠的云端邮件发送服务。它覆盖的业务场景十分广泛，从注册验证、密码重置这类“触发邮件”，到营销推广用的“批量邮件”，均可轻松应对。与传统自建邮件服务器相比，优势非常明显：你无需操心服务器维护、IP信誉培养、反垃圾策略配置等繁琐工作，把这些底层技术难题都交给阿里云处理，开发者只需专注于业务逻辑本身。

这套服务的核心优势，概括起来主要有三点。第一，送达率高。依托阿里云庞大的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发送邮件的完整示例：

使用API发送邮件时，有几个注意事项：SingleSendMail不支持发送附件；单次请求最多支持100个收件地址；HtmlBody和TextBody必须至少传入一个，这是针对不同类型的邮件内容；邮件主题长度不超过100个字符；SDK限制正文大小为80K。如果需要发送附件或更复杂的内容，建议使用SMTP方式。

4.3 SMTP协议发送（兼容性最强）

SMTP是标准邮件传输协议。如果你的应用已经集成了SMTP客户端，或者需要通过现有邮件服务器发送邮件，SMTP方式是最自然的选择。邮件推送的SMTP服务器地址是smtpdm.aliyun.com。SMTP发信需要先为发信地址设置SMTP密码（见3.3节）。SMTP发信频率限制为12000次/180秒。端口方面，非加密端口25，明文端口80，SSL加密端口465。需要注意，ECS默认封锁25端口，建议使用80或465端口。

以下是使用Java通过SMTP协议发送邮件的示例：

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}替换收件人生日。

模板正文示例：

正式发送时，需要在创建收件人列表时上传对应的列值，确保变量能被正确替换。收件人列表可以通过上传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等场景。两者对应不同的发信策略和信誉评估体系，规范使用有助于提高邮件到达率。