# Project NOMAD: máy chủ kiến thức chạy offline, kèm AI — hướng dẫn cài đặt và dùng

> Project NOMAD là một máy chủ kiến thức và giáo dục chạy offline. Nó gom Wikipedia, sách, khoá học Khan Academy, bản đồ, ghi chú và trợ lý AI cục bộ vào một giao diện web trên máy bạn tự sở hữu. Cài bằng một đoạn lệnh trên Ubuntu/Debian, nhưng phần AI cần cấu hình mạnh hơn nhiều so với phần lõi.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-11 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/project-nomad-may-chu-kien-thuc-offline-huong-dan-cai-dat

Project NOMAD là một máy chủ kiến thức và giáo dục "offline-first": bạn cài nó lên một máy Debian hoặc Ubuntu, rồi dùng trình duyệt để đọc Wikipedia, tra sách, học các khoá Khan Academy, xem bản đồ và chat với AI, tất cả chạy ngay trên phần cứng của bạn. Chỉ lúc cài và lúc tải thêm nội dung mới cần mạng. Sau đó bạn rút dây mạng ra vẫn dùng được.

Repo này hợp với ai? Người muốn có một "thư viện số" riêng không phụ thuộc internet: gia đình ở vùng mạng chập chờn, lớp học, nhóm làm việc nhỏ, hoặc người thích tự dựng hệ thống trên máy của mình. Dev mới cũng dùng được vì phần lớn thao tác nằm trong giao diện web, không phải gõ lệnh liên tục.

Điểm đáng giá nhất là nó không bắt bạn lắp ghép từng công cụ. NOMAD là một bảng điều khiển ("Command Center") tự cài và quản lý các công cụ nguồn mở như Kiwix, Kolibri, Ollama, Qdrant bằng Docker. Hiện repo có khoảng 43.297 sao và 4.453 fork, giấy phép Apache-2.0. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi cài.

```repo
- repo | Crosstalk-Solutions/project-nomad
- kind | Ứng dụng
- desc | Project NOMAD biến một máy Debian/Ubuntu thành máy chủ kiến thức offline: Wikipedia, sách, khoá học, bản đồ và trợ lý AI chạy cục bộ, truy cập qua trình duyệt.
- stars | 43k
- lang | TypeScript
- license | Apache-2.0
```

```video
- youtube | https://youtube.com/shorts/2ZigBzWV8mY
- facebook | https://www.facebook.com/reel/1439632627525358
- title | Video giới thiệu project-nomad
```

## Project NOMAD làm được gì

Mỗi tính năng của NOMAD thực chất là một công cụ có sẵn, được gói lại để cài một chỗ và quản lý một chỗ. Đây là những phần chính theo README.

### Thư viện thông tin

Dùng Kiwix để chứa Wikipedia offline, tài liệu y tế, sách điện tử và nhiều nội dung khác. Lợi ích thực tế: tra cứu nhanh mà không tốn dữ liệu di động, và không lo trang bị chặn hay mạng sập. NOMAD còn có công cụ chọn nội dung Wikipedia, trình quản lý thư viện ZIM và trình khám phá nội dung để bạn chọn đúng thứ cần tải.

### Trợ lý AI có kho tri thức riêng

Chat AI chạy cục bộ nhờ Ollama, hoặc bạn nối với phần mềm tương thích OpenAI API như LM Studio hay llama.cpp. Bạn có thể tải tài liệu lên, và AI tìm kiếm theo ngữ nghĩa trong đó (kỹ thuật RAG, dùng Qdrant). Nghĩa là bạn hỏi về tài liệu của chính mình mà không phải gửi đi đâu.

### Nền tảng học tập

Kolibri mang các khoá Khan Academy vào máy, có theo dõi tiến độ và hỗ trợ nhiều người dùng. Phù hợp cho lớp học hoặc con em học bài khi không có mạng.

### Bản đồ offline, ghi chú, công cụ dữ liệu

