← Tất cả bài viết

Cài NocoBase lên VPS bằng Docker cho người không phải IT — hướng dẫn từng bước có hình

bởi BAMFLOW • • 13 phút đọc

Hướng dẫn cài đặt NocoBase bằng Docker trên VPS cho người không phải IT: từng bước có hình, gắn tên miền, HTTPS, backup tự động trong 30 phút.

cover-final

Cài NocoBase lên VPS bằng Docker cho người không phải IT — hướng dẫn từng bước có hình

Tóm tắt nhanh: Cài đặt NocoBase không cần bạn là dân IT. Với cách cài bằng NocoBase Docker, bạn chỉ cần một VPS phổ thông, một tên miền và khoảng 30 phút làm đúng từng bước trong bài này: cài Docker, chạy một file cấu hình ngắn, gắn tên miền, bật HTTPS, tạo tài khoản quản trị đầu tiên và bật sao lưu tự động.

Nghe đến "tự cài phần mềm lên máy chủ", nhiều chủ doanh nghiệp thường lắc đầu: việc này để IT lo. Nhưng cài đặt NocoBase bằng Docker đã gọn đến mức người không chuyên cũng làm được — nếu có người chỉ đúng thứ tự từng bước và giải thích mỗi lệnh đang làm gì. Mọi lệnh trong bài đều có sẵn để copy, mỗi bước đều có cách kiểm tra "xong chưa". Nếu chưa rõ NocoBase là gì, hãy đọc trước bài NocoBase là gì? rồi quay lại đây.

1. Tự host nghĩa là gì, bằng ví dụ cái tủ hồ sơ của công ty

Hãy tưởng tượng toàn bộ dữ liệu của công ty — hồ sơ khách hàng, đơn hàng, phiếu thu chi, bảng lương — là những tập hồ sơ giấy trong văn phòng.

Khi dùng một phần mềm thuê theo tháng, giống như bạn thuê một phòng lưu trữ ở tòa nhà của người khác. Phòng sạch, có bảo vệ, nhưng chìa khóa nằm trong tay chủ tòa nhà. Họ đổi quy định, tăng giá thuê hay ngừng cho thuê, bạn phải dọn đi theo điều kiện của họ. Dữ liệu của bạn, nhưng đặt trên đất của người ta.

Tự host (self-host) là bạn tự mua một cái tủ hồ sơ và đặt nó trong phòng của mình. Cái tủ ở đây chính là chiếc VPS — một máy tính luôn bật tại trung tâm dữ liệu, mà bạn thuê riêng. Bạn giữ chìa khóa, quyết định ai được mở ngăn nào, sao lưu mang đi đâu. Cái giá phải trả là trách nhiệm: tủ của mình thì mình phải khóa cẩn thận. Đổi lại, bạn không trả phí phần mềm theo từng nhân viên, và những dữ liệu quan trọng nhất — công nợ, giá vốn, lương thưởng — luôn nằm trong tầm tay bạn.

Vậy Docker nằm ở đâu trong ví dụ này? Hãy hình dung Docker là một chiếc hộp đóng gói sẵn: thay vì tự lắp từng ngăn kéo, ổ khóa, bản lề, nhà sản xuất đóng sẵn phần mềm NocoBase và các thành phần nó cần vào một hộp, đúng phiên bản đi kèm nhau. Bạn chỉ việc đặt hộp lên VPS và mở ra — nên máy nào cài cũng cho cùng một kết quả.

Đây cũng là cách BAMFLOW chọn cho phần lớn dự án của khách hàng. BAMFLOW là đối tác chính thức của NocoBase tại Việt Nam, đã triển khai 300+ ứng dụng, phục vụ 150+ khách hàng doanh nghiệp và đào tạo 1000+ học viên. Khâu cài đặt chỉ chiếm một buổi — giá trị nằm ở chỗ doanh nghiệp làm chủ hệ thống của mình nhiều năm sau đó.

2. Chuẩn bị: VPS tối thiểu, tên miền, 30 phút

Cài đặt NocoBase cần ba thứ. Thiếu một trong ba, bạn sẽ phải dừng giữa chừng, nên hãy chuẩn bị đủ trước khi gõ lệnh đầu tiên.

Một, một chiếc VPS. Đây là máy chủ ảo thuê theo tháng tại các nhà cung cấp trong và ngoài nước. Với đội ngũ nhỏ và vừa, một VPS phổ thông là đủ để bắt đầu:

Hạng mụcMức nên có để bắt đầu
CPU2 nhân trở lên
RAM4 GB trở lên
Ổ cứng40 GB SSD trở lên
Hệ điều hànhUbuntu 22.04 hoặc 24.04 (bản LTS)

