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

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.2STARTTLS (端口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 | 无加密 | 不推荐使用|

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.1SSL/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.2Outlook/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，建议优先使用这种方式，因为它更安全且效率更高。

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

1. 简介

2. 安装

3. 基本配置

3.1 创建传输器