- 1 1. Giới thiệu: Tại sao nên sử dụng Node.js trên Ubuntu?
- 2 2. Tổng quan các phương pháp cài đặt Node.js trên Ubuntu
- 3 3. Cách 1: Cài Node.js bằng gói APT (chính thức của Ubuntu)
- 4 4. Cách 2: Cài Node.js mới nhất qua NodeSource PPA
- 5 5. Cách 3: Quản lý version linh hoạt với nvm (khuyến nghị)
- 6 6. Sử dụng và cài đặt npm, yarn
- 7 7. Xử lý lỗi và sự cố thường gặp
- 8 8. Câu hỏi thường gặp (FAQ)
- 9 9. Tổng kết: Lựa chọn phương pháp cài đặt phù hợp mục tiêu
1. Giới thiệu: Tại sao nên sử dụng Node.js trên Ubuntu?
Sự kết hợp tuyệt vời giữa Ubuntu và Node.js
Node.js là nền tảng giúp chạy JavaScript phía server, được sử dụng rộng rãi trong phát triển web và các công cụ. Ubuntu lại là một bản phân phối Linux rất được các lập trình viên và quản trị viên máy chủ tin dùng. Kết hợp hai yếu tố này cho phép bạn xây dựng môi trường phát triển ổn định, linh hoạt và nhanh chóng.
Khi cài đặt Node.js trên Ubuntu, bạn sẽ nhận được nhiều lợi ích như:
- Hệ điều hành nhẹ, ít chức năng thừa, tối ưu tài nguyên hệ thống
- Có thể đồng nhất môi trường phát triển, kiểm thử và vận hành trên nền tảng Linux
- Tương thích tốt với Node.js, các công cụ như npm, nvm hoạt động mượt mà
Vì vậy, sự kết hợp giữa Ubuntu và Node.js là lựa chọn rất hấp dẫn cho cả phát triển frontend và backend.
Đối tượng và mục tiêu của bài viết
Bài viết này dành cho:
- Người mới muốn sử dụng Node.js trên Ubuntu lần đầu
- Ai đang tìm kiếm phương pháp cài đặt Node.js tối ưu nhất
- Người muốn sử dụng Node.js phiên bản mới nhất nhưng lo lắng về thiết lập
Đọc xong bài viết, bạn sẽ so sánh được 3 cách cài đặt Node.js trên Ubuntu, từ đó chọn phương án phù hợp nhất với mục đích và trình độ. Ngoài ra, còn hướng dẫn cài đặt npm, yarn, cách xử lý lỗi thường gặp, giúp bạn tự tin làm chủ môi trường Node.js.
2. Tổng quan các phương pháp cài đặt Node.js trên Ubuntu
Ba phương pháp cài đặt, mỗi phương pháp có ưu nhược điểm riêng
Có 3 cách phổ biến để cài Node.js trên Ubuntu:
- Cài từ APT (Advanced Package Tool) – gói chính thức của Ubuntu
- Cài qua NodeSource PPA (Personal Package Archive)
- Cài bằng nvm (Node Version Manager) để quản lý nhiều phiên bản
Mỗi cách đều có điểm mạnh/yếu riêng, phù hợp với mục đích và cấu hình hệ thống khác nhau. Bảng dưới đây tóm tắt đặc điểm từng phương pháp.
Bảng so sánh các phương pháp cài đặt Node.js
Phương pháp | Đặc điểm chính | Ưu điểm | Nhược điểm | Đối tượng phù hợp |
---|---|---|---|---|
APT (chính thức) | Dùng kho chính thức của Ubuntu | Dễ, an toàn | Phiên bản có thể cũ | Người mới muốn thử nhanh |
NodeSource PPA | Quản lý Node.js mới nhất qua APT | Hỗ trợ phiên bản mới hơn | Cần thêm PPA | Lập trình viên cần bản ổn định |
nvm | Chuyển đổi nhiều phiên bản linh hoạt | Linh hoạt, phù hợp mọi nhu cầu | Cần thiết lập shell | Khuyến nghị cho học tập/phát triển |
Tại sao cần so sánh các phương pháp?
Ubuntu nổi tiếng ổn định, nhưng vì vậy các phần mềm trong kho APT thường không phải bản mới nhất. Nếu bạn muốn dùng tính năng mới của Node.js hoặc cần thử nhiều phiên bản, nên chọn cách khác ngoài APT.
Ngược lại, nếu muốn dùng thử nhanh hoặc không muốn cấu hình phức tạp cho server, cài bằng APT là đủ.
Nên chọn cách nào?
Kết luận: Đối với lập trình viên hoặc ai muốn dùng Node.js lâu dài, nên cài qua nvm.
Lý do:
- Dễ dàng chuyển đổi giữa bản mới/cũ
- npm được cài tự động kèm theo
- Ít gặp lỗi phân quyền (không cần sudo)
3. Cách 1: Cài Node.js bằng gói APT (chính thức của Ubuntu)
APT là gì? Cách quản lý gói chuẩn của Ubuntu
APT (Advanced Package Tool) là hệ thống quản lý gói chuẩn của các distro dựa trên Debian, bao gồm cả Ubuntu. APT cho phép cài, cập nhật, xóa phần mềm bằng lệnh đơn giản.
Kho chính thức của Ubuntu đã có Node.js nên bạn có thể cài Node.js ngay mà không cần chuẩn bị gì đặc biệt.
Các bước cài đặt
- Cập nhật danh sách gói mới nhất:
sudo apt update
- Cài Node.js và npm:
sudo apt install nodejs npm
- Kiểm tra cài đặt thành công:
node -v
npm -v
Nếu hiển thị version là đã cài thành công.
Ưu điểm: Dễ và an toàn
- Kho chính thức của Ubuntu, độ tin cậy cao
- Lệnh đơn giản, người mới dễ thao tác
- Dễ đồng bộ với cập nhật hệ thống
Rất phù hợp nếu bạn chỉ muốn thử Node.js hoặc không cần nhiều thiết lập cho server.
Nhược điểm: Có thể là phiên bản cũ
Do ưu tiên ổn định, phiên bản Node.js có thể đã cũ vài thế hệ.
Ví dụ, Ubuntu 22.04 có thể chỉ cài được Node.js v12/v14 qua APT, chưa có các tính năng hoặc bản vá mới nhất.
Ngoài ra, khó quản lý nhiều version Node.js cho các dự án khác nhau.
Ai nên chọn cách này?
- Người mới chỉ muốn thử Node.js
- Môi trường server ổn định, không yêu cầu bản mới
- Không cần chuyển đổi nhiều version
4. Cách 2: Cài Node.js mới nhất qua NodeSource PPA
NodeSource là gì?
NodeSource cung cấp các bản Node.js ổn định/mới nhất cho Ubuntu, độc lập với nhóm phát triển chính thức. Được cộng đồng tin tưởng, đặc biệt khi muốn cài Node.js mới nhất qua APT.
NodeSource cũng được khuyến nghị trên trang chủ Node.js và nhiều doanh nghiệp sử dụng.
Các bước cài đặt (ví dụ Node.js 18.x)
- Cập nhật danh sách gói:
sudo apt update
- Nếu chưa có curl, hãy cài đặt:
sudo apt install curl
- Chạy script thiết lập NodeSource:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
- Cài Node.js:
sudo apt install -y nodejs
- Kiểm tra cài đặt:
node -v
npm -v
Ưu điểm: Có thể cài bản mới nhất bằng APT
- Cài Node.js ổn định/mới nhất rất dễ
- Vẫn quản lý bằng APT, quen thuộc với nhiều người
- npm cài cùng Node.js
Rất phù hợp nếu bạn muốn cập nhật môi trường nhanh hơn kho chính thức.
Nhược điểm: Cần thêm PPA
- Nhiều bước hơn APT chuẩn, người mới có thể thấy phức tạp
- Cần chú ý chọn nguồn uy tín (NodeSource rất an toàn)
Ai nên chọn cách này?
- Lập trình viên muốn dùng Node.js mới nhất và ổn định
- Không hài lòng với kho chuẩn của Ubuntu nhưng chưa cần đến nvm
- Muốn tiếp tục quản lý phần mềm bằng APT
5. Cách 3: Quản lý version linh hoạt với nvm (khuyến nghị)
nvm là gì? Công cụ chuyển đổi version Node.js dễ dàng
nvm (Node Version Manager) là công cụ dòng lệnh cho phép bạn cài, quản lý nhiều version Node.js cùng lúc. Rất phù hợp nếu bạn muốn dùng bản mới/lâu dài hoặc chuyển đổi version giữa các dự án.
nvm giúp bạn tạo môi trường phát triển linh hoạt trên Ubuntu mà không cần cài trực tiếp vào hệ thống.