ProtoMaps cho bạn tải bản đồ theo vùng để xem và tìm kiếm khi offline. FlatNotes là ứng dụng ghi chú hỗ trợ markdown. CyberChef gồm các công cụ mã hoá, giải mã, băm và phân tích dữ liệu.

### Kho ứng dụng và đo cấu hình

"Supply Depot" là danh mục ứng dụng cài một cú nhấp (công cụ PDF, trình duyệt file, thư viện ebook, trình quản lý mật khẩu…), và bạn có thể chạy thêm container Docker của riêng mình. Ngoài ra có phần đo hiệu năng phần cứng với bảng xếp hạng cộng đồng, tự động cập nhật (tuỳ chọn bật) và trình hướng dẫn cài đặt lần đầu với các bộ nội dung tuyển sẵn.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **Hệ điều hành Debian-based.** Khuyến nghị Ubuntu 26.04 LTS; Ubuntu 24.04 LTS và Debian 12 cũng được hỗ trợ. Cài đặt hoàn toàn bằng terminal, còn việc dùng thì qua trình duyệt, nên không cần giao diện desktop nếu bạn muốn dựng như một máy chủ.
- **Quyền sudo/root** để chạy script cài.
- **Internet ổn định** trong lúc cài (và khi bạn tải thêm nội dung sau này).
- **Cấu hình tối thiểu cho phần lõi:** CPU 2 GHz hai nhân trở lên, RAM 4 GB (cả hệ thống không có AI chạy dưới 1 GB), ổ đĩa trống tối thiểu 5 GB, nên chuẩn bị 10 GB cho thoải mái.
- **Nếu muốn dùng AI:** cài thêm trợ lý AI đưa tổng dung lượng lên khoảng 25 GB. Cấu hình tối ưu README đề xuất là Ryzen 7 hoặc Core i7 trở lên, RAM 32 GB, card đồ hoạ NVIDIA RTX 3060 hoặc AMD tương đương trở lên, ổ trống ít nhất 250 GB, tốt nhất là SSD. Mô hình AI cần bộ nhớ gần bằng dung lượng tải về khi trả lời; bộ nhớ đó lấy từ VRAM nếu có card rời, còn không thì lấy từ RAM hệ thống.
- **Người dùng Windows:** README nói có hướng dẫn cài qua WSL2, là đường do cộng đồng hỗ trợ, gồm cả cách dùng Docker thường lẫn Docker Desktop. Xem trang hướng dẫn WSL2 trên website dự án.

Còn phần offline: dung lượng thật sự phụ thuộc bạn tải gì về. Từng bộ nội dung nặng bao nhiêu, xem FAQ của dự án.

## Cài đặt từng bước

```steps
- Chuẩn bị máy | Dùng Ubuntu/Debian, mở terminal, có quyền sudo và internet
- Chạy script cài | Dán đoạn lệnh cài nhanh trong README
- Mở giao diện web | Vào http://localhost:8080 hoặc http://IP_MÁY:8080
- Chạy trình hướng dẫn | Chọn bộ nội dung và công cụ muốn cài
- Tắt/bật khi cần | Dùng các script start/stop trong /opt/project-nomad
```

### Mở terminal trên máy Debian/Ubuntu

Bạn gõ lệnh trên chính máy sẽ chạy NOMAD (hoặc SSH vào nó). Chỗ người mới hay vấp: lệnh cài cần `sudo`, nên tài khoản của bạn phải có quyền quản trị.

### Chạy lệnh cài nhanh

Đây là lệnh nguyên văn trong README. Nó cập nhật danh sách gói, cài `curl`, tải script cài về rồi chạy bằng quyền root:

```bash
sudo apt-get update && \
sudo apt-get install -y curl && \
curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/install_nomad.sh \
  -o install_nomad.sh && \
sudo bash install_nomad.sh
```

