Skip to content

邮件发送配置

DJAOD 使用 SMTP 协议发送邮件,支持发送验证码、通知提醒等邮件。本章以 QQ 邮箱 SMTP 服务为例,介绍从获取 SMTP 配置到 DJAOD 后台填写的完整流程。其他邮箱(163、Gmail、企业微信等)配置方式类似。

QQ邮箱 SMTP 配置获取

1. 登录QQ邮箱

打开 https://mail.qq.com,使用你的 QQ 账号登录。

2. 开启SMTP服务

点击顶部 设置账号,找到 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务 一栏:

  • 开启 SMTP服务(或同时开启 IMAP/SMTP服务
  • 点击 生成授权码,按照提示发送短信验证
  • 授权码生成后 务必复制保存,后续配置密码处使用

注意:此处的授权码即 SMTP 密码,切勿使用 QQ 邮箱的登录密码,否则会报错。

3. 记录SMTP参数

参数
SMTP 服务器地址smtp.qq.com
SMTP 端口(SSL)465
SMTP 端口(TLS)587
发件人邮箱地址你的 QQ 邮箱地址(如 123456789@qq.com
SMTP 密码上一步生成的授权码

常见邮箱SMTP配置速查

邮箱SMTP服务器SSL端口TLS端口
QQ邮箱smtp.qq.com465587
163邮箱smtp.163.com465587
126邮箱smtp.126.com465587
企业微信邮箱smtp.exmail.qq.com465587
Gmailsmtp.gmail.com465587
Outlooksmtp-mail.outlook.com465587

使用非 QQ 邮箱时,同样需要开启 SMTP 服务并获取授权码(或专用密码)。

DJAOD后台配置

登录 DJAOD 后台,进入 系统设置邮件配置,依次填写:

配置项说明
邮件驱动选择 SMTP
SMTP 服务器smtp.qq.com
SMTP 端口SSL 使用 465,TLS 使用 587
加密方式推荐选择 SSL
发件人邮箱你的 QQ 邮箱地址
发件人名称自定义,如 DJAOD(收件人看到发件人显示为此名称)
SMTP 密码QQ 邮箱生成的 授权码(非登录密码)

填写完成后,点击 发送测试邮件 按钮,输入测试邮箱地址,验证配置是否正确。

测试与排错

常见问题

问题原因与解决
535 Authentication failed授权码错误,重新生成授权码
Connection timed out服务器防火墙阻止了 SMTP 端口,检查安全组出站规则
SSL handshake failed加密方式不匹配,尝试切换 SSL/TLS
550 Mail content denied邮件内容被拦截,检查模板内容是否合规

测试连接

配置完成后,建议在 系统设置 → 邮件配置 页面点击 发送测试邮件,验证整条链路是否正常。测试成功则说明配置完成,用户注册/找回密码等场景即可正常发送邮件。

Released under the MIT License.