跳到主要内容

如何启用发邮件功能

SMTP 服务器配置​

通过右上角头像下拉列表的 系统配置 > 集成 > 邮件服务：

常用的 SMTP 服务器配置​

注意：如果使用 25 端口，有些服务器可能需要对 25 端口进行解封

腾讯企业邮箱​

管理员开启用来配置邮件发送的邮箱 POP/SMTP/IMAP 功能，参考：https://work.weixin.qq.com/help?person_id=1&doc_id=277&helpType=exmail

使用企业邮箱账号和密码配置邮件服务，发送邮箱和账号一致即可

服务器端口（非 SSL）端口（SSL）
smtp.exmail.qq.com25 或 587465

阿里云企业邮箱​

管理员开启用来配置邮件发送的邮箱 POP/SMTP/IMAP 功能

使用企业邮箱账号和密码配置邮件服务，发送邮箱和账号一致即可

服务器端口（非 SSL）端口（SSL）
smtp.mxhichina.com25 或 587465

阿里云个人邮箱​

开启用来配置邮件发送的邮箱 POP/SMTP/IMAP 功能

使用邮箱账号和密码配置邮件服务，发送邮箱和账号一致即可

|服务器|端口（非 SSL）|端口（SSL）| |:---:----|:---:----|:---:----| |smtp.aliyun.com|25|465|

QQ 邮箱​

开启用来配置邮件发送的邮箱 POP/SMTP/IMAP 功能

使用邮箱账号和授权码（非邮箱密码） 配置邮件服务，发送邮箱和账号一致即可

服务器端口（非 SSL）端口（SSL）
smtp.qq.com25 或 587465

189 邮箱​

开启用来配置邮件发送的邮箱 POP/SMTP/IMAP 功能

使用邮箱账号和密码配置邮件服务，发送邮箱和账号一致即可

服务器端口（非 SSL）端口（SSL）
smtp.189.cn25 或 587465

163 邮箱​

开启用来配置邮件发送的邮箱 POP/SMTP/IMAP 功能

使用邮箱账号（只需@前面的部分）和授权码（非邮箱密码）配置邮件服务，发送邮箱和账号一致即可

服务器端口（非 SSL）端口（SSL）
smtp.163.com25465

如果邮件发送失败，请通过以下命令检查连通性是否正常

docker exec -it $(docker ps | grep community | awk '{print $1}') bash -c 'nc -vz 服务器 端口'

自主集成​

另外也支持配置 Webhook 地址接收邮件内容，然后自主实现邮件发送功能。

  1. 在服务器中创建配置文件 appextensions.json

    如：/data/mingdao/script/volume/email/appextensions.json：

    {
      "WebhookUrl": "https://api.yourdomain.com/email/webhook",
      "WebhookHeaders": {}
    }

    配置参数说明：

    • WebhookUrl：必填，接收邮件消息的API接口地址。
    • WebhookHeaders：可选，自定义请求头，用于身份验证等用途。

  2. 消息体规范

    HAP 通过 POST 方式，以 application/json 格式向 WebhookUrl 发送 JSON 数据，消息体格式如下：

    {
      "ToEmails": ["email1","email2"], // 接收者邮箱列表
      "ReplyToEmails":  ["email1","email2"], // 默认回复给的邮箱列表
      "CcEmails":  ["email1","email2"], // 抄送的邮箱列表
      "BccEmails": ["email1","email2"], // 密送的邮箱列表
      "Signature": "签名", // 发送者名称
      "Subject": "邮件主题",
      "Body": "邮件内容", // html 格式
      "Attachments": { "附件名1": "附件下载地址1", "附件名2": "附件下载地址1" }
    }

  3. 将配置文件 appextensions.json 挂载至 mingdaoyun-community 容器内 /usr/local/MDPrivateDeployment/email/appextensions.json 路径。

    在微服务应用对应的 docker-compose.yaml 文件 app 服务下 volumes 中增加：

    - ./volume/email/appextensions.json:/usr/local/MDPrivateDeployment/email/appextensions.json

  4. 重启服务