Các bước cài đặt nvm
- Dùng lệnh
curl
để chạy script cài đặt:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
- Nạp lại file cấu hình shell (tuỳ shell bạn dùng):
source ~/.bashrc
Hoặc nếu dùng Zsh:
source ~/.zshrc
- Kiểm tra đã cài xong chưa:
command -v nvm
Nếu trả về nvm
là OK.
Cài Node.js bằng nvm
- Cài bản LTS (hỗ trợ dài hạn):
nvm install --lts
- Cài version tuỳ chọn:
nvm install 18
- Chuyển đổi version:
nvm use 18
- Chọn version mặc định:
nvm alias default 18
- Kiểm tra version:
node -v
npm -v
Ưu điểm: Linh hoạt và dễ quản lý
- Dễ chuyển đổi và quản lý nhiều version cùng lúc
- npm tự động cài kèm
- Không cần sudo, tránh lỗi phân quyền
- Không ảnh hưởng hệ thống, cực hợp phát triển
Nhược điểm: Cần chú ý thiết lập ban đầu
- Nếu quên nạp lại file
.bashrc
/.zshrc
sẽ không dùng được nvm - Lưu ý chỉ cài cho từng user, không phải toàn hệ thống
Ai nên chọn cách này?
- Lập trình viên muốn chuyển đổi nhiều version Node.js
- Ai làm nhiều dự án cần version khác nhau
- Thực ra cũng rất phù hợp cho người mới muốn tránh lỗi phân quyền
6. Sử dụng và cài đặt npm, yarn
npm là gì? Công cụ không thể thiếu khi dùng Node.js
npm (Node Package Manager) là công cụ quản lý gói cho Node.js, cho phép cài, quản lý thư viện trên toàn thế giới. Khi lập trình với Node.js, bạn gần như chắc chắn phải dùng npm.
Cài Node.js bằng APT, NodeSource hoặc nvm đều sẽ có npm đi kèm.
Kiểm tra version npm:
npm -v
Cách sử dụng npm cơ bản
Thao tác | Lệnh ví dụ |
---|---|
Cài package | npm install <tên-package> |
Cài toàn hệ thống | npm install -g <tên-package> |
Gỡ package | npm uninstall <tên-package> |
Khởi tạo project | npm init hoặc npm init -y |
Xem danh sách package | npm list hoặc npm list -g |
npm rất quan trọng khi quản lý các thư viện phụ thuộc cho từng project.
yarn là gì? Lựa chọn thay thế npm được ưa chuộng
yarn do Facebook phát triển, là công cụ thay thế npm với mục tiêu cài đặt nhanh và ổn định hơn. Các lệnh của yarn gần như giống npm nên học rất nhanh.
Cách cài yarn (qua npm)
npm install -g yarn
Kiểm tra version:
yarn -v
Cách sử dụng yarn cơ bản
Thao tác | Lệnh ví dụ |
---|---|
Cài package | yarn add <tên-package> |
Cài toàn hệ thống | yarn global add <tên-package> |
Gỡ package | yarn remove <tên-package> |
Khởi tạo project | yarn init |
Xem danh sách package | yarn list hoặc yarn global list |
Nên dùng npm hay yarn?
Tiêu chí | npm | yarn |
---|---|---|
Mặc định | Có sẵn với Node.js | Phải cài thêm |
Tốc độ | Bình thường | Nhanh nhờ cache |
File lock | package-lock.json | yarn.lock |
Tương thích lệnh | – | Hầu hết giống npm (lưu ý một số lệnh) |
Từ npm v7 trở đi đã được cải thiện mạnh, dùng npm hay yarn đều ổn. Tốt nhất hãy theo tool mà dự án hoặc team của bạn đang dùng.
7. Xử lý lỗi và sự cố thường gặp
Các lỗi thường gặp và cách xử lý
■ node: command not found
Nguyên nhân:
Node.js chưa được cài hoặc PATH chưa được thêm. Hay gặp khi cài nvm xong mà chưa nạp lại shell.
Cách xử lý:
- Nạp lại
.bashrc
hoặc.zshrc
để kích hoạt nvm
source ~/.bashrc
- Nếu vẫn lỗi, thử đăng xuất hoặc khởi động lại
■ E: Unable to locate package nodejs
Nguyên nhân:
Danh sách gói APT đã cũ hoặc chưa thêm đúng PPA.
Cách xử lý:
- Cập nhật lại danh sách gói:
sudo apt update
- Nếu dùng NodeSource, hãy chạy lại script thiết lập
■ npm ERR! permission denied
Nguyên nhân:
Cố gắng cài package toàn hệ thống mà user thường không đủ quyền.
Cách xử lý:
- Thêm
sudo
khi cài (không nên lạm dụng)
sudo npm install -g <tên-package>
- Nên dùng nvm để không cần sudo khi cài package
■ nvm: command not found
Nguyên nhân:
Đã cài nvm nhưng chưa nạp file cấu hình shell.
Cách xử lý:
- Kiểm tra file
.bashrc
đã thêm nvm chưa, hoặc nạp thủ công: - Nạp thủ công:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
Lưu ý chung để tránh sự cố
- Luôn kiểm tra lại PATH
- Dùng nvm sẽ tránh được hầu hết lỗi môi trường
- Lưu ý phiên bản Ubuntu và Node.js (Ubuntu bản cũ thì repo cũng cũ)
8. Câu hỏi thường gặp (FAQ)
Q1. Làm sao kiểm tra version Node.js?
A. Chạy lệnh sau trên terminal:
node -v
Kiểm tra luôn version npm:
npm -v
Q2. Làm sao dùng nhiều version Node.js trên Ubuntu?
A. Dùng nvm (Node Version Manager) là đơn giản và an toàn nhất. Sau khi cài nvm, bạn chuyển đổi version dễ dàng:
nvm install 16
nvm use 16
Với nvm, mỗi project có thể dùng version khác nhau rất linh hoạt.
Q3. Đã cài Node.js bằng nvm nhưng không dùng được?
A. Thường do chưa nạp lại file cấu hình shell. Sau khi cài, hãy chạy:
source ~/.bashrc
Nếu dùng Zsh thì chạy source ~/.zshrc
.
Q4. npm và yarn khác nhau gì? Nên chọn cái nào?
A. Chức năng chính gần giống nhau, yarn cài nhanh hơn nhờ cache, có file yarn.lock
quản lý phụ thuộc rõ ràng. npm bản mới cũng đã cải tiến nhiều, dùng cái nào cũng được.
Hãy theo tool mà dự án/team bạn đang sử dụng để tránh xung đột.
Q5. Node.js khác gì với Deno và Bun?
A. Deno/Bun là các runtime mới, khắc phục một số nhược điểm của Node.js:
- Deno: hỗ trợ TypeScript, bảo mật tốt hơn, có sẵn thư viện chuẩn
- Bun: chạy nhanh hơn Node.js, tích hợp sẵn quản lý package
Tuy nhiên, Node.js vẫn là lựa chọn thực tế nhất nhờ hệ sinh thái npm rất lớn.
9. Tổng kết: Lựa chọn phương pháp cài đặt phù hợp mục tiêu
Có nhiều cách cài Node.js trên Ubuntu, mỗi cách có ưu điểm riêng. Bài viết đã phân tích 3 phương pháp phổ biến và hướng dẫn cách lựa chọn.
Tóm lại:
APT (chính thức Ubuntu)
- Ưu: Dễ, an toàn
- Nhược: Có thể cũ
- Khuyến nghị: Người mới muốn thử nhanh
NodeSource PPA
- Ưu: Có bản Node.js mới bằng APT
- Nhược: Cần thêm PPA
- Khuyến nghị: Lập trình viên muốn bản ổn định, mới hơn
nvm (Node Version Manager)
- Ưu: Chuyển đổi version dễ dàng, cực linh hoạt
- Nhược: Thiết lập ban đầu phức tạp hơn chút
- Khuyến nghị: Lập trình viên nhiều kinh nghiệm hoặc làm nhiều dự án
Ngoài ra, bài viết còn hướng dẫn về npm, yarn và xử lý lỗi. Nếu chọn đúng phương pháp, bạn có thể xây dựng môi trường Node.js ổn định và mạnh mẽ trên Ubuntu rất dễ dàng.
Muốn phát triển xa hơn, hãy làm quen với nvm để tối ưu cho team, CI/CD, và các dự án lớn.