Một VPS như vậy thường chỉ ở mức vài trăm nghìn đồng/tháng — rẻ hơn nhiều so với tổng hóa đơn phần mềm tính theo đầu người khi đội ngũ lớn dần. Khi đăng ký, nhà cung cấp sẽ gửi bạn địa chỉ IP, tài khoản quản trị (thường là root) và mật khẩu của VPS. Hãy lưu ba thông tin này vào nơi an toàn.

Hai, một tên miền. Thay vì bắt nhân viên nhớ một dãy số IP, bạn gắn hệ thống vào một tên miền dễ đọc, ví dụ app.tencongty.vn. Nếu công ty đã có website, chỉ cần tạo thêm một tên miền con (subdomain), không tốn tiền mua tên miền mới. Việc gắn tên miền sẽ làm ở mục 4, sau khi hệ thống đã chạy.

Ba, khoảng 30 phút và một máy tính có mạng. Bạn sẽ thao tác qua cửa sổ dòng lệnh (Terminal trên Mac, PowerShell trên Windows) — chỉ là một ô cửa sổ để dán lệnh và nhấn Enter.

Lưu ý về phiên bản: NocoBase được cập nhật thường xuyên. Bài này dùng cú pháp Docker Compose và bản cài NocoBase Docker phổ thông tại thời điểm viết. Nếu khi bạn cài, giao diện hoặc tên biến cấu hình có khác đôi chút, hãy đối chiếu với tài liệu chính thức của NocoBase (docs.nocobase.com) — đó luôn là nguồn đúng cuối cùng.

3. Cài Docker + cài đặt NocoBase từng lệnh, có ảnh chụp từng bước

Đây là phần chính của bài. Hãy làm chậm, đúng thứ tự.

Bước 1: Đăng nhập vào VPS

Mở cửa sổ dòng lệnh trên máy tính và gõ lệnh sau, thay địa chỉ IP mẫu bằng IP VPS của bạn:

ssh root@123.123.123.123

Lần đầu kết nối, máy hỏi có tin tưởng máy chủ này không — gõ yes rồi Enter, sau đó nhập mật khẩu VPS. Khi gõ mật khẩu, màn hình không hiện ký tự nào; đó là bình thường, cứ gõ hết rồi Enter. Đăng nhập thành công khi dòng lệnh chuyển thành dạng root@...:~#. Từ đây, mọi lệnh bạn gõ đều chạy trên VPS.

Bước 2: Cài Docker

Docker chưa có sẵn trên VPS mới, nên ta cài nó trước. Chạy lần lượt hai lệnh — một lệnh tải bản cài chính thức của Docker, một lệnh chạy bản cài đó:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Quá trình cài mất khoảng 1–3 phút. Kiểm tra lại bằng hai lệnh:

docker --version
docker compose version

Nếu màn hình trả về số phiên bản, phần khó nhất đã xong. Docker Compose là công cụ giúp "bật" cả hệ thống chỉ bằng một file cấu hình ngắn ở bước sau.

Bước 3: Tạo file cấu hình cho NocoBase Docker

Tạo một thư mục riêng cho hệ thống rồi đi vào thư mục đó:

mkdir -p /opt/nocobase
cd /opt/nocobase

Tiếp theo, tạo file cấu hình tên là docker-compose.yml:

nano docker-compose.yml

Một trình soạn thảo đơn giản sẽ mở ra. Dán toàn bộ nội dung dưới đây vào. Đây là "bản kê khai" cho Docker biết hệ thống gồm những gì:

services:
  nocobase:
    image: nocobase/nocobase:latest
    container_name: nocobase
    restart: always
    environment:
      APP_KEY: 'thay-bang-chuoi-bi-mat-dai-cua-rieng-ban'
      DB_DIALECT: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_DATABASE: nocobase
      DB_USER: nocobase
      DB_PASSWORD: 'thay-bang-mat-khau-database-that-manh'
      TZ: Asia/Ho_Chi_Minh
    ports:
      - '13000:13000'
    volumes:
      - ./storage:/app/nocobase/storage
    depends_on:
      - db

  db:
    image: postgres:16
    container_name: nocobase-db
    restart: always
    environment:
      POSTGRES_DB: nocobase
      POSTGRES_USER: nocobase
      POSTGRES_PASSWORD: 'thay-bang-mat-khau-database-that-manh'
    volumes:
      - ./db-data:/var/lib/postgresql/data

Đọc bằng ngôn ngữ đời thường, file này nói ba điều. Hệ thống gồm hai phần: phần mềm NocoBase (bản đóng gói chính thức nocobase/nocobase) và một cơ sở dữ liệu PostgreSQL. NocoBase mở ra ngoài qua cổng 13000 — cổng mặc định của nó. Mọi tệp đính kèm được lưu vào thư mục ./storage, nối với đường dẫn /app/nocobase/storage bên trong hộp Docker — nhờ vậy, tắt hay nâng cấp hộp thì tệp vẫn nằm yên trên VPS.

