Models Hub
使用指南代理商指南

邮件发送配置

配置平台托管或自有 Postmark、阿里云邮件推送及自有 SMTP,并理解测试、域名验证与平台兜底规则。

编辑此页

邮件发送位于 代理后台 → 设置,紧挨着余额提醒邮件。只有代理 owner 可以修改发件服务;子管理员不能读取或更改凭据。

三种选择

服务谁提供凭据适合场景
Postmark(推荐)可选平台托管,也可填写自己的 Server API Token希望通过 HTTPS API 使用自己的发信域名,避开 SMTP 端口限制
阿里云邮件推送代理填写自己的发信地址和 SMTP 密码已在 DirectMail 完成域名验证,且希望独立管理发信账号
自有 SMTP代理填写企业邮箱或邮件服务商的 SMTP 凭据已有 Google Workspace、Microsoft 365、Zoho 或企业邮箱等服务

Postmark 支持两种方式:勾选“使用平台托管 Postmark”时不显示平台密钥;取消勾选后可填写代理自己的 Postmark Server API Token。平台的 Server Token 与 Account Token 不会下发给代理。

平台托管 Postmark

  1. 选择平台托管 Postmark,先保持“启用自定义发件人”关闭;
  2. 填写你拥有的发信域名,例如 mail.example.com
  3. 在 DNS 服务商添加页面显示的域名归属 TXT;
  4. 点击检查验证,系统会创建或复用 Postmark 域名并给出 DKIM 与 Return-Path 记录;
  5. 添加这些记录并再次检查,直到显示已验证;
  6. 发件邮箱必须使用完全相同的域名,例如 noreply@mail.example.com
  7. 保存后发送测试邮件,确认收件箱、垃圾箱、发件地址和显示名称;
  8. 测试正常后,再启用自定义发件人并保存。

如果页面提示“平台尚未启用 Postmark 域名托管”,需要 ModelsOk 主站系统管理员进入主站 系统设置 → 运营 → 邮件发送,配置 Postmark Account Token。这个操作由平台运维完成,不是代理后台权限问题。

自有 Postmark 账号

  1. 取消勾选“使用平台托管 Postmark”;
  2. 在 Postmark 的 Server → API Tokens 复制 Server API Token,填写到代理后台;
  3. 填写事务邮件流 ID,默认通常为 outbound;如需发送公告或账单群发,再填写对应的 Broadcast Message Stream ID;
  4. 在自己的 Postmark 账号中验证发件域名或 Sender Signature;
  5. 填写已获 Postmark 授权的发件邮箱与名称,保存后发送测试邮件;
  6. Token 只会加密保存,页面重新打开时仅显示“已保存”,不会回显明文。

Postmark Account Token 只用于平台代管域名,不是发送邮件所需的 Server API Token。使用自有账号时无需把 Account Token 交给平台。

阿里云邮件推送

  1. 在 DirectMail 控制台验证发信域名并创建发信地址;
  2. 为发信地址设置专用 SMTP 密码,不要填写阿里云登录密码或 AccessKey;
  3. 在代理后台选择和 DirectMail 相同的区域;系统使用 TLS 465;
  4. SMTP 账号和发件邮箱均使用已授权的发信地址;
  5. 保存后发送测试邮件,成功收到后再启用。

自有 SMTP

向邮件服务商取得 SMTP 主机、端口、加密方式、账号和 SMTP/App Password。端口 465 通常使用 TLS;25、587、2525 在这里使用 STARTTLS。当前不支持只允许 OAuth2 的 SMTP 账号。

发件邮箱必须获得服务商授权,并完成 SPF、DKIM。建议使用专门的发信账号,不要使用员工个人密码。

测试与兜底

  • “发送测试邮件”只测试当前保存的代理服务,收件人固定为代理 owner 的绑定邮箱,不会变成开放中继;
  • 测试成功表示服务商已接受,不等于必然进入收件箱,请同时检查垃圾箱;
  • 未配置、未启用或出现明确失败时,业务邮件会使用平台服务兜底,平台优先 Postmark,再回退平台 SMTP;
  • 网络中断等“可能已经被服务商接收”的不确定状态不会自动重复发送,以免用户收到两封;
  • 使用代理自有 Postmark Token、阿里云或自有 SMTP 时,登录验证码、邮箱绑定、邮件 2FA 等安全邮件仍走平台通道;只有平台托管 Postmark 可以用代理域名发送安全邮件。

常见问题

现象处理
看不到 Postmark 密钥输入框取消勾选“使用平台托管 Postmark”,即可填写自己的 Server API Token
Postmark 域名托管未启用联系 ModelsOk 系统管理员配置 Account Token
DNS 一直未验证检查记录名是否重复拼接域名,等待传播后再检查;验证记录不要删除
SMTP 认证失败核对专用 SMTP 密码;修改主机、端口、加密或账号后必须重新输入密码
测试成功但没收到检查 owner 绑定邮箱、垃圾箱和服务商投递日志

相关

本页目录