maildev/maildev 是什么？

MailDev 是一个本地 SMTP 服务器加 Web 界面，用于在开发时捕获和查看应用生成的邮件。3.0 版本是完整重写，但仍是候选版，本文基于仓库资料说明其用法、限制和适用场景。

maildev/maildev 可以商用吗？

可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。

maildev/maildev 还在维护吗？

在维护。仓库最近一次提交在 4 天前。

maildev/maildev 是用什么编程语言写的？

主要是 TypeScript（依据 GitHub 的语言统计）。

MailDev 3.0 评测：本地 SMTP 邮件测试工具的功能与限制

Q: maildev/maildev 还在维护吗？

在维护。仓库最近一次提交在 4 天前。

秒懂

它是什么？: MailDev 是一个本地 SMTP 服务器加 Web 界面，用于在开发时捕获和查看应用生成的邮件。3.0 版本是完整重写，但仍是候选版，本文基于仓库资料说明其用法、限制和适用场景。
适合谁用？: MailDev 适合需要在本地快速捕获和检查应用邮件的开发者，尤其是使用 Node.js 或 Docker 的团队。它不适合作为生产邮件服务器，也不适合需要复杂邮件路由的场景。
能商用吗？: 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
还在维护吗？: 在维护。仓库最近一次提交在 4 天前。
用什么语言写的？: 主要是 TypeScript（依据 GitHub 的语言统计）。

以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。

开源项目深度解析

Hysen Labs 编辑部 · 2026年8月4日 · maildev/maildev

它解决什么问题：开发时邮件查看的痛点

开发应用时，你常常需要确认发出的邮件内容是否正确。直接连真实 SMTP 服务器既慢又可能误发。MailDev 在本地启动一个 SMTP 服务器，所有发往它的邮件都被捕获，并通过 Web 界面展示。你不需要配置外部服务，也不需要清理邮箱。它面向的是开发者和测试人员，而不是运维或最终用户。仓库 README 明确说，它是用来测试项目生成的邮件的。这个定位很窄，但很实用。

工作机制：SMTP 捕获加 Web 展示

MailDev 的架构分为两部分：一个 SMTP 服务和一个 HTTP 服务。默认情况下，SMTP 服务监听 1025 端口，HTTP 服务监听 1080 端口。你的应用把邮件发送到本地 1025 端口，MailDev 接收并存储，然后 Web 界面读取并显示。邮件可以持久化到磁盘，通过 `--mail-directory` 指定目录。默认不限制邮件数量，但你可以用 `--max-emails` 设置上限，超过后最旧的邮件会被删除，包括 `.eml` 文件和附件。启动时，已有目录中的邮件也会被修剪到上限。这个机制保证了存储有界，但意味着你无法保留所有历史邮件。

启动方式：命令行与 Docker 两种路径

安装很简单，`npm install -g maildev` 全局安装。然后直接运行 `maildev` 即可。Docker 用户可以用 `docker run -p 1080:1080 -p 1025:1025 maildev/maildev`，端口映射与默认配置一致。所有选项都支持环境变量覆盖，例如 `MAILDEV_SMTP_PORT` 对应 `--smtp`。配置可以通过 `--config <file>` 指定文件，但 README 没有给出文件格式示例。启动后，打开 `http://localhost:1080` 就能看到收到的邮件。

关键配置项：端口、认证与安全

`--smtp` 和 `--web` 控制端口。`--ip` 和 `--web-ip` 控制绑定地址，默认 SMTP 绑定 `::`，HTTP 绑定 `0.0.0.0`。如果你只想本机访问，需要显式设置。SMTP 可以启用认证，通过 `--incoming-user` 和 `--incoming-pass`。HTTP 界面也可以加密码，用 `--web-user` 和 `--web-pass`。HTTPS 支持需要 `--https-key` 和 `--https-cert`，但你必须自己提供证书文件。`--max-message-size` 默认 50 MB，超过的邮件会被拒绝。这些选项覆盖了基本的安全需求，但证书管理需要额外工作。

高级功能：自动转发与 MCP 集成

MailDev 支持 `--auto-relay`，可以把收到的邮件转发到真实 SMTP 服务器。配合 `--outgoing-host`、`--outgoing-port` 等选项，你可以搭建一个测试环境，让部分邮件进入真实发送流程。`--auto-relay-rules` 允许定义过滤规则，但 README 没有提供规则语法。另一个新特性是 `--mcp`，启用 MCP 服务器供 Claude 集成。这意味着你可以在 AI 工具中查询收到的邮件，但具体用法没有文档说明。这些功能增加了灵活性，但文档的缺失会让实际使用变得困难。

限制与失败模式：候选版的重写风险

MailDev 3.0 是完整重写，但当前是候选版，README 明确提示如果遇到问题请安装 v2。这意味着 3.0 可能存在未发现的 bug。存储限制是双刃剑：`--max-emails 0` 会无限积累邮件，可能耗尽磁盘；设置正数则会静默丢弃最旧的邮件，你可能丢失重要测试记录。另外，`--incoming-secure` 需要你提供证书，如果证书路径错误，SMTP 服务可能无法启动。自动转发如果配置不当，可能把测试邮件发送给真实用户。这些都是实际风险，需要在采用前评估。

替代方案：与 MailHog 的差异

一个常见的替代工具是 MailHog。MailHog 也提供本地 SMTP 捕获和 Web 界面，但它的存储和 API 设计不同。MailHog 默认将邮件存储在内存中，重启后丢失，而 MailDev 支持持久化到目录。MailHog 的 API 基于 JSON，而 MailDev 的 Web 界面更偏向人工查看。如果你需要跨重启保留邮件，MailDev 的 `--mail-directory` 是优势。如果你只需要临时查看，MailHog 更轻量。选择取决于你对持久化的需求。

维护与升级成本：许可证与版本策略

MailDev 使用 MIT 许可证，你可以自由使用和修改。项目最近一次提交在 2026 年 8 月，3.0 候选版仍在活跃开发。v2.2.1 是最后一个稳定版，发布于 2024 年 12 月。如果你在生产环境使用，建议停留在 v2，直到 3.0 正式发布。升级到 3.0 需要重新验证所有配置项，因为重写可能改变行为。持久化目录的格式也可能变化，升级前需要备份。总体而言，维护成本取决于你是否跟随候选版更新。

编辑结论

MailDev 适合需要在本地快速捕获和检查应用邮件的开发者，尤其是使用 Node.js 或 Docker 的团队。它不适合作为生产邮件服务器，也不适合需要复杂邮件路由的场景。若你依赖 v2 的稳定行为，应等待 3.0 正式版，或继续使用 v2.2.1。若你尝试 3.0 候选版，先验证双向转发、TLS 证书和持久化目录在真实负载下的表现，并注意 `--max-emails` 的修剪行为是否符合你的保留策略。最终判断：MailDev 3.0 的重写带来了更清晰的配置和 MCP 集成，但候选版状态意味着你必须在稳定性上做取舍。

官方来源

社区笔记