MBE 文档中心

邮件服务快速开始指南

5 分钟快速配置阿里云邮件推送

步骤 1：开通阿里云邮件推送（2 分钟）

  1. 访问 阿里云邮件推送控制台
  2. 点击 立即开通（免费版每天 200 封）

1.1 添加并验证域名（必须先完成）

在创建发信地址之前，需要先添加域名并完成验证：

  1. 进入 域名管理 页面
  2. 点击 新建域名，输入：mbe.hi-maker.com
  3. 添加后，状态显示为 "待验证"
  4. 点击域名查看验证详情，按照提示添加 DNS 记录：
    • CNAME 记录：用于域名所有权验证
    • SPF 记录：v=spf1 include:spf1.dm.aliyun.com include:spf2.dm.aliyun.com ~all
  5. 等待 5-30 分钟后，点击 验证 按钮
  6. 验证成功后，状态变为 "验证通过"

1.2 创建发信地址

位置说明：

  • 在控制台页面右侧，找到 "邮件推送控制台 | 发信地址" 面板
  • 在该面板的右上角，点击蓝色的 "新建发信地址" 按钮
  • 或者按照左下角"操作引导"中的第二步提示操作

填写信息：

  1. 点击 新建发信地址 按钮，弹出创建对话框

  2. 填写以下字段：

    ① 发信域名（必填，下拉选择）

    • 从下拉列表中选择您的域名
    • 如果您的发信地址是 noreply@mbe.hi-maker.com，通常选择 hi-maker.com 或 mbe.hi-maker.com
    • 如果下拉列表中没有您的域名，需要先在阿里云邮件推送中添加并验证域名

    ② 账号（必填，文本输入）

    • 输入：noreply
    • ⚠️ 重要提示：创建后不可修改，请谨慎输入
    • 说明：发信地址 = 账号 + @ + 域名
    • 最终发信地址将是：noreply@您选择的域名

    ③ 回信地址（可选）

    • 可以留空（推荐用于系统通知邮件）
    • 或者填写一个接收回复的邮箱，如：admin@hi-maker.com
    • 如果填写，可能需要验证该邮箱的所有权

    ④ 发信类型（必填，下拉选择）

    • 选择：触发邮件
    • 用于系统通知、验证码、密码重置等场景

  3. 点击右下角的蓝色 确定 按钮创建

  4. 创建成功后，在发信地址列表中找到刚创建的发信地址

  5. 点击 设置密码 或 重置密码，设置 SMTP 密码（重要：记住这个密码！稍后需要在 .env 文件中配置）

步骤 2：配置 DNS（2 分钟）

在 hi-maker.com 的 DNS 管理中添加：

类型 主机记录 记录值 说明
TXT @ v=spf1 include:spf1.dm.aliyun.com include:spf2.dm.aliyun.com ~all SPF 记录
TXT default._domainkey (从阿里云控制台复制) DKIM 记录
CNAME dm.mbe dm.aliyun.com 域名验证

注意： 如果使用 Cloudflare，确保所有记录的代理状态为 仅 DNS（灰色云朵）。

步骤 3：配置 MBE 系统（1 分钟）

编辑 .env 文件：

SMTP_HOST=smtpdm.aliyun.com
SMTP_PORT=465
SMTP_USE_TLS=true
SMTP_USER=noreply@mbe.hi-maker.com
SMTP_PASSWORD=你的SMTP密码
SMTP_FROM_EMAIL=noreply@mbe.hi-maker.com
SMTP_FROM_NAME=MBE系统

步骤 4：测试（1 分钟）

python scripts/test_email.py

输入您的测试邮箱，检查是否收到邮件。

✅ 完成！

现在您可以在代码中使用邮件服务了：

from src.services.email_service import email_service

# 发送验证码
email_service.send_verification_email("user@example.com", "123456")

遇到问题？