Hãy dán nguyên cả khối, kể cả dấu `\` cuối dòng (dấu này nối lệnh sang dòng kế tiếp). Quá trình cài cần mạng vì phải tải thành phần về. Đợi đến khi script chạy xong, đừng ngắt giữa chừng.

```note
Script cài chạy bằng quyền root và tải từ internet. Nếu bạn muốn kiểm tra trước, hãy tải file install_nomad.sh về, mở ra đọc rồi mới chạy bằng sudo bash. NOMAD cũng mặc định không có đăng nhập, nên đừng mở nó thẳng ra internet.
```

### Mở giao diện web

Theo README, cài xong bạn mở trình duyệt và vào `http://localhost:8080` nếu đang ngồi ở chính máy đó, hoặc `http://DEVICE_IP:8080` (thay DEVICE_IP bằng địa chỉ IP của máy chủ) nếu truy cập từ máy khác trong mạng. Sau đó làm theo trình hướng dẫn thiết lập lần đầu để chọn bộ nội dung.

### Cách cài nâng cao bằng Docker Compose

Nếu bạn quen Docker, README cho phép tải mẫu Docker Compose, lưu thành `docker-compose.yml`, thay các chỗ giữ chỗ bằng giá trị thật, rồi chạy:

```bash
docker compose up -d
```

README khuyên cách này chỉ dành cho người dùng nâng cao vì phải tự cấu hình trước. Người mới nên dùng lệnh cài nhanh ở trên.

### Các script quản lý sau khi cài

Tất cả nằm trong thư mục cài đặt `/opt/project-nomad`. Khởi động mọi container:

```bash
sudo bash /opt/project-nomad/start_nomad.sh
```

Dừng mọi container:

```bash
sudo bash /opt/project-nomad/stop_nomad.sh
```

Cập nhật Command Center và các thành phần đi kèm (như mysql):

```bash
sudo bash /opt/project-nomad/update_nomad.sh
```

Lưu ý README: script này chỉ cập nhật Command Center. Các ứng dụng cài thêm phải cập nhật trong giao diện web.

## Kiểm tra đã chạy được chưa

Cách kiểm tra đơn giản nhất theo README: mở `http://localhost:8080` (hoặc `http://DEVICE_IP:8080`) và thấy giao diện NOMAD hiện lên. Nếu thấy, phần lõi đã chạy.

Từ đó, hãy chạy trình hướng dẫn thiết lập để cài thử một công cụ nhỏ, ví dụ thư viện thông tin hoặc ghi chú, rồi mở nó lên xem. Nếu cài AI, thử chat một câu ngắn để biết mô hình có trả lời được không.

Nếu trang không lên, thử chạy lại script khởi động `start_nomad.sh` ở trên, rồi tải lại trang. README chưa mô tả lệnh kiểm tra trạng thái riêng nào khác.

## Dùng vào việc thật

### Lớp học hoặc gia đình ở nơi mạng yếu

Bối cảnh: bạn là giáo viên hoặc phụ huynh ở nơi internet chập chờn, muốn các em có tài liệu học đàng hoàng. Bạn cài NOMAD lên một máy trong nhà hoặc trường, dùng trình hướng dẫn chọn bộ nội dung, rồi cài Kolibri để có khoá Khan Academy và Kiwix để có Wikipedia. Các thiết bị khác trong mạng nội bộ chỉ cần mở `http://IP_MÁY:8080`.

Kết quả: học sinh học bài, tra cứu và được theo dõi tiến độ mà không cần mạng. Chỉ lần đầu tải nội dung mới tốn dữ liệu.

> Cài một lần, tải nội dung một lần, sau đó cả nhà dùng không cần mạng.
>
> — Ông T

### Văn phòng nhỏ hỏi AI về tài liệu nội bộ

Bối cảnh: bạn làm hành chính hoặc kinh doanh, có nhiều file quy trình, báo giá, hướng dẫn nhân viên mới và không muốn đưa lên dịch vụ AI bên ngoài. Bạn cài AI Assistant trên một máy đủ mạnh, tải tài liệu lên phần chat, rồi hỏi bằng ngôn ngữ thường. Prompt mẫu:

```text
Dựa trên tài liệu đã tải lên, tóm tắt quy trình nhận đơn hàng thành 5 bước ngắn.
```

