Hyvor Relay 深度测评:免费自托管的开源 Email API,如何替代 SES、SendGrid 与 Mailgun?

原创2026-10-23 14:36:291,647 阅读

Hyvor Relay 深度测评:免费自托管的开源 Email API,如何替代 SES、SendGrid 与 Mailgun?

Hyvor Relay 是一款免费、开源、可自托管的 Email API 服务,定位是 AWS SES、SendGrid 和 Mailgun 的开源替代品:它跑在你自己的服务器上,通过 SMTP 直连收件方邮箱服务器发信,提供 HTTP API、Webhook、退信处理、DNS 自动化和完整的监控面板。简单说,你不再为每一封邮件付费,也不再把发信基础设施交给第三方——邮件 API 完全掌握在自己手里。

Hyvor Relay 自托管 Email API 的整体架构图

上图是 Hyvor Relay 的高层架构:API 服务器、邮件 Worker、SMTP 服务器、DNS 服务器和 Webhook Worker 全部打包在一个 Docker 镜像里,配合一个 PostgreSQL 数据库即可运行。官方文档中对自托管的预估是:一台 4GB 内存、2 vCPU 的服务器可以轻松支撑每天 100 万封邮件的发送量。

为什么需要自托管 Email API?

用 SendGrid、SES 这类商业 Email API,你需要接受三件事:

  • 按量计费:每封邮件都有成本,量大之后费用可观;
  • 共享 IP 池:你的邮件和其他租户共用发送 IP,别人被拉黑会连累你的送达率;
  • 基础设施不可控:数据、IP、队列都在别人手里。

Hyvor Relay 的思路是把整套发信基础设施开源出来:

  • API 后端用 PHP + Symfony 编写,位于 backend/src/;
  • 邮件 Worker、SMTP 服务器、DNS 服务器、Webhook 处理用 Go 编写,是单一二进制,位于 worker/;
  • 前端控制台用 SvelteKit 编写,位于 frontend/src/;
  • 数据库和消息队列统一用 PostgreSQL。

创建新项目时选择 Transactional 或 Distributional 类型的 Hyvor Relay 控制台界面

核心功能清单

以下是这次测评中重点体验到的功能,全部内置于开源版本(AGPL-3.0 许可):

功能 说明 源码/文档位置
Email API POST /api/console/sends 一个 REST 端点发信,支持 HTML/纯文本/附件/自定义头部 SendEmails.svelte/docs/content/SendEmails.svelte)
双队列隔离 Transactional 与 Distributional 邮件走不同队列和 IP,独立维护 IP 信誉 QueueService.php
退信与重试 自动解析 DSN 退信、ARF 投诉,处理 greylisting 与指数退避重试 dsn.go
抑制列表 硬退信、举报、退订地址自动进入 Suppression,不再重复发送 SuppressionService.php
DNS 自动化 内置 DNS 服务器,自动管理 DKIM、SPF、MX、PTR 等记录,无需手动维护 DnsRecordService.php
Webhook 邮件事件(accepted/bounced/complained 等)以签名 HTTP POST 回调 Webhooks.svelte/docs/content/Webhooks.svelte)
健康检查 每小时自动巡检 PTR、SPF、DKIM、IP 黑名单等 7 项关键配置 HealthCheckService.php
可观测性 内置 Prometheus 指标、Grafana 仪表盘配置与日志 monitoring/
多租户 租户 + 项目两级隔离,API Key 带 scope 权限控制 ApiKeyService.php

Sudo 管理面板:服务器、队列、IP 地址与 PTR 记录的可视化界面

Sudo 是面向管理员的面板(上图),服务器、IP、队列、DNS 记录、健康检查一目了然;Console 则是面向应用开发者的面板,管理项目、域名、API Key 和发信日志。

Hyvor Relay 对比 SES、SendGrid、Mailgun

维度 Hyvor Relay SES / SendGrid / Mailgun
成本 免费开源,只需付服务器费用 按邮件量计费,量大成本高
部署方式 Docker Compose 单机或 Swarm 集群自托管 纯云服务
IP 归属 完全专属,队列级隔离 共享池为主,专属 IP 另付费
数据主权 全部数据留在自己服务器 数据托管在厂商
送达率基础设施 SPF/DKIM/PTR/TLS/DNS 全自动 托管服务自动处理
内置模板 不支持(官方明确不做) 提供模板引擎
打开/点击追踪 明确不做 支持
内置用户认证 依赖 OIDC(如 Keycloak/Auth0) 自带账号系统

需要诚实地说明 Hyvor Relay 不会实现的部分(来自官方 ROADMAP.md):不内置认证系统(自托管实例走 OIDC)、不做打开/点击追踪、不提供邮件模板。另外 Incoming 邮件路由(把外部邮件转发给指定应用)还在路线图中未完成。

最快自托管部署方法:单机 Docker Compose 三步走

官方提供 Easy Deploy 模式,适合中小发送量场景,前置条件其实很少:

  1. 一台 Linux 服务器(最低 1GB 内存,推荐 2GB/2 vCPU),带至少一个静态公网 IPv4;
  2. Docker + Docker Compose;
  3. 一个 OIDC 认证提供商(Keycloak、Auth0、Authentik 均可),用于登录 Console 和 Sudo;
  4. 开放端口:80/443(API 与 Web)、25(收退信 SMTP)、587(SMTP 发信)、53(内置 DNS)。

部署文件就在仓库的 deploy/easy/compose.yaml,只有两个容器——postgres 和 relay,应用以 host network 模式运行以直接绑定发送 IP。核心步骤如下:

# 1. 克隆代码仓库
git clone https://gitcode.com/gh_mirrors/relay34/relay relay && cd relay/deploy/easy

# 2. 编辑 .env:APP_SECRET、POSTGRES_PASSWORD、WEB_URL、
#    INSTANCE_DOMAIN、OIDC_ISSUER_URL、OIDC_CLIENT_ID、OIDC_CLIENT_SECRET

# 3. 启动
docker compose up -d

环境变量中两个概念需要区分(详见 Env.svelte/hosting/content/Env.svelte)):

  • WEB_URL:你访问 Console/Sudo/API 的公网地址,例如 https://relay.yourdomain.com;
  • INSTANCE_DOMAIN:专用的实例域名,例如 mail.relay.yourdomain.com,用于 PTR、MX、实例 DKIM。把该子域的 NS 记录委派给 Relay 内置 DNS 服务器后,后续所有 DNS 记录都不用再手动管。

启动后执行 docker compose exec relay bin/console verify 可快速自检。之后按 Setup 指引把域名指过去即可(首登 OIDC 用户自动成为 Sudo 管理员)。

为发送域名添加 DKIM TXT 记录并完成验证的 DNS Record 界面

用 API 发送第一封 Email

部署完成后,在 Console → Projects 创建项目(选择 Transactional 或 Distributional),在 Domains 里添加你的发信域名并按提示添加一条 TXT 记录完成 DKIM 验证,再到 API 页面创建带 sends.send scope 的 API Key。

发信端点是 POST /api/console/sends,一次请求就能发出带附件的邮件:

curl -X POST https://relay.yourdomain.com/api/console/sends \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "no-reply@yourdomain.com",
    "to": "user@example.com",
    "subject": "Welcome",
    "body_html": "<h1>Hi, this is sent via your own Email API.</h1>"
  }'

在 Postman 中调用 Hyvor Relay Console API 发送邮件并返回 200 的截图

这个 API 有几个对生产环境很友好的设计:

  • 幂等性:请求头带 X-Idempotency-Key,24 小时内重试同一 key 不会重复发邮件;
  • 速率限制:默认每项目 10 请求/秒,触发 429 时按 Retry-After 重试;
  • 限额清晰:单封最多 20 个收件人、总体积 10MB、最多 10 个附件;
  • SMTP 兼容:如果你的应用更习惯 SMTP 发信,直接连 587 端口即可(SendEmailsSmtp.svelte/docs/content/SendEmailsSmtp.svelte))。

发信日志与 SMTP 对话回放

这大概是 Console 里最"开发者友好"的页面。每封邮件在 Console → Sends 中都有完整记录,包括发信概况和与收件方服务器逐条交互的 SMTP 对话原文(保留 30 天):

Sends 页面展示邮件状态 Accepted 以及完整的 SMTP 会话记录

从上图可以看到 EHLO、MAIL FROM、RCPT TO、DATA 每一步的响应码,排查送达率问题时不用再猜。配合 Webhook 回调(事件包括 send.recipient.accepted、bounced、complained、deferred 等),可以把发信状态实时同步回自己的业务系统。

Console 的整体效果如下,左侧是导航,中间是邮件列表与详情:

Hyvor Relay Console 用户控制台:项目、域名、Sends 日志与 API Key 管理界面

送达率:官方替你管了多少?

Email API 最难的从来不是发出去,而是进收件箱。官方在 Deliverability.svelte/hosting/content/deliverability/Deliverability.svelte) 中列了一张"谁负责什么"的清单:

  • Relay 自动处理:SPF、DKIM、FCrDNS、EHLO、STARTTLS、退信与抑制、DNS 记录自动化;
  • 需要你做:为每个发送 IP 配置 PTR 记录(在 Sudo → IPs 中完成,健康检查会盯着你,配错不会漏掉);
  • 需要收件域名所有者做:DMARC 记录。

Sudo → Health 页面每小时跑 7 项检查:PTR 正反解析、SPF 覆盖、队列有 IP、实例 DKIM 正确、NS 委派正确、无未读基础设施退信、IP 不在主流黑名单中。其中"基础设施退信"是专门识别你自己的发送 IP 被拒(比如被拉黑)的机制,会保留 30 天供管理员复盘,这比商业邮件服务只给你一个笼统的失败率要透明得多。

性能与扩展性

仓库内置了基于 k6 的压测脚本 benchmark/benchmark.js,用于对 /api/console/sends 做基准测试。扩展路径也很清晰:单机 Easy Deploy 不够用时,切到 deploy/prod/ 的多服务器 Docker Swarm 方案,添加服务器和 IP 即可水平扩容,PostgreSQL 可以是托管服务。

总结:它适合谁?

Hyvor Relay 的价值主张非常聚焦——把 Email API 的基础设施开源:

  • 适合:有 1~2 台自己服务器、希望掌控发信 IP 和送达率、邮件量可观想省计费成本、且团队能接受 OIDC 登录方式的项目和团队;
  • 不适合:想要开箱即用的模板编辑器、打开/点击统计、或完全不想碰运维的个人用户——这类需求商业服务仍然更省事。

从工程完成度看,它已经不是"能用"的水平:DNS 自动化、健康检查、退信分类、幂等 API、Webhook、Prometheus 监控这些生产级细节都考虑到了,代码结构(Symfony 后端 + Go Worker + SvelteKit 前端)也干净清晰。如果你正在评估"如何自建一套 Email API 替代 SES 或 SendGrid",Hyvor Relay 目前是最值得动手尝试的开源选项。

登录后查看全文
relay