ZoneMTA 快速入门:10 分钟搭建你的第一个邮件中继

ZoneMTA 快速入门:10 分钟搭建你的第一个邮件中继【免费下载链接】zone-mta Modern outbound MTA cross platform and extendable server application项目地址: https://gitcode.com/gh_mirrors/zo/zone-mtaZoneMTA 是一款基于 Node.js 和 MongoDB 构建的现代出站邮件中继Outbound MTA/MSA服务器它开源、跨平台、可扩展被许多开发者用来搭建自己的邮件中继服务器。本文将带你用 10 分钟完成 ZoneMTA 邮件中继的快速入门从安装依赖、启动服务到成功发送第一封邮件全程无需编写复杂代码。ZoneMTA 是什么为什么用它搭建邮件中继ZoneMTA 专注于发件场景你的业务系统把邮件交给它它负责排队、路由、重试并以最优方式投递到对方邮箱服务器。它相当于一个高性能的邮件投递引擎而不是收件邮箱。特性说明 高性能连接池 多进程支持每天发送数百万封邮件 跨平台支持 Linux、macOS甚至 Windows 插件系统继承自 Nodemailer 生态可自定义路由、重写、过滤 Sending Zone不同信任级别的发件人走不同 IP 池精细化路由 内置 DKIM自动为外发邮件添加 DKIM 签名提升送达率 可观测内置 Prometheus 指标队列状态一目了然⚡ 大邮件友好全流式处理1KB 到 1GB 的邮件都不怕与常见的收件服务器不同ZoneMTA 是纯出站设计这使它更专注、更高效非常适合用来搭建公司内部的统一发件中继。搭建邮件中继前需要准备什么ZoneMTA 邮件中继的依赖非常轻量只需要三个组件依赖版本要求用途Node.jsv16运行环境MongoDB任意主流版本存储邮件队列GridFSRedis任意主流版本分布式锁与计数器、DNS 缓存 提示三者的默认连接地址都是本机127.0.0.1MongoDB 27017、Redis 6379本地开发时默认配置即可直接使用。10 分钟快速安装 ZoneMTA 邮件中继第 1 步克隆 ZoneMTA 仓库打开终端克隆项目并进入目录git clone https://gitcode.com/gh_mirrors/zo/zone-mta cd zone-mta第 2 步安装依赖npm install --production等待片刻即可完成整个过程不需要任何交互。第 3 步启动服务npm start看到终端打印出 ZoneMTA 的 ASCII Logo并出现类似SMTP feeder MTA server started listening on port 2525的日志就说明邮件中继已经成功启动 。如何验证邮件中继已经跑起来ZoneMTA 启动后会默认监听三个端口全部绑定在本机端口用途2525SMTP 中继入口接收业务系统提交的邮件12080HTTP API可用 JSON 或原始 RFC822 格式提交邮件12081内部数据通道用于主进程与投递子进程通信用一条命令即可确认 HTTP API 是否正常响应curl http://localhost:12080/counter/zone/default返回包含active和deferred计数的 JSON说明服务健康运行中。发送你的第一封邮件SMTP 方式ZoneMTA 默认在127.0.0.1:2525提供无需认证的 SMTP 中继入口。任何支持 SMTP 的邮件客户端或代码库把发件服务器指向它即可。以 Node.js 生态最常用的 Nodemailer 为例const nodemailer require(nodemailer); const transporter nodemailer.createTransport({ host: 127.0.0.1, port: 2525 }); await transporter.sendMail({ from: senderexample.com, to: friendexample.com, subject: Hello ZoneMTA, text: 我的第一封中继邮件 });邮件提交后即进入 MongoDB 队列由 ZoneMTA 自动完成 DNS 解析、连接对方 MX、投递与重试。通过 HTTP API 发送邮件更简单的第二种方式如果你的业务系统不想走 SMTP 协议ZoneMTA 还内置了 HTTP API直接 POST 一个 JSON 就能发信入口在 lib/api-server.jscurl -X POST http://localhost:12080/send \ -H Content-Type: application/json \ -d { from: senderexample.com, to: friendexample.com, subject: Hello ZoneMTA, text: 通过 HTTP API 发送 }返回 JSON 中带有队列 ID代表邮件已被接受。此外/send-raw端点还支持直接上传原始.eml格式的邮件内容灵活度更高。最实用的几个配置项所有默认配置都集中在 config/default.js业务部署时只需覆盖需要修改的部分。修改监听端口与绑定地址feeder接口的port和host决定 SMTP 入口api.port决定 HTTP API 端口全部可按需调整。Sending Zone用不同 IP 池精细化发送Sending Zone 是 ZoneMTA 的核心概念高信誉 IP 走快车道更多并发连接低信誉 IP 走慢车道。你可以在zones配置中为不同收件域名指定专属发送区相关逻辑见 lib/sending-zone.js。一键开启 DKIM 签名在 config/default.js 的plugins中启用core/dkim填好域名、选择器和私钥路径即可。ZoneMTA 会流式计算 body hash投递时自动为每封邮件签名大幅提升进入收件箱的概率。插件系统ZoneMTA 的插件机制继承自 Nodemailer 生态支持 SMTP 钩子、消息重写、内容分析等多种扩展点入口在 lib/plugins.js参考示例见 plugins/core/example-plugin.js。查看邮件队列与投递状态运维时最常用的几个查询接口# 查看 default 发送区的队列计数 curl http://localhost:12080/counter/zone/default # 查看排队中的前 1000 封邮件 curl http://localhost:12080/queued/active/default # 按队列 ID 查看单封邮件的详细状态 curl http://localhost:12080/message/队列ID同时ZoneMTA 会自动暴露/metrics端点供 Prometheus 采集包含投递成功/拒绝/延迟计数、队列大小、连接池大小等关键指标可以无缝接入 Grafana 监控大盘。常见问题FAQQ启动时报 MongoDB 连不上怎么办A确认本地 MongoDB 已启动且监听 27017 端口若是远程数据库修改 config/default.js 中dbs.mongo的连接字符串即可。Q邮件一直处于 deferred 状态A这是对方服务器暂时拒收如灰名单ZoneMTA 会自动退避重试也可通过/message/ID接口查看具体的拒绝原因。Q如何让外部服务器也能提交邮件A将feeder.host从127.0.0.1改为0.0.0.0并配置认证与 TLS建议配合 core/http-auth 插件使用。小结只需 Node.js、MongoDB、Redis 三个组件克隆仓库、安装依赖、启动服务你的邮件中继就搭建完成了——这整个过程确实只要 10 分钟。接下来你可以逐步探索 Sending Zone 多 IP 路由、DKIM 签名、IP 预热、退信处理等进阶能力把 ZoneMTA 打造成生产级的邮件投递基础设施。项目核心入口是 app.js配置模板在 config/default.js祝你的第一封中继邮件顺利送达 。【免费下载链接】zone-mta Modern outbound MTA cross platform and extendable server application项目地址: https://gitcode.com/gh_mirrors/zo/zone-mta创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考