如何启用发邮件功能

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.com	25 或 587	465

阿里云企业邮箱

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

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

服务器	端口（非 SSL）	端口（SSL）
smtp.mxhichina.com	25 或 587	465

阿里云个人邮箱

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

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

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

QQ 邮箱

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

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

服务器	端口（非 SSL）	端口（SSL）
smtp.qq.com	25 或 587	465

189 邮箱

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

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

服务器	端口（非 SSL）	端口（SSL）
smtp.189.cn	25 或 587	465

163 邮箱

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

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

服务器	端口（非 SSL）	端口（SSL）
smtp.163.com	25	465

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

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

自主集成

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

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

   如：/data/hap/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 挂载至 hap-community 容器内 /usr/local/MDPrivateDeployment/email/appextensions.json 路径。

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

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

4. 重启服务