Nodemailer là một module Node.js cho phép bạn gửi email từ máy chủ một cách dễ dàng. Cho dù bạn muốn giao tiếp với người dùng hay chỉ thông báo cho mình khi có sự cố, email là một lựa chọn phổ biến.
Có nhiều bài viết hướng dẫn sử dụng Nodemailer ở dạng cơ bản, nhưng bài này không phải. Ở đây tôi sẽ trình bày cách phổ biến nhất để gửi email từ backend Node.js bằng Nodemailer và Gmail.
Bắt đầu với Nodemailer
Trước tiên, thiết lập boilerplate Node.js với Express. Kiểm tra Node và npm đã cài đặt:
node -v npm -vNếu cả hai hiển thị phiên bản, bạn đã sẵn sàng. Nếu không, hãy cài đặt phần còn thiếu.
Tạo thư mục dự án, ví dụ nodemailerProject:
mkdir nodemailerProjectVào thư mục và chạy:
npm initĐiều này khởi tạo file package.json.
Cài đặt Express:
npm install expressMở file entry point (mặc định index.js) và dán mã sau:
const express = require('express')
const app = express()
const port = 3000
app.listen(port, () => {
console.log(`nodemailerProject is listening at https://localhost:${port}`)
})Chạy máy chủ:
node index.jsCài đặt Nodemailer
Cài đặt Nodemailer:
npm install nodemailerAPI của Nodemailer khá đơn giản, yêu cầu:
- Tạo đối tượng Transporter
- Tạo đối tượng MailOptions
- Sử dụng phương thức Transporter.sendMail
Tạo transporter object:
let transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
type: 'OAuth2',
user: process.env.MAIL_USERNAME,
pass: process.env.MAIL_PASSWORD,
clientId: process.env.OAUTH_CLIENTID,
clientSecret: process.env.OAUTH_CLIENT_SECRET,
refreshToken: process.env.OAUTH_REFRESH_TOKEN
}
});✋ Lưu ý: ngoài user và pass (thông tin đăng nhập Gmail của bạn), ba khóa còn lại cần lấy sau khi thiết lập OAuth.
Gmail có mức bảo mật cao. Có nhiều cách khắc phục, chúng ta chọn cách thiết lập dự án trên Google Cloud Platform để có thông tin xác thực OAuth.
Đọc thêm về phức tạp khi dùng Gmail với Nodemailer tại đây.
Cấu hình Google Cloud Platform
Nếu chưa có tài khoản GCP, hãy tạo. Tạo dự án mới từ menu góc trên bên trái.

Chọn "New Project":

Đặt tên dự án (ví dụ: NodemailerProject), vị trí để "No organization".

Sau vài giây, bạn sẽ thấy màn hình:

Mở menu điều hướng (ba gạch ngang góc trên trái) và chọn APIs and Services:

Để dùng Nodemailer với Gmail, cần OAuth2. Nếu không quen, OAuth là giao thức xác thực. Tôi không đi sâu vào chi tiết, nhưng bạn có thể đọc thêm tại đây.
Đầu tiên, cấu hình OAuth Consent Screen:

Nếu không phải thành viên G-Suite, chỉ có tùy chọn "External" cho User Type.

Sau khi tạo, điền thông tin ứng dụng (máy chủ của bạn):

Điền email của bạn vào "User support email" và "Developer contact information". Nhấn "Save and Continue" đến phần Scopes. Bỏ qua phần này, chuyển sang Test Users.

Thêm bản thân làm user và nhấn "Save and continue".
Cấu hình OAuth Settings
Tạo OAuth credentials cho Nodemailer. Vào tab Credentials, nhấn dấu cộng (➕) "Create Credentials" và chọn OAuth Client ID.

Chọn "Web Application":

Trong "Authorized Redirect URIs", thêm OAuth2 Playground (https://developers.google.com/oauthplayground) để lấy refresh token.

Sau khi tạo, bạn nhận được client id và client secret. Giữ bí mật, không bao giờ công khai.

Lấy OAuth Refresh Token
Vào OAuth2 Playground. Chúng ta đã phê duyệt URI này trước đó.
- Nhấn biểu tượng bánh răng (OAuth2 Configuration), tích "Use your own OAuth2 credentials":

- Bên trái, cuộn xuống chọn Gmail API v1:

- Nhấn Authorize APIs.
- Đăng nhập Gmail (chọn tài khoản đã thêm làm Test user).
- Màn hình cảnh báo ứng dụng chưa được Google xác minh. Nhấn Continue.

- Cấp quyền cho dự án truy cập Gmail.

- Quay lại OAuth Playground, thấy authorization code bên trái. Nhấn nút xanh Exchange authorization code for tokens.
Các trường refresh token và access token sẽ được điền.
Quay lại máy chủ
Sau cấu hình, nhập dữ liệu vào transporter. Dùng package dotenv để bảo mật credentials, nhớ thêm .env vào .gitignore.
let transporter = nodemailer.createTransport({
service: 'gmail',
auth: {
type: 'OAuth2',
user: process.env.MAIL_USERNAME,
pass: process.env.MAIL_PASSWORD,
clientId: process.env.OAUTH_CLIENTID,
clientSecret: process.env.OAUTH_CLIENT_SECRET,
refreshToken: process.env.OAUTH_REFRESH_TOKEN
}
});Tạo mailOptions object:
let mailOptions = {
from: 'your-email@gmail.com',
to: 'recipient@gmail.com',
subject: 'Nodemailer Project',
text: 'Hi from your nodemailer project'
};Object này có thể có nhiều trường và nhiều người nhận hơn, nhưng không đi sâu ở đây.
Gửi email:
transporter.sendMail(mailOptions, function(err, data) {
if (err) {
console.log("Error " + err);
} else {
console.log("Email sent successfully");
}
});Chạy ứng dụng, bạn sẽ thấy email mới trong hộp thư đến.
Bài viết lấy cảm hứng từ dự án tôi dùng Nodemailer. Xem thêm tại đây.