邮件

接收与转发

如果发到你域名的回信统统被退回，用域名发信的意义也就所剩无几。收信通常意味着再买一个邮箱席位，或者跟某个转发服务较劲。既然你的域名已经完成了发信验证，GoShipFast 顺手把环闭上：加一条 MX 记录，发到你域名的邮件想流向哪里都行。

回信转发

打开邮件 → 接入 → 转发。填上你日常在看的那个邮箱，添加页面显示的 MX 记录，点开始转发。从此：

• 默认转发（catch-all）：发到你域名下任何地址的邮件，hello@、support@、press@，随便什么，都会落进你的收件箱。地址在有人写信给它的那一刻自动存在；永远无需管理邮箱账号。
• 指定地址：不同地址要去不同地方时，添加显式规则（support@ 进共享收件箱，founders@ 给你自己）。指定规则优先于 catch-all。

转发的邮件原样抵达，附件、HTML、内嵌图片一样不少；邮件头只做重新投递所必需的最小调整。转发随时可以暂停或关闭。

每封来信都会出现在追踪 → 收件里，附带结果：已接收、已转发、转发失败或已跳过。"那封邮件到底到没到"从此有据可查。

收件 webhook

转发服务的是人，webhook 服务的是你的软件。在接入 → API → 收信 Webhook 里配置一个 endpoint URL，之后每封收到的邮件都会同时以 email.received 事件 POST 给你：from、to、subject 和正文（text 与 HTML，超长会在合理尺寸截断）。

常见用法：把 support@ 接进工单系统，让用户通过邮件把内容投进你的应用，或者在某个特定地址收到信时触发自动化。

验证签名

每次投递都带签名，伪造的请求可以直接拒收。POST 附带两个请求头：

• X-GSF-Timestamp：投递时间。
• X-GSF-Signature：一个 HMAC-SHA256 签名，用你 webhook 的签名密钥对字符串 timestamp + "." + raw request body 计算得出。

在你这边重新计算 HMAC，做恒定时间比较，并拒绝过期时间戳以防重放。产品内的 API 文档页提供可直接复制的验签代码；签名密钥就显示在 endpoint 配置旁边，支持轮换。

注意事项与限制

• 收信的前提是有一个已验证的发件域名；收件是域名的一种附加模式，直接建立在发信验证之上。
• MX 记录会把域名的邮件指向 GoShipFast 的接收基础设施。如果这个域名已经在别处运行邮箱（比如 Google Workspace 的 MX），切换前请三思：MX 只能有一套，指到这里意味着域名的全部邮件都改走转发。常见的稳妥做法是在子域名上收信，或者选一个还没有邮箱的域名。
• 转发和 webhook 是两个独立开关；单开一个或全开都行。