Hai giá trị bạn bắt buộc phải tự đặt: APP_KEY — chuỗi bí mật dài, ngẫu nhiên, không trùng mật khẩu nào khác; và DB_PASSWORD — mật khẩu cơ sở dữ liệu, phải giống hệt nhau ở cả hai chỗ trong file, lệch một ký tự là hệ thống không kết nối được dữ liệu. Trong nano, nhấn Ctrl + O rồi Enter để lưu, Ctrl + X để thoát.

Bước 4: Khởi động hệ thống

Vẫn đang ở thư mục /opt/nocobase, chạy một lệnh duy nhất:

docker compose up -d

Docker sẽ tự tải bản đóng gói NocoBase và PostgreSQL về rồi khởi động cả hai — lần đầu có thể mất vài phút tùy tốc độ mạng. Kiểm tra trạng thái bằng lệnh:

docker compose ps

Khi cả hai dòng đều ở trạng thái đang chạy (Up / running), hệ thống đã lên. Muốn xem hệ thống đang làm gì trong lúc khởi động, dùng lệnh docker compose logs -f nocobase và nhấn Ctrl + C để thoát khi thấy thông báo sẵn sàng.

Bước 5: Mở NocoBase lần đầu

Mở trình duyệt và truy cập http://IP-VPS-cua-ban:13000 (thay bằng IP thật). Nếu không mở được, nhiều khả năng tường lửa của nhà cung cấp VPS chưa mở cổng 13000 — vào trang quản trị VPS và mở cổng này, đây là chỗ người mới hay vướng nhất và cũng dễ xử lý nhất.

Màn hình đầu tiên hiện ra chính là giao diện NocoBase sau khi cài đặt xong:

Giao diện cài đặt NocoBase sau khi cài đặt xong bằng Docker trên VPS
Giao diện cài đặt NocoBase sau khi cài đặt xong bằng Docker trên VPS

Thấy được màn hình này nghĩa là cài đặt NocoBase đã thành công. Nhưng hệ thống vẫn đang dùng địa chỉ IP và giao thức chưa mã hóa — bước tiếp theo biến nó thành một địa chỉ tử tế, an toàn để cả công ty dùng lâu dài.

4. Gắn tên miền + HTTPS + tạo tài khoản admin đầu tiên

Gắn tên miền về VPS

Vào trang quản lý tên miền của công ty, tạo một bản ghi mới: loại A, tên là tên miền con bạn chọn (ví dụ app), giá trị là địa chỉ IP của VPS. Chờ vài phút đến vài chục phút để hệ thống tên miền cập nhật. Kiểm tra nhanh bằng cách truy cập http://app.tencongty.vn:13000 — nếu vẫn mở được NocoBase, tên miền đã trỏ đúng.

Thêm lớp trung gian và bật HTTPS

Để bỏ số :13000 khỏi địa chỉ và bật ổ khóa HTTPS, ta cần một "lễ tân" đứng trước là Nginx: nó nhận khách ở cổng web thông thường (80/443) rồi chuyển vào cổng 13000 bên trong. Cài Nginx cùng công cụ cấp chứng chỉ miễn phí của Let's Encrypt:

sudo apt install -y nginx certbot python3-certbot-nginx

Tạo file cấu hình cho tên miền của bạn:

sudo nano /etc/nginx/sites-available/nocobase

Dán nội dung sau vào (thay tên miền mẫu bằng tên miền thật):

