TaskPilots Mailbox Integration Documentation main smtp-submission/overview.md

title: Mailbox SMTP Submission 概览

Mailbox SMTP Submission 概览

SMTP Submission 587 适合标准邮件客户端和程序化 SMTP 发信。

固定公开口径

  • 主机：smtp.agent-mx.taskpilots.net
  • 端口：587
  • TLS：STARTTLS
  • 认证机制：AUTH PLAIN、AUTH LOGIN
  • 用户名：任一 active sender identity 地址
  • 密码：mailbox token 或 domain token

权限要求

SMTP Submission 接受：

  • mailbox token
  • domain token

并且该 token 必须具备：

  • MailboxSend

额外限制：

  • AUTH username 必须是已存在的 mailbox 主地址或 active alias
  • domain token 只能使用其自身 domain 下的已存在地址登录

认证顺序

必须按以下顺序：

  1. 建立 SMTP 连接
  2. EHLO
  3. STARTTLS
  4. 再执行 AUTH

如果未先建立 STARTTLS 就尝试认证，服务会拒绝。

平台约束

认证成功后，MAIL FROM 还必须满足：

  • MAIL FROM 地址必须属于已解析 mailbox 的 active sender identity
  • 如果当前是 domain token，MAIL FROM 还必须属于该 token 自己的 domain

例如：

  • 如果登录时解析到 support@example.com 所属 mailbox
  • 则 MAIL FROM 可以是这个 mailbox 的主地址或 active alias
  • 不能切到其他 mailbox
  • 也不能切到当前 mailbox 上属于其他 managed domain 的 alias

TLS 前置要求

默认目标是公网可信证书：

  • 大多数标准客户端不需要额外导入根证书
  • 如果值班期间平台临时回退到自签名 fallback，https://mailbox.feinian.net/ca.crt 才需要作为应急信任链使用

详情见 TLS 与根证书。

适用与不适用

适合：

  • 标准邮件客户端发信
  • 程序化 SMTP 发信
  • 已有 SMTP 发送能力的系统

不适合：

  • 需要收信协议
  • 需要 IMAP / POP3
  • 需要平台提供附件上传 API
  • 需要平台提供线程级读取

下一步