Tài liệu ServBay: Thiết lập Phiên bản Node.js Cụ thể cho Dự Án, Script và Website của Bạn
ServBay là một môi trường phát triển web local mạnh mẽ, hỗ trợ nhiều ngôn ngữ lập trình và công nghệ, bao gồm cả Node.js. Trong thực tiễn phát triển, bạn có thể cần sử dụng phiên bản Node.js khác nhau cho từng dự án, từng script hoặc toàn bộ website. Ví dụ, một dự án cũ có thể phụ thuộc vào Node.js 14, trong khi dự án mới cần các tính năng từ Node.js 20. ServBay cung cấp các phương thức linh hoạt để đáp ứng những nhu cầu này.
Bài viết này sẽ hướng dẫn chi tiết cách dễ dàng chỉ định phiên bản Node.js cho từng script, website trên ServBay cùng phương thức cấu hình theo từng dự án.
Sử dụng file .servbay.config để chỉ định phiên bản Node.js và cấu hình dự án
Đối với các dự án cần kiểm soát chặt chẽ phiên bản Node.js cũng như các biến môi trường liên quan, ServBay cung cấp phương án cấu hình ở cấp độ dự án thông qua file .servbay.config
đặt tại thư mục gốc của dự án. Với file này, bạn có thể chỉ định phiên bản Node.js, địa chỉ kho lưu trữ của trình quản lý package, thư mục cache,... nhằm đảm bảo môi trường dự án tách biệt và đồng nhất.
Một ví dụ file .servbay.config
thiết lập phiên bản Node.js cụ thể, cấu hình registry và thư mục cache cho npm/yarn như sau:
NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Ví dụ: sử dụng mirror chỉ định
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Ví dụ: sử dụng mirror chỉ định
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Ví dụ: chỉ định thư mục cache
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Ví dụ: chỉ định thư mục cache
2
3
4
5
Giải thích:
NODE_VERSION
: Chỉ định số hiệu phiên bản Node.js chủ đạo mà dự án sử dụng. ServBay sẽ tìm và sử dụng Node.js đã cài đặt phù hợp với phiên bản này.YARN_CONFIG_REGISTRY
,NPM_CONFIG_REGISTRY
: Cấu hình địa chỉ repository của trình quản lý package npm hoặc yarn cho dự án.NPM_CONFIG_CACHE
,YARN_CONFIG_CACHE
: Chỉ định thư mục cache cho npm hoặc yarn trong dự án. Ở ví dụ trên sử dụng thư mục tạm mặc định của ServBay:/Applications/ServBay/tmp/
với các thư mục con.
Thông thường, bạn nên đặt file .servbay.config
tại thư mục gốc của dự án. Để biết chi tiết về cách thiết lập và sử dụng, vui lòng tham khảo chương File .servbay.config trong tài liệu chính thức của ServBay.
Chạy Script Node.js với Phiên bản Cụ thể qua Dòng Lệnh
Nếu bạn không muốn chỉ định phiên bản Node.js ở cấp độ dự án mà chỉ cần chạy tạm thời một script hay thực hiện một lệnh nào đó bằng một phiên bản Node.js cụ thể, hãy sử dụng các alias dòng lệnh mà ServBay cung cấp sẵn.
Trong môi trường terminal của ServBay (có thể mở từ giao diện ứng dụng ServBay), bạn dễ dàng xác định phiên bản Node.js cho script bằng cú pháp node-<version>
. ServBay sẽ tạo sẵn alias kiểu này cho từng phiên bản Node.js đã cài đặt.
Ví dụ, để chạy script script.js
bằng Node.js 14, thực hiện:
$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Ví dụ output, số phiên bản có thể khác
$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Ví dụ output, số phiên bản có thể khác
$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Ví dụ output, số phiên bản có thể khác
2
3
4
5
6
7
8
9
10
11
Giải Thích
$ node-14 script.js
: Chạyscript.js
bằng Node.js 14 đã cài trong ServBay (số phiên bản cụ thể thuộc series 14.x.x phụ thuộc bản bạn cài).$ node-16 script.js
: Chạy script bằng Node.js 16 đã cài.$ node-20 script.js
: Chạy script bằng Node.js 20 đã cài.
Với cách này, bạn linh hoạt kiểm thử, chạy các script yêu cầu phiên bản Node.js cụ thể hoặc kiểm tra compatibility mà không cần thay đổi phiên bản toàn cục trên hệ thống.
Chỉ định Phiên bản Node.js cho Website qua Giao Diện Quản Lý ServBay
ServBay cho phép bạn thiết lập phiên bản Node.js mặc định cho từng website trực tiếp qua giao diện quản trị. Điều này đặc biệt hữu ích khi website của bạn dùng Node.js làm backend service (ví dụ các ứng dụng Node.js framework triển khai qua reverse proxy của Caddy/Nginx) hoặc cần môi trường Node.js riêng biệt.
Các Bước Thực Hiện
Mở giao diện quản trị ServBay: Khởi động ứng dụng ServBay, truy cập giao diện quản trị thông qua trình duyệt (thông thường là
http://localhost:5200
hoặc link trong cửa sổ ứng dụng chính).Điều hướng đến phần quản lý website: Trong sidebar bên trái, bấm vào
Website
(Websites).Chọn và chỉnh sửa website: Ở danh sách website, tìm website bạn cần cấu hình (ví dụ thư mục
/Applications/ServBay/www/servbay.demo
). Nhấn nút chỉnh sửa bên phải (biểu tượng bánh răng/cây bút), hoặc bấm vào tên website để vào trang chi tiết.Thiết lập phiên bản Node.js: Trong trang cấu hình website, tìm tới mục cấu hình Node.js. Thường sẽ có menu thả xuống (dropdown). Chọn phiên bản bạn muốn website này sử dụng làm mặc định.
Lưu thay đổi: Sau khi chọn phiên bản, hãy chắc chắn nhấn nút
Lưu
hoặcÁp dụng
ở cuối trang để cập nhật cấu hình.Khởi động lại website hoặc ServBay (nếu cần): Một số thay đổi yêu cầu khởi động lại web server liên quan (Caddy/Nginx) hoặc toàn bộ ServBay mới có hiệu lực. ServBay sẽ thông báo nếu cần khởi động lại dịch vụ.
Lưu Ý
- Đảm bảo Node.js đã được cài đặt và chạy: Phiên bản Node.js bạn chọn ở phần cài đặt website phải được cài đặt sẵn và đang chạy trong ServBay (kiểm tra trong mục
Packages
). Nếu chưa có, hãy cài và khởi động trước. - Loại website: Thiết lập này chủ yếu áp dụng cho website phụ thuộc Node.js ở backend (ví dụ các app sử dụng Express.js, Next.js, NestJS,...). Với các website tĩnh thuần hoặc tận dụng PHP/Python/Go làm backend thì setting này không áp dụng hoặc ảnh hưởng không đáng kể.
- Kiểm thử tương thích: Sau khi thay đổi phiên bản Node.js, hãy kiểm tra kỹ toàn bộ chức năng website để đảm bảo không có lỗi tương thích hoặc phát sinh mới dựa trên các dependency đang sử dụng.
- Mối quan hệ với
.servbay.config
: Cấu hình ở cấp độ website sẽ đóng vai trò mặc định. Nếu cùng lúc thư mục website chứa cả file.servbay.config
và đã thiết lậpNODE_VERSION
thì cấu hình trong file này sẽ được ưu tiên để kiểm soát chi tiết hơn cho dự án.
Tổng Kết
ServBay cung cấp nhiều giải pháp linh hoạt, mạnh mẽ để quản lý và chỉ định môi trường Node.js cho các dự án của bạn. Bạn có thể dùng file .servbay.config
ngay tại thư mục dự án để kiểm soát tỉ mỉ từng biến môi trường, alias dòng lệnh node-<version>
để nhanh chóng chạy script với phiên bản cụ thể, hoặc chỉ định mặc định phiên bản Node.js cho từng website trực tiếp qua giao diện ServBay. Nhờ những tính năng này, việc đảm bảo compatibility giữa các dự án – dù là legacy cần phiên bản cũ hay sản phẩm mới cần tính năng hiện đại – đều trở nên dễ dàng. ServBay góp phần đồng bộ hóa môi trường phát triển, tăng hiệu suất làm việc cũng như khả năng kiểm soát toàn diện môi trường của bạn.