server {
    listen 80;
    server_name app.tencongty.vn;

    location / {
        proxy_pass http://127.0.0.1:13000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Kích hoạt cấu hình, kiểm tra lỗi, rồi xin chứng chỉ HTTPS:

sudo ln -s /etc/nginx/sites-available/nocobase /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d app.tencongty.vn

Certbot sẽ hỏi email và điều khoản — trả lời theo hướng dẫn trên màn hình. Xong xuôi, truy cập https://app.tencongty.vn: trình duyệt hiện ổ khóa, địa chỉ không còn số cổng, dữ liệu đăng nhập của nhân viên được mã hóa trên đường truyền. Chứng chỉ được Certbot tự gia hạn, bạn không phải nhớ lịch.

Tạo tài khoản admin đầu tiên

Quay lại giao diện NocoBase, hệ thống sẽ hướng dẫn bạn hoàn tất thiết lập ban đầu và tạo tài khoản quản trị (admin) đầu tiên — tài khoản có toàn quyền. Hãy đặt một mật khẩu thật mạnh, khác mọi mật khẩu đang dùng, và lưu vào trình quản lý mật khẩu của công ty. Đây là "chìa khóa tổng" của cả tủ hồ sơ.

Đăng nhập xong, bạn vào không gian làm việc chính của NocoBase. Từ hệ thống trống này, việc tạo bảng dữ liệu, dựng màn hình, phân quyền theo phòng ban mới là phần xây dựng nghiệp vụ thật sự:

Dashboard mẫu sau đăng nhập — kết quả cài đặt NocoBase hoàn tất trên VPS
Dashboard mẫu sau đăng nhập — kết quả cài đặt NocoBase hoàn tất trên VPS

5. Việc phải làm ngay sau cài: đổi mật khẩu, bật backup tự động

Cài xong chưa phải là xong. Một hệ thống tự host chỉ an toàn khi chủ của nó làm đủ vài việc nhỏ ngay trong ngày đầu tiên.

Việc 1 — Rà lại toàn bộ mật khẩu. Nếu trong quá trình cài bạn từng dùng mật khẩu tạm ở bất kỳ bước nào, hoặc mật khẩu VPS do nhà cung cấp gửi sẵn qua email, hãy đổi tất cả ngay: mật khẩu admin NocoBase, mật khẩu root của VPS. Đồng thời tạo thêm một tài khoản admin thứ hai cho người phụ trách dự phòng — tránh cảnh một người nghỉ việc là cả công ty mất quyền quản trị.

Việc 2 — Bật sao lưu (backup) tự động mỗi ngày. Dữ liệu của hệ thống nằm ở hai nơi: cơ sở dữ liệu PostgreSQL (đơn hàng, khách hàng, công nợ...) và thư mục storage (tệp đính kèm, ảnh tải lên). Backup đúng nghĩa là phải cất cả hai, mỗi ngày. Ở mức cơ bản, đặt một lịch chạy tự động (cron) trên VPS để mỗi đêm hệ thống tự xuất dữ liệu bằng hai lệnh:

docker exec nocobase-db pg_dump -U nocobase nocobase > backup-db-$(date +%F).sql
tar -czf backup-storage-$(date +%F).tar.gz /opt/nocobase/storage

Lệnh thứ nhất xuất toàn bộ cơ sở dữ liệu ra một tệp theo ngày; lệnh thứ hai nén thư mục tệp đính kèm. Quan trọng nhất: chép hai tệp này về một nơi khác ngoài chiếc VPS — bản sao lưu nằm cùng máy với dữ liệu gốc thì khi máy hỏng, cả hai mất cùng lúc. Chủ đề này rất dễ làm sai ở chi tiết nhỏ, nên BAMFLOW đã viết riêng một bài phân tích: những sai lầm khi tự host NocoBase về backup và bảo mật.

Việc 3 — Khóa bớt cửa không cần thiết và cập nhật có kỷ luật. Rà lại tường lửa của VPS: chỉ mở các cổng thật sự cần (cổng quản trị, 80 và 443 cho web). Chỉ nâng cấp NocoBase sau khi đã có bản sao lưu mới nhất, và luôn đối chiếu tài liệu chính thức của NocoBase trước khi nâng cấp.

Làm đủ ba việc trên là bạn đã đi qua phần "lắp tủ". Phần còn lại — dựng bảng dữ liệu, màn hình và quy trình đúng nghiệp vụ công ty — là phần thú vị nhất, và cũng là phần BAMFLOW dạy xuyên suốt trong khóa học của mình.

Nếu phần dòng lệnh vẫn hơi rối, hoặc công ty không có ai trông coi sao lưu và cập nhật lâu dài, bạn không nhất thiết phải tự làm. BAMFLOW có dịch vụ cài đặt & bàn giao trọn gói: cài NocoBase lên VPS của doanh nghiệp, gắn tên miền, bật HTTPS và sao lưu tự động, rồi bàn giao kèm hướng dẫn vận hành. Chỉ cần nhắn cho BAMFLOW qua bamflow.vn và nói rõ nhu cầu của bạn.

Về BAMFLOW — BAMFLOW là đối tác chính thức của NocoBase tại Việt Nam, chuyên triển khai và đào tạo AppSheet, NocoBase và AI cho doanh nghiệp (300+ ứng dụng, 150+ khách hàng, 1000+ học viên).

  • Muốn tự xây hệ thống cho doanh nghiệp mình? Đăng ký khóa NocoBase AI Builder (12 buổi) — học cách dựng hệ thống thật trên chính dữ liệu của bạn, bắt đầu từ chính khâu cài đặt trong bài này.
  • Muốn triển khai nhanh cho doanh nghiệp? Nhắn cho BAMFLOW qua bamflow.vn để được tư vấn theo đúng nghiệp vụ của bạn.
Read in English RSS