Node.js Versions
QUẢN LÝ PHIÊN BẢN NODE.JS TRÊN VPANEL
Hướng dẫn chi tiết cách cài đặt, gỡ bỏ và chọn phiên bản Node.js mặc định thông qua NVM (Node Version Manager). Nhiều phiên bản Node.js có thể tồn tại song song để mỗi ứng dụng của tenant chọn phiên bản phù hợp với framework của mình.
1. Truy cập Node.js Versions
Đăng nhập vào Admin Panel ở cổng :2087. Trên sidebar, mở Software và nhấn Node.js Versions.
Tổng quan giao diện
| Thành phần | Mô tả |
|---|---|
| Install New Version | Mở hộp thoại cài đặt phiên bản LTS mới. |
| Refresh | Quét lại thư mục NVM. |
| Search | Lọc theo chuỗi phiên bản (ví dụ 20). |
Các cột trong bảng
| Cột | Ý nghĩa |
|---|---|
| Version | Định danh phiên bản đầy đủ (ví dụ 18.20.4, 20.15.1, 22.4.0). |
| Install Date | Thời điểm NVM tải binary về máy. |
| Apps Using | Số ứng dụng Node.js của tenant đang gắn với phiên bản này. |
| Disk Space | Dung lượng lưu trên đĩa dưới ~/.nvm/versions/node/. |
| Default | Đánh dấu phiên bản mặc định của server. |
| Actions | Các nút Set Default hoặc Remove. |
2. Cài đặt phiên bản mới
- Bước 1: Nhấn Install New Version.
- Bước 2: Trong hộp thoại, chọn nhánh LTS (
18.x,20.x,22.x). vPanel tự động cài phiên bản patch mới nhất. - Bước 3: Xác nhận — quá trình cài đặt chạy dưới dạng background task và hoàn tất trong khoảng một phút khi cache đã sẵn sàng.
Mặc định chỉ hiển thị các phiên bản LTS. Bạn có thể cài phiên bản Current bằng chuỗi phiên bản tuỳ chọn nhưng không khuyến nghị cho môi trường production.
3. Đặt phiên bản mặc định
Nhấn Set Default ở dòng phiên bản mong muốn. Các ứng dụng Node.js mới sẽ sử dụng phiên bản này trừ khi chỉ định khác. Ứng dụng hiện có vẫn giữ nguyên phiên bản đang gắn.
4. Gỡ bỏ phiên bản không sử dụng
- Bước 1: Đảm bảo Apps Using bằng
0. - Bước 2: Nhấn Remove và xác nhận. NVM sẽ xoá thư mục phiên bản để giải phóng dung lượng.
Không thể gỡ phiên bản đang là mặc định. Hãy đổi mặc định sang phiên bản khác trước.
5. Khắc phục sự cố và lưu ý
Cài đặt thất bại với "checksum mismatch"
- Nguyên nhân: Kết nối mạng bị gián đoạn khi tải.
- Giải pháp: Nhấn Install lại — NVM sẽ tự động tải lại binary mới.
"Apps Using" bằng 0 nhưng nút Remove bị mờ
- Nguyên nhân: Còn liên kết mặc định trong
~/.nvm/alias/default. - Giải pháp: Đổi mặc định sang phiên bản khác trước rồi gỡ.
Dung lượng đĩa không giảm sau khi gỡ
- Nguyên nhân: Thư mục home của tenant còn symlink
.node-versiontrỏ tới phiên bản đã xoá. - Giải pháp: Hướng dẫn tenant chạy
nvm use --ltstrong thư mục home.
Chúc bạn quản trị Server an toàn và hiệu quả!