Trong môi trường Production và CI/CD, việc cài đặt Node.js yêu cầu sự chính xác tuyệt đối về phiên bản và Supply Chain Security. Phiên bản v24.11.1 (LTS) hiện là Standard Deployment Target nhờ sự ổn định của V8 Engine mới và việc tích hợp chặt chẽ Corepack.
1. Chuẩn bị
Khi tải binary Node.js về production server, phải verify tính toàn vẹn. Không bao giờ tải .tar.xz rồi giải nén trực tiếp.
Bước 1: Tải Binary + Checksum
cd /tmp
wget https://nodejs.org/dist/v24.11.1/node-v24.11.1-linux-x64.tar.xz
wget https://nodejs.org/dist/v24.11.1/SHASUMS256.txt.asc
(Server ARM64 cần tải bản linux-arm64.)
Bước 2: Verify Checksum
grep "node-v24.11.1-linux-x64.tar.xz" SHASUMS256.txt.asc | sha256sum -c -
Kết quả bắt buộc phải là:
OK
Nếu không, tuyệt đối không cài, file có thể đã bị sửa hoặc hỏng.
2. Cài đặt
Mục tiêu: mỗi version nằm trong /opt/<phiên-bản>, còn /opt/node là symlink. Cách này cho phép upgrade/rollback tức thì.
Bước 1: Giải nén vào /opt
tar -xJvf node-v24.11.1-linux-x64.tar.xz
sudo mv node-v24.11.1-linux-x64 /opt/node-v24.11.1
sudo chown -R root:root /opt/node-v24.11.1
Bước 2: Tạo symlink version
sudo rm -rf /opt/node
sudo ln -s /opt/node-v24.11.1 /opt/node
Lợi ích:
- Upgrade không cần sửa PATH
- Rollback trong 1 giây
- Có thể chạy song song Node 20, 22, 24 trên cùng server
Bước 3: Cấu hình môi trường
sudo nano /etc/profile.d/node.sh
Thêm:
export NODE_HOME=/opt/node
export PATH=${NODE_HOME}/bin:${PATH}
Áp dụng:
source /etc/profile.d/node.sh
Bước 4: Kiểm tra
node -v
which node
Đường dẫn phải là:
/opt/node/bin/node
3. Corepack & Prefix npm
Từ Node 24, Corepack trở thành component chiến lược để quản lý npm/yarn/pnpm chuẩn theo dự án.
1. Enable Corepack
sudo corepack enable
Bạn có thể chạy:
yarn -v
pnpm -v
mà không cài thủ công.
2. Sửa lỗi phân quyền npm global
Đây là bước bắt buộc để tránh sudo npm install -g:
mkdir -p "${HOME}/.npm-global"
npm config set prefix "${HOME}/.npm-global"
echo 'export PATH=${HOME}/.npm-global/bin:${PATH}' >> ~/.bashrc
source ~/.bashrc
Điều này đảm bảo global package như:
- pm2
- nestjs
- create-react-app
- vite
đều chạy mà không cần quyền root.
4. Maintenance Strategy
Khi Node.js ra bản mới (ví dụ v24.12.0), nâng cấp thực tế chỉ cần 2 bước:
sudo mv node-v24.12.0 /opt/node-v24.12.0
sudo ln -sfn /opt/node-v24.12.0 /opt/node
Không cần sửa profile, không mất global packages, không phải cài npm lại.
Tổng kết
Sau quy trình này, hệ thống có cấu trúc:
- Binary gốc:
/opt/node-v24.11.1 - Đường dẫn chính:
/opt/node(symlink) - Package Manager: Corepack enable (Yarn/PNPM native)
- Global npm packages: nằm tại
~/.npm-global - Upgrade/Rollback: đổi symlink trong 1 giây
