Ở bài trước MiniBlog đã có bộ test, nhưng vẫn chỉ chạy trên máy của mình. Bài cuối của series, mình sẽ hướng dẫn mọi người deploy ứng dụng Express lên server: PM2, Nginx, HTTPS và graceful shutdown.
1. Chuẩn bị server.
Mình dùng VPS Ubuntu 26.04 LTS, tên miền miniblog.example.com đã trỏ về IP của server, user deploy để SSH. Nginx và MySQL 8.4 cài từ kho của Ubuntu, kho chỉ có Node.js 22 nên các bạn cài Node.js 24 theo nodejs.org:
sudo apt update
sudo apt install -y nginx mysql-server git
sudo mysql -e "CREATE DATABASE miniblog; CREATE USER 'miniblog'@'localhost' IDENTIFIED BY 'mat-khau-that-manh';
GRANT ALL ON miniblog.* TO 'miniblog'@'localhost'"
MySQL cài từ apt chỉ nghe ở 127.0.0.1 (dòng bind-address trong /etc/mysql/mysql.conf.d/mysqld.cnf). Đừng đổi thành 0.0.0.0 hay mở cổng 3306 ra internet.
Bật tường lửa, chỉ mở SSH, 80 và 443:
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
Cổng 3000 của MiniBlog chỉ dành cho Nginx: khi bật trust proxy (phần 2), ai gọi thẳng vào đó đều tự ghi được X-Forwarded-For và vượt qua giới hạn đăng nhập, giới hạn request.
Lấy code về, cài package và tạo bảng:
sudo mkdir -p /var/www/miniblog
sudo chown deploy:deploy /var/www/miniblog
git clone https://github.com/ten-cua-ban/miniblog.git /var/www/miniblog
cd /var/www/miniblog
npm ci --omit=dev
cp .env.example .env
chmod 600 .env
# sửa .env như phần 2 rồi mới chạy
npm run db:migrate
npm ci cài đúng phiên bản trong package-lock.json, bỏ package dev. Mỗi lần cập nhật code đều chạy lại npm run db:migrate (Bài 14), không chạy db:seed vì nó xoá hết bài viết.
2. Cấu hình production.
Các giá trị cần đổi trong .env:
DB_HOST=127.0.0.1
DB_PASSWORD=mat-khau-that-manh
# Hai chuỗi ngẫu nhiên mới, tạo bằng lệnh ghi trong .env.example
SESSION_SECRET=...
JWT_SECRET=...
APP_URL=https://miniblog.example.com
CORS_ORIGIN=https://app.example.com
SMTP_HOST=smtp.nha-cung-cap.com
SMTP_PORT=587
SMTP_USER=...
SMTP_PASS=...
MAIL_FROM="MiniBlog <[email protected]>"
NODE_ENV vẫn không ghi vào .env (Bài 23) mà đặt trong cấu hình PM2 ở phần 4. Nó bật cache view, ẩn chi tiết lỗi (Bài 7), bật secure cho cookie session (Bài 15) và mức log info.
Đứng sau Nginx, Express chỉ thấy IP của Nginx và kết nối HTTP thường: cookie secure không được đặt (không đăng nhập được), còn bộ đếm đăng nhập sai (Bài 16) và giới hạn request (Bài 17) coi mọi người là một. Thêm vào app.js, ngay sau const app = express();:
- app.js (trích, xem cả file)
// Production chạy sau Nginx: tin 1 proxy đứng trước để req.ip, req.secure lấy từ header X-Forwarded-*
if (app.get('env') === 'production') {
app.set('trust proxy', 1);
}
Số 1 là chỉ tin một proxy: req.ip lấy địa chỉ cuối trong X-Forwarded-For (do Nginx thêm), req.secure lấy từ X-Forwarded-Proto. Ngoài tường lửa, server.js chỉ nghe ở 127.0.0.1 (biến HOST, để trống là mặc định):
- lib/env.js (đoạn thêm, export đặt cuối file)
import { isIP } from 'node:net';
if (env.HOST && !isIP(env.HOST)) {
errors.push('HOST phải là địa chỉ IP, VD: 127.0.0.1 hoặc 0.0.0.0');
}
// Production chạy sau Nginx nên mặc định chỉ nghe 127.0.0.1, development nghe mọi địa chỉ
export const host = env.HOST || (nodeEnv === 'production' ? '127.0.0.1' : undefined);
3. Graceful shutdown.
Khi restart hay deploy, process cũ nhận tín hiệu dừng. Graceful shutdown là ngừng nhận request mới, xử lý nốt request đang chạy, đóng kết nối rồi mới thoát. Mình export session store để đóng được:
- middlewares/session.js (đoạn thay đổi)
export const sessionStore = new MySQLStore({
createDatabaseTable: false,
endConnectionOnClose: false, // store.close() không đóng pool, server.js tự đóng
}, pool);
// trong session({ ... }): thay store, bằng
store: sessionStore,
import app from './app.js';
import pool from './lib/db.js';
import logger from './lib/logger.js';
import { host } from './lib/env.js';
import { sessionStore } from './middlewares/session.js';
const port = process.env.PORT || 3000;
// Kiểm tra kết nối MySQL trước khi nhận request, lỗi thì dừng chương trình
await pool.query('SELECT 1');
const server = app.listen(port, host, (error) => {
if (error) {
throw error;
}
logger.info(`MiniBlog đang chạy tại http://localhost:${port}`);
});
// Graceful shutdown: ngừng nhận request mới, xử lý nốt request đang chạy rồi mới đóng kết nối
function shutdown(signal) {
logger.info(`Nhận ${signal}, đang dừng MiniBlog...`);
server.close(async () => {
await sessionStore.close(); // dừng timer dọn session
await pool.end(); // đóng các kết nối MySQL
process.exit(0); // thoát hẳn, process do PM2 cluster tạo không tự thoát
});
}
// PM2 dừng app bằng SIGINT, Docker và systemd bằng SIGTERM
process.once('SIGINT', shutdown);
process.once('SIGTERM', shutdown);
server.close() chờ các request đang xử lý xong mới gọi callback. Chạy npm run start rồi bấm Ctrl+C, server ghi log Nhận SIGINT, đang dừng MiniBlog... rồi thoát.
4. Chạy MiniBlog bằng PM2.
Đóng terminal SSH là npm run start dừng theo. PM2 (bản 7.1.2) giữ app chạy nền, tự bật lại khi bị crash hay server khởi động lại:
// Cấu hình PM2: pm2 start ecosystem.config.cjs
module.exports = {
apps: [
{
name: 'miniblog',
script: 'server.js',
node_args: '--env-file=.env', // đọc .env như npm run start
env: { NODE_ENV: 'production' }, // đặt khi chạy, không ghi vào .env
exec_mode: 'cluster', // chạy nhiều process, dùng chung cổng 3000
instances: 2,
kill_timeout: 10000, // chờ tối đa 10 giây cho graceful shutdown
},
],
};
Đuôi .cjs vì project là ESM ("type": "module") mà file cấu hình dùng module.exports. Mặc định PM2 chỉ chờ 1,6 giây rồi kill. Cài và chạy:
npm install -g pm2
pm2 start ecosystem.config.cjs
pm2 save # lưu danh sách app
pm2 startup # in ra lệnh sudo, chạy lệnh đó để PM2 tự bật khi server khởi động
pm2 logs miniblog
pm2 install pm2-logrotate
pm2 reload miniblog # sau khi cập nhật code
Log JSON của pino nằm trong ~/.pm2/logs và lớn dần mãi, pm2-logrotate cắt file mỗi ngày hoặc khi quá 10 MB, giữ 30 file. pm2 reload restart lần lượt từng process: process cũ xử lý nốt request rồi mới thoát nên site không bị gián đoạn.
Chú ý: các process cluster không chung RAM. Session nằm trong MySQL nên không sao, nhưng bộ đếm đăng nhập sai và express-rate-limit đếm riêng từng process, 2 process thì giới hạn gấp đôi. Muốn đếm chung thì dùng Redis, hoặc đặt instances: 1.
5. Nginx và HTTPS.
# bản mẫu: sudo cp vào /etc/nginx/sites-available/miniblog
server {
listen 80;
server_name miniblog.example.com;
# multer nhận ảnh tối đa 2 MB cộng các ô khác, mặc định của Nginx chỉ 1m
client_max_body_size 3m;
# Ảnh upload: Nginx gửi thẳng từ thư mục, không qua Node.js
location /uploads/ {
alias /var/www/miniblog/public/uploads/;
add_header X-Content-Type-Options nosniff;
expires 30d;
}
# Còn lại chuyển cho MiniBlog ở cổng 3000
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Body quá client_max_body_size bị Nginx trả 413, không tới được multer (Bài 18). Ảnh upload không qua helmet nên mình tự thêm nosniff. public/uploads không có trong git, nhớ backup cùng database.
Bật site rồi lấy chứng chỉ HTTPS miễn phí của Let's Encrypt:
sudo cp deploy/nginx.conf /etc/nginx/sites-available/miniblog
sudo ln -s /etc/nginx/sites-available/miniblog /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginx
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d miniblog.example.com
Certbot sửa server block sang HTTPS và tự gia hạn chứng chỉ. Lúc này Nginx gửi X-Forwarded-Proto: https nên cookie có Secure, đăng nhập bình thường.
6. Giới thiệu Docker.
Thay vì cài Node.js lên server, các bạn có thể đóng gói MiniBlog thành một image Docker, chạy ở đâu cũng giống nhau:
- Dockerfile
FROM node:24-alpine
WORKDIR /app
ENV NODE_ENV=production
# Cài package trước, chỉ cài lại khi package.json/package-lock.json đổi
COPY package.json package-lock.json ./
RUN npm ci --omit=dev
COPY . .
# Thư mục ảnh upload phải ghi được bằng user node
RUN mkdir -p public/uploads && chown node:node public/uploads
USER node
EXPOSE 3000
CMD ["node", "--env-file=.env", "server.js"]
File .dockerignore loại node_modules, .git, .env*, public/uploads, test khỏi image. Build và chạy:
chmod 640 .env && sudo chgrp 1000 .env # user node (gid 1000) trong image đọc được
docker build -t miniblog .
docker run -d --name miniblog --network host \
-v "$PWD/.env":/app/.env:ro -v miniblog-uploads:/app/public/uploads miniblog
--network host cho container dùng chung mạng với server: app vẫn nghe 127.0.0.1:3000, DB_HOST=127.0.0.1 tới được MySQL. Không có nó thì 127.0.0.1 là chính container: phải đặt HOST=0.0.0.0, publish -p 127.0.0.1:3000:3000, cho MySQL nghe ở địa chỉ container tới được và tạo user MySQL cho địa chỉ đó. .env gắn lúc chạy, không nằm trong image; để chmod 600 thì user node không đọc được (.env: not found).
Code đầy đủ của MiniBlog sau bài này nằm ở tag bai-25 trên GitHub; các thay đổi của riêng bài này: so sánh bai-24...bai-25.
7. Lời kết.
Như vậy chúng ta đã đưa MiniBlog lên server. Đây cũng là bài cuối của series Express 5: từ một app.get('/'), MiniBlog giờ có route, middleware, EJS, MySQL, đăng nhập, bảo mật, upload, REST API, mail, log, test và deploy. Tiếp theo các bạn có thể tìm hiểu Redis, WebSocket hoặc NestJS nhé!
Đăng ký nhận tin.
Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!





0 Comments