# Hướng dẫn cài đặt & triển khai MaxKB

Trong thời đại AI bùng nổ, việc xây dựng một hệ thống hỏi đáp thông minh dựa trên dữ liệu nội bộ không còn là “nice-to-have” mà đã trở thành “must-have”. Đây chính là lúc **MaxKB** xuất hiện như một giải pháp cực kỳ đáng chú ý.

Trong bài viết này của **Cẩm nang NQDEV**, chúng ta sẽ cùng tìm hiểu:

* MaxKB là gì? Có gì nổi bật?
* So sánh nhanh với các hướng triển khai AI phổ biến
* Hướng dẫn cài đặt chi tiết (dễ làm, dễ áp dụng)

👉 Xem thêm nhiều bài chia sẻ tại: <https://blogs.nhquydev.net/>

***

## 🧠 MaxKB là gì?

**MaxKB (Max Knowledge Base)** là một nền tảng mã nguồn mở giúp xây dựng **AI Assistant dựa trên dữ liệu riêng (Private Knowledge AI)**.

Điểm đặc biệt của MaxKB:

* Sử dụng **RAG (Retrieval-Augmented Generation)** để giảm “ảo giác AI”
* Tích hợp workflow & automation
* Hỗ trợ nhiều mô hình AI (OpenAI, DeepSeek, Llama, Qwen…)
* Có thể triển khai on-premise (rất phù hợp doanh nghiệp)

👉 Nói đơn giản:\
MaxKB giúp bạn biến tài liệu nội bộ thành **chatbot thông minh như ChatGPT nhưng hiểu dữ liệu của riêng bạn**

📌 Theo tài liệu, MaxKB được dùng nhiều cho:

* Chatbot CSKH
* Knowledge base nội bộ
* Trợ lý nhân viên
* Giáo dục & nghiên cứu

***

## ⚔️ So sánh MaxKB với các hướng tiếp cận AI phổ biến

### 1. MaxKB vs ChatGPT API thuần

| Tiêu chí          | MaxKB         | ChatGPT API     |
| ----------------- | ------------- | --------------- |
| Dữ liệu riêng     | ✅ Tốt (RAG)   | ❌ Phải tự build |
| Triển khai        | ✅ On-premise  | ❌ Cloud         |
| Độ phức tạp       | ⚖️ Trung bình | ⚖️ Trung bình   |
| Kiểm soát dữ liệu | ✅ Cao         | ❌ Thấp          |

👉 Kết luận:\
MaxKB phù hợp khi bạn muốn **AI hiểu dữ liệu nội bộ mà vẫn kiểm soát được hệ thống**

***

### 2. MaxKB vs LangChain tự build

| Tiêu chí  | MaxKB         | LangChain  |
| --------- | ------------- | ---------- |
| Setup     | ✅ Nhanh       | ❌ Phức tạp |
| UI        | ✅ Có sẵn      | ❌ Tự build |
| Workflow  | ✅ Có sẵn      | ❌ Code     |
| Linh hoạt | ⚖️ Trung bình | ✅ Cao      |

👉 Kết luận:

* Dev thích custom sâu → LangChain
* Muốn chạy nhanh → MaxKB

***

### 3. MaxKB vs các SaaS AI (Notion AI, Chatbase…)

| Tiêu chí        | MaxKB | SaaS        |
| --------------- | ----- | ----------- |
| Chi phí lâu dài | ✅ Rẻ  | ❌ Đắt       |
| Bảo mật         | ✅ Cao | ❌ Phụ thuộc |
| Tùy chỉnh       | ✅ Cao | ❌ Hạn chế   |

👉 MaxKB cực kỳ hợp với doanh nghiệp muốn **tự chủ AI**

***

## ⚙️ Hướng dẫn cài đặt MaxKB (dễ nhất cho người mới)

Có nhiều cách cài, nhưng trong bài này **Cẩm nang NQDEV** sẽ chọn cách đơn giản nhất:\
👉 Cài qua **1Panel (GUI, không cần dev nhiều)**

***

### 🔧 Cách 1: Cài MaxKB bằng 1Panel (Khuyên dùng)

#### Bước 1: Cài 1Panel

* Cài trên server Linux (Ubuntu, CentOS…)
* Truy cập dashboard 1Panel

***

#### Bước 2: Cài MaxKB

Trong 1Panel:

1. Vào **App Store**
2. Chọn mục **AI / LLM**
3. Tìm **MaxKB**
4. Nhấn Install

***

#### Bước 3: Cấu hình

Bạn cần điền:

* Port (mặc định: 8080)
* CPU / RAM
* Cho phép external access

Sau đó bấm **Confirm để cài**

***

#### Bước 4: Truy cập hệ thống

Sau khi cài xong:

```
http://IP:8080
User: admin
Pass: MaxKB@123..
```

👉 Lưu ý:

* Lần đầu đăng nhập sẽ yêu cầu đổi mật khẩu

***

### 🔌 Kết nối AI Model

Sau khi vào dashboard:

* Thêm API key:
  * OpenAI
  * DeepSeek
  * Claude
* Hoặc dùng model local

👉 Đây là bước quan trọng để MaxKB hoạt động

***

### 📂 Upload dữ liệu

Bạn có thể:

* Upload PDF, DOCX
* Crawl website
* Import tài liệu nội bộ

MaxKB sẽ:

* Tự chunk dữ liệu
* Vector hóa
* Tạo pipeline RAG

***

## ⚠️ Lưu ý quan trọng khi dùng MaxKB

* Luôn cập nhật version mới (tránh lỗ hổng bảo mật)
* Các version cũ từng có vấn đề như:
  * Remote command execution
  * Sandbox bypass

👉 Vì vậy: **đừng dùng bản quá cũ**

***

## 🎯 Khi nào nên dùng MaxKB?

Bạn nên dùng khi:

✅ Muốn làm chatbot nội bộ\
✅ Có tài liệu riêng (PDF, docs, wiki…)\
✅ Cần triển khai on-premise\
✅ Không muốn build từ đầu

***

## 🧩 Kết luận

MaxKB là một lựa chọn rất “đáng tiền” trong hệ sinh thái AI hiện nay:

* Dễ triển khai
* Mạnh về RAG + workflow
* Phù hợp doanh nghiệp vừa và nhỏ

👉 Nếu bạn đang tìm một nền tảng kiểu “ChatGPT nội bộ”, thì MaxKB là một điểm khởi đầu cực tốt.

***

📌 Gợi ý từ **Cẩm nang NQDEV**:

* Bắt đầu với 1Panel để làm quen
* Sau đó tối ưu pipeline RAG
* Cuối cùng build workflow automation