Kết quả: AI tìm đoạn liên quan trong kho tài liệu (nhờ tìm kiếm ngữ nghĩa) rồi trả lời. README nhắc rằng chất lượng và tốc độ phụ thuộc phần cứng và mô hình bạn chọn, nên hãy thử với vài file nhỏ trước.

### Dev tách AI ra máy khỏe hơn

Bối cảnh: bạn có một máy chủ nhỏ chạy NOMAD, nhưng card đồ hoạ mạnh nằm ở máy khác. README cho phép vào phần cài đặt của AI Assistant và nhập URL của máy chủ Ollama hoặc máy chủ tương thích OpenAI (như LM Studio). Nếu dùng Ollama trên máy khác, phải khởi động nó với tuỳ chọn `OLLAMA_HOST=0.0.0.0`.

```bash
OLLAMA_HOST=0.0.0.0
```

Đây là biến môi trường nguyên văn trong README; cách đặt nó khi chạy Ollama tuỳ hệ điều hành của máy đó, và bạn tự chịu trách nhiệm thiết lập. Với LM Studio, bạn phải tải mô hình bằng chính LM Studio vì giao diện OpenAI API không hỗ trợ tải mô hình.

### Chuẩn bị chuyến đi xa không sóng

Bối cảnh: bạn đi công tác hoặc du lịch vùng sâu. Trước khi đi, vào NOMAD tải bản đồ khu vực bằng ProtoMaps, thêm tài liệu tham khảo vào Kiwix và ghi chú hành trình bằng FlatNotes. Khi đến nơi, bạn mở lại giao diện trên laptop hoặc mini PC mang theo.

Kết quả: có bản đồ xem và tìm kiếm được, có tài liệu để đọc, có chỗ ghi chú markdown, tất cả offline. Còn dung lượng bản đồ từng vùng, README không nêu; xem FAQ của dự án.

## Lỗi hay gặp và cách xử lý

### Mở localhost:8080 không thấy gì

Có thể các container chưa chạy hoặc script cài chưa hoàn tất. Thử chạy `sudo bash /opt/project-nomad/start_nomad.sh`, đợi một lúc rồi tải lại trang. Nếu truy cập từ máy khác, kiểm tra bạn đã dùng đúng IP của máy chủ và tường lửa không chặn cổng 8080.

### Chạy script cài trên Windows hoặc hệ điều hành không phải Debian

Lệnh cài nhanh chỉ dành cho hệ Debian-based. Trên Windows, README trỏ tới hướng dẫn WSL2 do cộng đồng hỗ trợ. Hãy theo hướng dẫn đó thay vì tự chế lệnh.

### Hết dung lượng ổ đĩa

Phần lõi nhẹ nhưng nội dung offline và AI thì rất nặng (AI Assistant đưa tổng dung lượng lên khoảng 25 GB). Hãy chọn từng bộ nội dung vừa đủ, kiểm tra dung lượng trống trước khi tải. Nếu cần nhiều chỗ, README đề xuất ít nhất 250 GB cho cấu hình có AI.

### AI chậm hoặc máy bị đơ khi chat

Mô hình cần bộ nhớ gần bằng dung lượng tải về khi trả lời. Máy không có card rời sẽ dùng RAM hệ thống nên dễ nghẽn. Hãy thử mô hình nhỏ hơn, hoặc chạy AI trên máy khác mạnh hơn rồi nhập URL vào phần cài đặt AI Assistant như đã nói ở trên.

### Máy khác trong mạng vào được nhưng ai cũng vào được

Đây là thiết kế chứ không phải lỗi: NOMAD không có xác thực. README khuyên dùng kiểm soát ở tầng mạng (chặn hoặc mở cổng) nếu bạn chia sẻ trong mạng nội bộ, và khuyên mạnh là đừng đưa nó ra thẳng internet trừ khi bạn hiểu rõ rủi ro.

## Có nên dùng không

