• Tiếng Việt

      • Cài đặt create-nocobase-app

      Điều kiện tiên quyết
      • Đã cài Node.js >= 22, Yarn 1.22.x
      • Đã cấu hình và khởi động một trong các database cần thiết: MySQL 8.0.17+, MariaDB 10.9+, PostgreSQL 10+
      • Do điều kiện mạng tại Trung Quốc, khuyến nghị bạn đổi sang npm mirror nội địa (không bắt buộc)
      $ yarn config set disable-self-update-check true
$ yarn config set registry https://registry.npmmirror.com/

      1. Tạo dự án NocoBase

      Chọn phiên bản NocoBase (So sánh phiên bản) và loại database, thực thi lệnh tương ứng.

      Phiên bản Latest
      Phiên bản Beta
      Phiên bản Alpha
      PostgreSQL
      MySQL
      MariaDB
      yarn create nocobase-app my-nocobase-app -d postgres \
   -e DB_HOST=localhost \
   -e DB_PORT=5432 \
   -e DB_DATABASE=nocobase \
   -e DB_USER=nocobase \
   -e DB_PASSWORD=nocobase \
   -e TZ=Asia/Shanghai
      Hướng dẫn biến môi trường
      • TZ dùng để cài đặt múi giờ của ứng dụng, mặc định là múi giờ hệ điều hành
      • APP_KEY là khóa bí mật của ứng dụng, dùng để tạo Token người dùng, v.v. (Nếu APP_KEY được sửa, các Token cũ cũng sẽ vô hiệu). Có thể là chuỗi ngẫu nhiên bất kỳ. Vui lòng sửa thành khóa bí mật của riêng bạn và đảm bảo không tiết lộ ra ngoài
      • DB_* là các cấu hình liên quan đến database, vui lòng sửa thành thông tin kết nối database thực tế của bạn

      2. Chuyển vào thư mục

      cd my-nocobase-app

      3. Cài đặt phụ thuộc

      Lưu ý: Do điều kiện mạng và cấu hình hệ thống, bước này có thể mất khoảng mười mấy phút.

      yarn install
      Mẹo cho môi trường sản xuất

      Khi triển khai môi trường sản xuất, để giảm dung lượng, có thể chỉ cài đặt các phụ thuộc cần thiết:

      yarn install --production

      4. Cài đặt NocoBase

      yarn nocobase install --lang=zh-CN

      Quá trình cài đặt sẽ tự động tạo cấu trúc bảng database và khởi tạo dữ liệu.

      5. Khởi động NocoBase

      Môi trường phát triển

      yarn dev

      Môi trường sản xuất

      yarn start

      6. Đăng nhập NocoBase

      Mở trình duyệt và truy cập http://localhost:13000, tài khoản và mật khẩu khởi tạo là admin@nocobase.com và admin123.

      Lưu ý bảo mật tài khoản

      Sau khi đăng nhập lần đầu, vui lòng đổi mật khẩu mặc định ngay để đảm bảo an toàn hệ thống.