Nodemailer使用教程：在Node.js中发送电子邮件
目录
5.1 "Greeting never received" 错误
1. 简介
Nodemailer是Node.js平台上最流行的电子邮件发送库，它提供了一个简单而强大的解决方案，支持Unicode内容、HTML内容、附件、图片嵌入等功能。
2. 安装
首先需要安装Nodemailer包：
npm install nodemailer3. 基本配置
3.1 创建传输器
首先需要创建一个传输器(transporter)，这是发送邮件的核心配置：
const nodemailer = require("nodemailer");
const transporter = nodemailer.createTransport({
host: "smtp.example.com", // SMTP服务器地址
port: 465, // SMTP端口
secure: true, // 使用SSL/TLS
auth: {
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, // SSL
secure: true
}
// 或
{
port: 587, // STARTTLS
secure: 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/TLS
auth: {
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, // 使用STARTTLS
auth: {
user: "your-email@example.com",
pass: "your-password"
}
});
特点：
- 先以明文方式建立连接
- 通过STARTTLS命令升级为加密连接
- 向后兼容性更好
- 适用于一些旧的邮件系统
工作流程：
1. 客户端以明文方式连接到587端口
- 服务器告知支持STARTTLS
- 客户端发送STARTTLS命令
- 连接升级为加密连接
- 继续后续通信
3. 端口使用建议
3.1 常用端口对比
| 端口 | 协议 | 加密方式 | 建议 |
|------|------|----------|------|
| 25 | SMTP | 无加密 | 不推荐使用 |
| 465 | SMTPS | SSL/TLS | 推荐使用 |
| 587 | SMTP | STARTTLS | 备选方案 |
3.2 选择建议
// 推荐配置（使用465端口）
const secureConfig = {
host: "smtp.example.com",
port: 465,
secure: true,
auth: {
user: "your-email@example.com",
pass: "your-password"
}
};
// 备选配置（使用587端口）
const starttlsConfig = {
host: "smtp.example.com",
port: 587,
secure: false,
requireTLS: true, // 强制要求TLS
auth: {
user: "your-email@example.com",
pass: "your-password"
}
};
4. 安全性考虑
4.1 SSL/TLS (465端口)优势
- 全程加密，无明文传输风险
- 连接建立更快
- 现代邮件服务器普遍支持
- 不存在降级攻击风险
4.2 STARTTLS (587端口)注意事项
- 初始连接为明文
- 可能受到降级攻击
- 需要额外的STARTTLS协商过程
- 配置时建议启用requireTLS选项
// STARTTLS的安全配置
const secureStartTLS = {
host: "smtp.example.com",
port: 587,
secure: false,
requireTLS: true,
tls: {
rejectUnauthorized: true, // 验证服务器证书
minVersion: "TLSv1.2" // 最低TLS版本
}
};5. 常见邮件服务商配置
5.1 Gmail
{
host: "smtp.gmail.com",
port: 465,
secure: true
}5.2 Outlook/Office365
{
host: "smtp.office365.com",
port: 587,
secure: false,
requireTLS: true
}5.3 QQ邮箱
{
host: "smtp.qq.com",
port: 465,
secure: true
}通过了解这些区别，你可以根据具体需求选择合适的配置。一般情况下，如果邮件服务器支持465端口的SSL/TLS，建议优先使用这种方式，因为它更安全且效率更高。
原文地址：https://blog.csdn.net/qq_63358859/article/details/144064482
免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！