用途:在正式发送前添加并验证你控制的 Mailtrap 发送域名,排查 DNS 传播问题、发布 SPF/DKIM/DMARC 记录并完成合规步骤。需添加与 From 地址完全一致的主机名,若要发自 notifications.mycompany.com 就添加该子域名,不要只加根域。界面会显示全部所需 DNS 记录,应一次性按原样添加,不要挑选性添加。
主要能力:通过界面或 API 列出、创建发送域名并获取 dns_records(含 type、name、value、验证状态)与 dns_verified;支持在 Cloudflare、AWS Route 53、Google Cloud DNS、Squarespace、GoDaddy、Namecheap、DigitalOcean 等提供商的 API 或 IaC 中发布记录;无自动化时可手动在注册商界面添加。
使用方式:Sending Domains > Add domain 添加域名;从 UI 或 API 获取全部记录,在 DNS 服务商处按名称、类型、值精确创建;等待传播后如仍处于待验证,可用 dig、nslookup 或在线查询确认记录已公开可见,再点击 Verify;按提示完成合规。API 调用需 Authorization: Bearer $MAILTRAP_API_TOKEN,路径含 $MAILTRAP_ACCOUNT_ID(可从 GET https://mailtrap.io/api/accounts 获取),令牌存于环境变量或密钥管理。常用接口:GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains、GET .../sending_domains/{sending_domain_id}、POST .../sending_domains(传 domain_name)。
适用场景:新发送域名配置、验证卡住或合规问题;使用各类常见 DNS 服务商的情况。
限制与注意:仅做沙盒测试且无自定义域名时不适用(参见 mailtrap-testing-with-sandbox)。若 DNS 服务商启用代理(如 Cloudflare 橙云),验证相关记录必须设为仅 DNS(灰云/非代理),否则常会破坏 SPF/DKIM 验证;其他前置代理的主机同样受限。DNS 与合规界面可能变化,发布前务必从 Mailtrap 复制当前实际记录,并与官方提供商指南配合使用。域名就绪后可衔接 mailtrap-sending-emails。