邮件功能不敢直接发给真实用户？用MailHog搭建安全测试收件箱

fruge365

发布于 2026-07-03 08:47:15

430

前言

注册验证码、密码重置、订单通知和系统告警，看起来只是应用中的一个小功能，真正调试起来却经常让人头疼。

如果直接连接真实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、二进制文件、Homebrew（macOS）等方式一键启动。

典型使用场景

开发阶段：测试用户注册、找回密码、通知邮件等功能
CI/CD流水线：在自动化测试中验证邮件内容是否正确
演示环境：向客户展示邮件功能，但不实际发送
安全合规：避免因测试误发邮件到真实用户邮箱
注意：MailHog不是生产级邮件服务器！它仅用于开发和测试，不能替代 SendGrid、Postfix、Amazon SES等真实邮件服务。

安全与隐私

所有邮件仅存储在本地内存中（默认），重启即清空
不连接外网，无数据泄露风险
支持TLS/认证（可选），但通常开发环境无需开启

开源信息

GitHub：https://github.com/mailhog/MailHog
License：MIT（免费商用）
语言：Go编写，跨平台支持（Windows/macOS/Linux/ARM）

MailHog = 本地SMTP服务器 + 邮件收件箱Web UI，专为开发者打造的“邮件沙盒”。

2.前提条件

2.1ssh远程连接到极空间

开启【SSH 服务】
使用终端（Windows PowerShell / Mac Terminal）登录：

ssh root@IP

2.2验证docker是否开启

使用命令：

docker -v 
systemctl status -v

3.在各种平台上部署MailHog

3.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的方法：

sudo apt-get -y install golang-go
sudo apt-get install git
go install github.com/mailhog/MailHog

接下来，你可以在终端中直接运行MailHog可执行文件来启动服务。具体路径取决于你的系统和Go环境配置。

例如，在Ubuntu系统中，如果你使用的是默认的Go工作区设置，编译后的可执行文件通常位于 ~/go/bin/ 目录下。你可以通过以下命令启动MailHog：

~/go/bin/MailHog

现在，您可以在浏览器中访问ip:8025，查看MailHog网页。

3.3 MacOS部署MailHog

苹果用户可以打开终端并运行以下命令：

brew install mailhog

这将在macOS上安装MailHog。接下来，你可以用以下命令启动：

mailhog

如果你想让MailHog在登录时自动启动并作为后台服务运行，可以运行以下命令：

brew services start mailhog

现在，您可以在浏览器中访问localhost:8025或127.0.0.1:8025，查看MailHog网页。

3.4 Docker部署MailHog

请确保您的计算机上安装了Docker。然后，运行以下命令即可直接从Docker Hub启动MailHog：

docker run -d -p 1025:1025 -p 7066:8025 mailhog/mailhog

现在，您可以在浏览器中访问ip:7066，查看MailHog网页。

3.5 Docker Compose部署MailHog

创建并编辑 docker-compose.yml文件：

version: "3"
services:
mailhog:
image: mailhog/mailhog:latest
restart: always
ports:
- 1025:1025
- 8025:8025

启动容器：

docker-compose up -d

现在，您可以在浏览器中访问ip:7066，查看MailHog网页。

4.使用MailHog测试本地电子邮件

4.1 用Python发SMTP

python3 -c "
import smtplib
s = smtplib.SMTP('192.168.50.213', 1025)
s.sendmail('a@test.com', 'b@mailhog.local', 'Subject: Test\n\nHi')
s.quit()
"

您可以访问MailHog Web UI来验证电子邮件是否成功发送。

4.2 使用telnet手动发邮件

telnet 192.168.50.213 1025

然后输入以下内容（每行回车）：

EHLO localhost
MAIL FROM:<kinsta@mailhog.local>
RCPT TO:<test@mailhog.local>
DATA
From: Salman <kinsta@mailhog.local>
To: Test <test@mailhog.local>
Subject: Hello, MailHog!

Hey there,
Missing you pig time.
Hogs & Kisses,
Salman
.
QUIT

您可以访问MailHog Web UI来验证电子邮件是否成功发送。

4.3 用swaks

强大的SMTP测试工具，先安装swaks（在Debian/Ubuntu上）：

apt update && apt install swaks -y

然后发送：

swaks --to test@mailhog.local \
      --from kinsta@mailhog.local \
      --server 192.168.50.213:1025 \
      --body "Hey there, Missing you pig time." \
      --header "Subject: Hello, ceshichenggong!"