• Tiếng Việt

      • Cài đặt ứng dụng NocoBase

      Điều kiện tiên quyết

      • Node.js >= 22
      • Yarn 1.x
      • Nếu bạn định cài bằng Docker, hãy chắc chắn Docker đã được khởi động trước

      Bước 1: Cài CLI

      Trước tiên, hãy cài NocoBase CLI ở mức toàn cục:

      npm install -g @nocobase/cli
nb --version

      Nếu bạn thường mở nhiều terminal cùng lúc hoặc muốn thao tác song song với AI Agents, bạn cũng nên chạy thêm nb session setup một lần. Làm vậy thì mỗi phiên sẽ giữ current env riêng, ít bị ảnh hưởng lẫn nhau hơn.

      Bước 2: Khởi tạo ứng dụng

      Cách được khuyến nghị là cài đặt qua UI wizard:

      nb init --ui
      1. Getting started - đặt identifier --env và chọn Install a new app

      2026-06-11-20-14-32

      1. App environment - thiết lập thông tin cơ bản của ứng dụng, vị trí lưu trữ và cổng runtime

      2026-06-14-10-03-06

      1. App source and version - chọn cách lấy ứng dụng cùng source và version sẽ dùng

      2026-06-14-09-51-33

      1. Configure the database - chọn cơ sở dữ liệu tích hợp sẵn hoặc cơ sở dữ liệu tùy chỉnh

      2026-06-14-09-52-05

      1. Create an admin account - thiết lập tài khoản quản trị đầu tiên

      2026-06-14-09-52-56

      1. Connection & authentication - nhập URL truy cập ứng dụng và chọn phương thức xác thực

      2026-06-14-10-00-35

      Nếu bạn quen thao tác trong terminal hơn, bạn cũng có thể chạy trực tiếp:

      nb init

      Nếu cần khởi tạo trong script hoặc CI, hãy dùng chế độ không tương tác:

      nb init --yes --env app1
      Cài đặt trên máy chủ từ xa

      Nếu bạn chạy nb init --ui trên server, nên đổi host mặc định sang IP hiện tại của server đó trước. Như vậy bạn mới có thể mở wizard từ trình duyệt trên máy local.

      nb config set default-ui-host <server-ip>
nb config set default-api-host <server-ip>

      Bước 3: Xác nhận ứng dụng đã sẵn sàng

      Sau khi cài xong, thông thường bạn nên kiểm tra trước 3 điều này:

      • Env đã được lưu thành công chưa
      • Ứng dụng đã khởi động bình thường chưa
      • Bạn có đăng nhập được bằng tài khoản quản trị hay không

      Các lệnh thường dùng là:

      nb env list
nb env info
nb app logs

      Với cài đặt local mặc định, thông thường bạn có thể mở trực tiếp http://localhost:13000 trên trình duyệt. Sau khi đăng nhập, mở phiên AI Agent mới hoặc khởi động lại phiên hiện tại là AI có thể bắt đầu làm việc với ứng dụng NocoBase này.

      Cấu hình CLI mặc định được lưu trong ~/.nocobase/, vì vậy AI Agents thường có thể truy cập từ bất kỳ thư mục làm việc nào.

      Nếu sau này ứng dụng này cần phục vụ người dùng thực tế, bạn không nên dùng trực tiếp IP + port trong thời gian dài. Bước tiếp theo thường là thêm reverse proxy và bật HTTPS.

      Bước tiếp theo

      Liên kết liên quan