logologo
Bắt đầu
Hướng dẫn
Phát triển
Plugin
API
Trang chủ
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
Bắt đầu
Hướng dẫn
Phát triển
Plugin
API
Trang chủ
logologo
NocoBase hoạt động như thế nào
So sánh các phương thức cài đặt và phiên bản

Cài đặt NocoBase

Cài đặt bằng Docker
Cài đặt bằng create-nocobase-app
Cài đặt từ mã nguồn Git
Biến môi trường

Nâng cấp NocoBase

Nâng cấp cài đặt Docker
Nâng cấp cài đặt create-nocobase-app
Nâng cấp cài đặt từ mã nguồn Git

Triển khai

Triển khai môi trường production

Proxy tài nguyên tĩnh

nginx
caddy
CDN

Lệnh vận hành thường dùng

docker compose
pm2
Cách triển khai nhanh hơn
Cài đặt và nâng cấp plugin
Previous PageSo sánh các phương thức cài đặt và phiên bản
Next PageCài đặt bằng create-nocobase-app
Thông báo dịch bằng AI

Tài liệu này được dịch bằng AI. Để biết thông tin chính xác, vui lòng tham khảo phiên bản tiếng Anh.

#Cài đặt Docker

Điều kiện tiên quyết
  • Đã cài đặt Docker và Docker Compose
  • Đảm bảo dịch vụ Docker đang chạy

#1. Tạo mới docker-compose.yml

# Tạo một thư mục tên là my-project (có thể là tên khác) để lưu trữ các tệp hệ thống do NocoBase tạo ra
mkdir my-project && cd my-project

# Tạo một tệp docker-compose.yml trống
vi docker-compose.yml

#2. Cấu hình docker-compose.yml

Chọn phiên bản NocoBase (So sánh phiên bản) và loại cơ sở dữ liệu, sao chép cấu hình tương ứng vào docker-compose.yml.

Giải thích cấu hình
  • Chọn image: latest latest-full beta beta-full alpha alpha-full 1.7.14 1.7.14-full
    • Đối với môi trường sản xuất, khuyến nghị cố định một phiên bản cụ thể để tránh việc tự động nâng cấp không mong muốn. Xem tất cả các phiên bản
    • Image Alibaba Cloud: registry.cn-shanghai.aliyuncs.com/nocobase/nocobase:latest-full
    • Image Docker Hub: nocobase/nocobase:latest-full
    • Image full bao gồm các client PostgreSQL 16/17, MySQL 8.0, Oracle 19.25 cần thiết cho các plugin quản lý sao lưu, quản lý di chuyển, cũng như LibreOffice cần thiết cho in mẫu (PDF).
    • Nếu cần tự xây dựng image, có thể tham khảo Dockerfile (phiên bản tinh giản) và Dockerfile-full (phiên bản đầy đủ) do chính thức cung cấp.
  • Sửa đổi APP_KEY: Vui lòng thay thế your-secret-key bằng một chuỗi ngẫu nhiên, dùng để mã hóa các thông tin nhạy cảm như token người dùng.
  • Sử dụng cơ sở dữ liệu hiện có: Nếu đã có dịch vụ cơ sở dữ liệu, vui lòng sửa DB_HOST thành địa chỉ máy chủ cơ sở dữ liệu, và xóa hoặc ghi chú (comment) cấu hình dịch vụ cơ sở dữ liệu (như các dịch vụ postgres, mysql, mariadb).
  • Ánh xạ cổng: Mặc định ánh xạ cổng 80 của container tới cổng 13000 của máy chủ, có thể sửa đổi tùy theo nhu cầu.
Phiên bản Latest
Phiên bản Beta
Phiên bản Alpha
PostgreSQL
MySQL
MariaDB
networks:
  nocobase:
    driver: bridge

services:
  app:
    image: registry.cn-shanghai.aliyuncs.com/nocobase/nocobase:latest-full
    restart: always
    networks:
      - nocobase
    depends_on:
      - postgres
    environment:
      # Khóa của ứng dụng, dùng để tạo token người dùng, v.v.
      # Nếu APP_KEY thay đổi, các token cũ cũng sẽ mất hiệu lực
      # Có thể là bất kỳ chuỗi ngẫu nhiên nào và đảm bảo không bị rò rỉ ra ngoài
      - APP_KEY=your-secret-key
      # Loại cơ sở dữ liệu, hỗ trợ postgres, mysql, mariadb
      - DB_DIALECT=postgres
      # Máy chủ cơ sở dữ liệu, có thể thay thế bằng IP máy chủ cơ sở dữ liệu hiện có
      - DB_HOST=postgres
      # Cổng cơ sở dữ liệu
      - DB_PORT=5432
      # Tên cơ sở dữ liệu
      - DB_DATABASE=nocobase
      # Người dùng cơ sở dữ liệu
      - DB_USER=nocobase
      # Mật khẩu cơ sở dữ liệu
      - DB_PASSWORD=nocobase
      # Múi giờ
      - TZ=Asia/Shanghai

    volumes:
      - ./storage:/app/nocobase/storage
    ports:
      - '13000:80'
    # init: true

  # Nếu sử dụng dịch vụ cơ sở dữ liệu hiện có, có thể không cần khởi động postgres
  postgres:
    image: registry.cn-shanghai.aliyuncs.com/nocobase/postgres:16
    restart: always
    command: postgres -c wal_level=logical
    environment:
      POSTGRES_USER: nocobase
      POSTGRES_DB: nocobase
      POSTGRES_PASSWORD: nocobase
    volumes:
      - ./storage/db/postgres:/var/lib/postgresql/data
    networks:
      - nocobase

#3. Cài đặt và khởi động NocoBase

# Tải về image mới nhất
docker compose pull

# Chạy trong nền (lần chạy đầu tiên sẽ tự động thực hiện cài đặt)
docker compose up -d

# Xem nhật ký cài đặt và vận hành
docker compose logs -f app

app-postgres-app-1  | nginx started
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ cross-env DOTENV_CONFIG_PATH=.env node -r dotenv/config packages/app/server/lib/index.js install -s
app-postgres-app-1  | Done in 2.72s.
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ pm2-runtime start --node-args="-r dotenv/config" packages/app/server/lib/index.js -- start
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: Launching in no daemon mode
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] starting in -fork mode-
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] online
app-postgres-app-1  | 🚀 NocoBase server running at: http://localhost:13000/

#4. Đăng nhập NocoBase

Sử dụng trình duyệt mở http://localhost:13000, tài khoản và mật khẩu khởi tạo là admin@nocobase.com và admin123.

Gợi ý an toàn tài khoản

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