前言注册验证码、密码重置、订单通知和系统告警看起来只是应用中的一个小功能真正调试起来却经常让人头疼。如果直接连接真实SMTP服务器测试邮件可能误发给用户频繁调试还会受到账号、授权码和发送额度限制。邮件没有送达时也很难判断问题究竟出在程序逻辑、SMTP配置还是邮件服务商本身。只看后台日志往往只能确认“程序尝试发送过”却看不到最终生成的邮件到底是什么样子。MailHog提供了一套专门面向开发和测试环境的解决方案。它会模拟一个SMTP服务器接收应用发来的所有邮件但不会真正投递到外部邮箱而是把发件人、收件人、主题、正文、附件和原始邮件头完整展示在网页中。开发人员可以反复测试而不必担心影响真实用户。本文将介绍MailHog在Windows、Linux、macOS和Docker环境中的部署方式并通过Python、Telnet和swaks发送测试邮件验证从应用发信到网页收件箱展示的完整流程。最后再借助cpolar为MailHog Web界面建立公网入口方便远程团队成员共同检查邮件模板和发送结果。这套方案适合本地开发、功能联调、演示环境和自动化测试。MailHog负责隔离真实邮件系统cpolar负责延伸查看入口两者配合后邮件调试就不再需要边测试边担心误发。1.什么是MailHog核心功能模拟SMTP服务器MailHog启动后会监听一个SMTP端口默认1025你的应用可以像连接真实邮件服务器一样连接它调用标准SMTP协议发信。Web界面实时查看邮件所有“发送”的邮件都会被MailHog捕获并展示在一个简洁的Web界面中默认端口8025包括发件人、收件人、主题、邮件正文HTML / 纯文本、附件、原始邮件头Headers无需配置、零依赖开箱即用不需要账号、密码、API Key或外部服务完全离线运行。支持多种部署方式可通过Docker、二进制文件、HomebrewmacOS等方式一键启动。典型使用场景开发阶段测试用户注册、找回密码、通知邮件等功能CI/CD流水线在自动化测试中验证邮件内容是否正确演示环境向客户展示邮件功能但不实际发送安全合规避免因测试误发邮件到真实用户邮箱注意MailHog不是生产级邮件服务器它仅用于开发和测试不能替代 SendGrid、Postfix、Amazon SES等真实邮件服务。安全与隐私所有邮件仅存储在本地内存中默认重启即清空不连接外网无数据泄露风险支持TLS/认证可选但通常开发环境无需开启开源信息GitHubhttps://github.com/mailhog/MailHogLicenseMIT免费商用语言Go编写跨平台支持Windows/macOS/Linux/ARMMailHog 本地SMTP服务器 邮件收件箱Web UI专为开发者打造的“邮件沙盒”。2.前提条件2.1ssh远程连接到极空间开启【SSH 服务】使用终端Windows PowerShell / Mac Terminal登录sshrootIP2.2验证docker是否开启使用命令docker-vsystemctl status-v3.在各种平台上部署MailHog3.1 Windows部署MailHog首先前往GitHub上的MailHog 发布页面下载适用于Windows的最新稳定版本。下载MailHog 后可以原样运行无需任何外部依赖。由于Windows版MailHog是一个简单的自可执行程序因此只需运行下载的 .exe 文件即可。下面是MailHog在Windows 10上的外观。现在您可以在 浏览器中访问localhost:8025或127.0.0.1:8025查看MailHog网页。3.2 Linux部署MailHog以下是Linux部署MailHog的方法sudoapt-get-yinstallgolang-gosudoapt-getinstallgitgoinstallgithub.com/mailhog/MailHog接下来你可以在终端中直接运行MailHog可执行文件来启动服务。具体路径取决于你的系统和Go环境配置。例如在Ubuntu系统中如果你使用的是默认的Go工作区设置编译后的可执行文件通常位于 ~/go/bin/ 目录下。你可以通过以下命令启动MailHog~/go/bin/MailHog现在您可以在 浏览器中访问ip:8025查看MailHog网页。3.3 MacOS部署MailHog苹果用户可以打开终端并运行以下命令brewinstallmailhog这将在macOS上安装MailHog。接下来你可以用以下命令启动mailhog如果你想让MailHog在登录时自动启动并作为后台服务运行可以运行以下命令brew services start mailhog现在您可以在 浏览器中访问localhost:8025或127.0.0.1:8025查看MailHog网页。3.4 Docker部署MailHog请确保您的计算机上安装了Docker。然后运行以下命令即可直接从Docker Hub启动MailHogdockerrun-d-p1025:1025-p7066:8025 mailhog/mailhog现在您可以在 浏览器中访问ip:7066查看MailHog网页。3.5 Docker Compose部署MailHog创建并编辑docker-compose.yml文件version:3services: mailhog: image: mailhog/mailhog:latest restart: always ports: -1025:1025 -8025:8025启动容器docker-composeup-d现在您可以在 浏览器中访问ip:7066查看MailHog网页。4.使用MailHog测试本地电子邮件4.1 用Python发SMTPpython3-c import smtplib s smtplib.SMTP(192.168.50.213, 1025) s.sendmail(atest.com, bmailhog.local, Subject: Test\n\nHi) s.quit() 您可以访问MailHog Web UI来验证电子邮件是否成功发送。4.2 使用telnet手动发邮件telnet192.168.50.2131025然后输入以下内容每行回车EHLO localhost MAIL FROM:kinstamailhog.localRCPT TO:testmailhog.localDATA From: Salmankinstamailhog.localTo: Testtestmailhog.localSubject: Hello, MailHog!Hey there, Missing you pig time. HogsKisses, Salman.QUIT您可以访问MailHog Web UI来验证电子邮件是否成功发送。4.3 用swaks强大的SMTP测试工具先安装swaks在Debian/Ubuntu上aptupdateaptinstallswaks-y然后发送swaks--totestmailhog.local\--fromkinstamailhog.local\--server192.168.50.213:1025\--bodyHey there, Missing you pig time.\--headerSubject: Hello, ceshichenggong!您可以访问MailHog Web UI来验证电子邮件是否成功发送。4.4 从另一个Docker容器比如PHP/Node.js应用。如果你正在开发一个Web应用只需配置它的SMTP设置为Host: 192.168.50.213Port: 1025No TLS / No Auth所有邮件都会被捕获到MailHog。在本地开发中MailHog是无数开发者调试邮件功能的“秘密武器”——它能捕获所有SMTP邮件并在Web界面中直观展示安全又高效。然而它的默认访问方式仅限于本机localhost:8025一旦你需要从手机或其他设备查看测试邮件让远程团队成员验证邮件模板在公网回调场景中接收通知……就会遇到一个现实问题如何把运行在内网的MailHog安全地暴露到公网这时cpolar就成了完美的解决方案。5.安装cpolar实现随时随地开发5.1 什么是cpolarcpolar是一款安全高效的内网穿透工具无需公网IP或复杂配置只需一条命令即可将本地服务器、Web服务或任意端口映射到公网让你随时随地远程访问内网应用特别适合开发调试、远程运维和应急部署等场景。5.2 部署cpolarcpolar可以将你本地电脑中的服务如SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudosystemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可打开浏览器访问本地9200端口使用cpolar账户密码登录即可,登录后即可对隧道进行管理。6.配置公网地址登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道隧道名称可自定义本例使用了:mailhog注意不要与已有的隧道名称重复协议http本地地址7066域名类型随机域名地区选择China Top打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址接下来就可以在其他电脑或者移动端设备异地)上使用地址访问。访问成功。7.保留固定公网地址使用cpolar为其配置二级子域名该地址为固定地址不会随机变化。点击左侧的预留选择保留二级子域名地区选择china Top然后设置一个二级子域名名称我使用的是mailhog大家可以自定义。填写备注信息点击保留。登录cpolar web UI管理界面点击左侧仪表盘的隧道管理——隧道列表找到所要配置的隧道点击右侧的编辑。修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名地区: China Top点击更新更新完成后打开在线隧道列表此时可以看到随机的公网地址已经发生变化地址名称也变成了保留和固定的二级子域名名称。最后我们使用固定的公网地址在任意设备的浏览器中访问可以看到成功访问的页面这样一个永久不会变化的二级子域名公网网址即设置好了。总结完成部署后应用只需要把SMTP地址指向MailHog的1025端口所有测试邮件就会被集中捕获并显示在Web界面中。开发人员可以直接检查主题、正文、HTML样式、附件和邮件头不必再依靠日志猜测发送结果。在本地环境中可以通过8025端口访问MailHog页面如果Docker映射为7066端口则使用对应的宿主机端口打开。配置cpolar后远程同事也能通过浏览器查看同一套测试邮件适合前后端联调、模板验收和异地协作。MailHog真正提高效率的地方不只是避免误发而是把邮件调试变得可见。代码是否调用成功、邮件内容是否完整、按钮链接是否正确、HTML布局是否异常都可以在一次发送后立即确认。需要注意的是MailHog只适用于开发与测试环境不能代替正式邮件服务器。生产系统仍然需要接入可靠的SMTP服务或邮件平台并配置认证、加密、发信域名和投递策略。当测试邮件与真实用户彻底隔离后开发人员才可以放心修改和反复验证。MailHog负责接住每一封测试邮件cpolar负责让团队随时查看邮件功能也就从“怕发错、难排查”变成一套可以稳定复现和验证的开发流程。