Nodemailer使用教程：在Node.js中发送电子邮件

1. 简介

2. 安装

3. 基本配置

3.1 创建传输器

3.2 配置说明

4. 发送邮件

4.1 基本发送示例

4.2 发送验证码示例

5. 常见问题解决

5.1 "Greeting never received" 错误

5.2 安全建议

SMTP与邮件加密协议详解

1. SMTP简介

1.1 基本特点

2. 加密协议对比

2.1 SSL/TLS (端口465)

2.2 STARTTLS (端口587)

3. 端口使用建议

3.1 常用端口对比

3.2 选择建议

4. 安全性考虑

4.1 SSL/TLS (465端口)优势

4.2 STARTTLS (587端口)注意事项

5. 常见邮件服务商配置

5.1 Gmail

5.2 Outlook/Office365

5.3 QQ邮箱

1. 简介

Nodemailer是Node.js平台上最流行的电子邮件发送库，它提供了一个简单而强大的解决方案，支持Unicode内容、HTML内容、附件、图片嵌入等功能。

2. 安装

首先需要安装Nodemailer包：

npm install nodemailer

3. 基本配置

3.1 创建传输器

首先需要创建一个传输器(transporter)，这是发送邮件的核心配置：

const nodemailer = require("nodemailer");const transporter = nodemailer.createTransport({host: "smtp.example.com",     // SMTP服务器地址port: 465,                    // SMTP端口secure: true,                 // 使用SSL/TLSauth: {user: "your-email@example.com",  // 邮箱账号pass: "your-password"            // 邮箱密码或应用专用密码}
});

3.2 配置说明

host: SMTP服务器地址

port: 常用端口

465 (SSL/TLS)
587 (STARTTLS)

secure:

true: 使用465端口
false: 使用其他端口

auth: 认证信息

4. 发送邮件

4.1 基本发送示例

async function sendEmail(to, subject, content) {const mailOptions = {from: '"发送者名称" <sender@example.com>',  // 发件人to: to,                                     // 收件人subject: subject,                           // 主题text: content,                             // 纯文本内容html: `<b>${content}</b>`                  // HTML内容};try {const info = await transporter.sendMail(mailOptions);console.log("邮件发送成功:", info.messageId);return info;} catch (error) {console.error("邮件发送失败:", error);throw error;}
}

4.2 发送验证码示例

以下是一个完整的发送验证码的实现：

const nodemailer = require("nodemailer");const transporter = nodemailer.createTransport({host: MAIL_HOST,    port: MAIL_PORT,    secure: true,       auth: {user: MAIL_USER,  pass: MAIL_PWD,   }
});const sendMail = async (to, subject, html) => {const mailOptions = {from: MAIL_USER,  // 发送者to,              // 接收者subject,         // 主题html,           // HTML内容};return await transporter.sendMail(mailOptions);
};

在控制器中使用：

async sendEmailCode(ctx, next) {const { email } = ctx.request.body;// 生成6位随机验证码const code = Math.random().toString().slice(2, 8);// 构建HTML模板const html = `<p>你好！</p><p>您正在注册社区账号</p><p>你的验证码是：<strong style="color: #ff4e2a;">${code}</strong></p><p>***该验证码5分钟内有效***</p>`;try {// 发送邮件await sendMail(email, "验证码", html);// 存储验证码（使用Redis）const emailCodeKey = `email:${email}`;await Redis.set(emailCodeKey, code, 60 * 5);ctx.body = {code: 0,message: "发送邮箱验证码成功",result: ""};} catch (error) {ctx.body = {code: -1,message: "发送邮箱验证码失败",error: error.message};}
}

5. 常见问题解决

5.1 "Greeting never received" 错误

如果遇到"Greeting never received"错误，通常有以下解决方案：

检查端口配置：

{port: 465,  // SSLsecure: true
}
// 或
{port: 587,  // STARTTLSsecure: false
}

检查网络连接

确认服务器设置是否正确

4. 验证认证信息是否正确

5.2 安全建议

使用环境变量存储敏感信息

启用SSL/TLS加密

使用应用专用密码而不是邮箱密码

设置合理的超时时间

SMTP与邮件加密协议详解

1. SMTP简介

SMTP (Simple Mail Transfer Protocol，简单邮件传输协议) 是一个在互联网上发送电子邮件的标准协议。

1.1 基本特点

默认使用25端口（未加密）

以纯文本形式传输数据

没有加密保护，容易被截获

2. 加密协议对比

2.1 SSL/TLS (端口465)

const transporter = nodemailer.createTransport({host: "smtp.example.com",port: 465,secure: true,  // 启用SSL/TLSauth: {user: "your-email@example.com",pass: "your-password"}
});

特点：

全程加密通信

连接建立时就启用加密

更安全，是推荐的加密方式

适用于现代邮件系统

工作流程：

客户端连接到服务器的465端口

立即建立SSL/TLS加密通道

所有后续通信都在加密通道中进行

2.2 STARTTLS (端口587)

const transporter = nodemailer.createTransport({host: "smtp.example.com",port: 587,secure: false,  // 使用STARTTLSauth: {user: "your-email@example.com",pass: "your-password"}
});

特点：

先以明文方式建立连接

通过STARTTLS命令升级为加密连接

向后兼容性更好

适用于一些旧的邮件系统

工作流程：

1. 客户端以明文方式连接到587端口

服务器告知支持STARTTLS

客户端发送STARTTLS命令

连接升级为加密连接

继续后续通信

3. 端口使用建议

3.1 常用端口对比

| 端口 | 协议 | 加密方式 | 建议 |

|------|------|----------|------|

| 25 | SMTP | 无加密 | 不推荐使用 |