**Điểm mạnh.** Cài bằng một đoạn lệnh, dùng bằng trình duyệt, gom nhiều công cụ offline vào một chỗ. README cho biết nó không có telemetry tích hợp, nên dữ liệu của bạn ở lại trên máy bạn. Giấy phép Apache-2.0 và dự án vẫn được cập nhật trong vài tháng gần đây. Phần lõi nhẹ, chạy được trên máy yếu nếu bạn không dùng AI.

**Giới hạn.** Chỉ hỗ trợ hệ Debian-based; Windows chỉ qua WSL2 do cộng đồng hỗ trợ. Muốn AI chạy mượt cần cấu hình mạnh và nhiều dung lượng. Chưa có đăng nhập hay phân quyền, nên không hợp với trường hợp cần nhiều người dùng với quyền khác nhau; README nói tính năng này có thể được cân nhắc nếu đủ nhu cầu. Cuối cùng, việc cài thêm thành phần vẫn cần internet.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ cần tra Wikipedia offline trên một máy, một ứng dụng đọc offline đơn giản có thể là đủ. Nếu bạn cần hệ thống nhiều người dùng có phân quyền chặt, hoặc muốn đưa dịch vụ ra internet, NOMAD hiện chưa phải lựa chọn phù hợp. Còn nếu bạn muốn một "kho tri thức tự chủ" tại nhà hoặc lớp học, đây là cách bắt đầu khá gọn.

## Câu hỏi thường gặp

### Project NOMAD có miễn phí không?

Repo dùng giấy phép Apache-2.0 và README không nói về phí sử dụng phần mềm. Bạn vẫn cần tự chuẩn bị phần cứng và dung lượng ổ đĩa. Chi phí nội dung hay dịch vụ bên thứ ba (nếu có) README chưa có thông tin.

### Có cần GPU không?

Không bắt buộc cho phần lõi: README nói cả hệ thống không có AI chạy dưới 1 GB RAM. GPU chỉ nên có nếu bạn muốn dùng AI Assistant mượt; cấu hình tối ưu đề xuất là RTX 3060 hoặc AMD tương đương trở lên. Không có card rời thì mô hình dùng RAM hệ thống, sẽ nặng hơn.

### Chạy được trên Windows không?

Script cài nhanh dành cho hệ Debian-based (khuyến nghị Ubuntu 26.04 LTS, ngoài ra có Ubuntu 24.04 LTS và Debian 12). Với Windows, README nhắc tới hướng dẫn cài qua WSL2 do cộng đồng hỗ trợ, trên website dự án.

### Dữ liệu của tôi có an toàn không?

README nói NOMAD không có telemetry tích hợp và chỉ cần internet khi cài hoặc khi bạn tải thêm nội dung. Tuy nhiên nó không có xác thực, nên nếu mở cho các máy khác trong mạng, bạn nên kiểm soát cổng ở tầng mạng và không đưa thẳng ra internet.

### Cần bao nhiêu dung lượng ổ đĩa?

Phần lõi cần khoảng 5 GB, nên chuẩn bị 10 GB cho thoải mái. Thêm AI Assistant thì tổng khoảng 25 GB. Cấu hình tối ưu đề xuất ít nhất 250 GB trống, nhưng dung lượng thực tế còn tuỳ nội dung offline bạn tải.

### Có dùng AI ở máy khác được không?

Có. Trong phần cài đặt AI Assistant, bạn nhập URL của máy chủ Ollama hoặc máy chủ tương thích OpenAI như LM Studio. Với Ollama ở máy khác, cần khởi động với OLLAMA_HOST=0.0.0.0. Với LM Studio thì phải tải mô hình ngay trong LM Studio.

### Khác gì việc tự cài từng công cụ như Kiwix hay Kolibri?

README mô tả NOMAD là giao diện quản lý và API điều phối các công cụ đóng gói bằng Docker, lo phần cài đặt, cấu hình và cập nhật cho bạn. Tức là bạn không phải tự lắp từng công cụ. Về so sánh chi tiết với các giải pháp khác, tư liệu chưa có thông tin.
