# Project NOMAD: máy chủ tri thức offline, có AI nội bộ — hướng dẫn cài đặt và dùng

> Project NOMAD là máy chủ tri thức và giáo dục offline-first: cài lên máy Debian/Ubuntu rồi mở bằng trình duyệt để dùng Wikipedia, khoá học Khan Academy, bản đồ, ghi chú và trợ lý AI cục bộ. Cài bằng một đoạn lệnh trong terminal, cần sudo. Phần lõi nhẹ, nhưng muốn chạy AI thì cần máy mạnh hơn nhiều.

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

Project NOMAD là một máy chủ tri thức và giáo dục chạy offline. Bạn cài nó lên một máy Debian hoặc Ubuntu, rồi mở bằng trình duyệt để dùng Wikipedia, sách, khoá học, bản đồ, ghi chú và cả trợ lý AI. Mọi thứ chạy trên phần cứng của bạn, cài xong thì không cần internet để dùng.

Repo này hợp với ai? Mình thấy có mấy nhóm: người muốn có "kho kiến thức dự phòng" khi mạng yếu hoặc mất, thầy cô và trung tâm đào tạo muốn có tài liệu học dùng chung trong mạng nội bộ, và dân kỹ thuật thích tự dựng hệ thống riêng. Hiện repo có khoảng 43.270 sao và 4.452 fork, giấy phép Apache-2.0, nên cộng đồng dùng khá đông.

Điểm đáng giá nhất là bạn không phải tự ghép từng công cụ. NOMAD có một giao diện quản lý (tác giả gọi là "Command Center") lo việc cài đặt, cấu hình và cập nhật các công cụ bên dưới. Bạn bấm chọn nội dung cần tải, còn phần Docker và cấu hình thì NOMAD xử lý. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi bắt tay vào 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ủ tri thức offline: Wikipedia, sách, khoá học, bản đồ và trợ lý AI chạy cục bộ, không cần mạng.
- 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
```

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

NOMAD không tự viết hết mọi thứ. Nó điều phối một bộ công cụ mã nguồn mở có sẵn, chạy trong các container Docker. Dưới đây là những phần chính và lợi ích thực tế của từng phần.

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

Phần này dùng Kiwix để cho bạn Wikipedia offline, tài liệu y khoa, sách điện tử và các tài liệu tham khảo khác. Lợi ích rất rõ: tra cứu được kể cả khi đường truyền hỏng. NOMAD còn có công cụ chọn nội dung Wikipedia, trình quản lý thư viện ZIM và công cụ khám phá nội dung, giúp bạn chọn đúng thứ cần tải thay vì tải bừa.

### Trợ lý AI có kho tài liệu riêng

Đây là khung chat AI chạy cục bộ, dựa trên Ollama. Bạn cũng có thể dùng phần mềm tương thích OpenAI API như LM Studio hoặc llama.cpp. Bạn tải tài liệu lên, rồi hỏi đáp dựa trên chính tài liệu đó nhờ tìm kiếm ngữ nghĩa (RAG qua Qdrant). Với người làm văn phòng, đây là cách hỏi AI về tài liệu nội bộ mà không phải gửi file ra dịch vụ bên ngoài.

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

Kolibri mang đến các khoá học Khan Academy, có theo dõi tiến độ và hỗ trợ nhiều người dùng. Hợp với lớp học, nhóm học tập hoặc gia đình có trẻ nhỏ.

### Bản đồ offline

Bạn tải bản đồ theo khu vực (qua ProtoMaps) để xem và tìm kiếm khi không có mạng.

### Công cụ dữ liệu và ghi chú

CyberChef cho các việc mã hoá, giải mã, băm và phân tích dữ liệu. FlatNotes là ứng dụng ghi chú cục bộ, hỗ trợ Markdown.

### Đo cấu hình máy và Supply Depot

NOMAD có công cụ chấm điểm phần cứng, kèm bảng xếp hạng cộng đồng. Supply Depot là danh mục ứng dụng cài bằng một cú bấm (công cụ PDF, trình duyệt file, thư viện e-book, quản lý mật khẩu…). Nó cũng cho phép bạn chạy container Docker của riêng mình.

### Cập nhật tự động và trình hướng dẫn

Bạn có thể bật cập nhật tự động (tuỳ chọn) cho phần lõi, ứng dụng đã cài và nội dung offline theo lịch bạn đặt. Lần đầu dùng sẽ có trình hướng dẫn cài đặt, kèm các bộ nội dung chọn sẵn.

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

Theo README, bạn cần:

- Hệ điều hành họ Debian. Tác giả khuyên dùng Ubuntu 26.04 LTS; Ubuntu 24.04 LTS và Debian 12 cũng được hỗ trợ.
- Quyền sudo/root, vì script cài đặt cần quyền này.
- Kết nối internet ổn định trong lúc cài. Sau đó chỉ cần mạng khi bạn muốn tải thêm công cụ hoặc nội dung.
- Việc cài đặt hoàn toàn bằng terminal. Mọi công cụ đều dùng qua trình duyệt, nên máy không cần giao diện desktop. Bạn có thể cài như một "máy chủ" rồi truy cập từ máy khác.

Về phần cứng, có hai mức:

- Mức tối thiểu (chỉ phần quản lý, chưa có AI): CPU lõi kép 2 GHz trở lên, RAM 4 GB (cả hệ thống không có AI chạy dưới 1 GB), ổ đĩa trống ít nhất 5 GB. README khuyên chuẩn bị 10 GB cho thoải mái.
- Mức tối ưu (để chạy AI): CPU kiểu AMD Ryzen 7 hoặc Intel Core i7 trở lên, RAM 32 GB, card đồ hoạ NVIDIA RTX 3060 hoặc tương đương AMD trở lên (VRAM càng nhiều càng chạy được mô hình lớn), ổ trống ít nhất 250 GB, tốt nhất là SSD.

Cài thêm trợ lý AI thì dung lượng lên khoảng 25 GB, vì Ollama và mô hình đều nặng. Nội dung offline bạn tải về sau đó mới là thứ ngốn ổ đĩa nhiều nhất.

Về Windows: lệnh cài chính thức dành cho hệ Debian. Người dùng Windows có hướng dẫn WSL2 do cộng đồng hỗ trợ trên trang web của dự án. Bạn không cần tài khoản hay API key nào để cài.

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

```steps
- Mở terminal | Vào máy Debian/Ubuntu (trực tiếp hoặc qua SSH) bằng tài khoản có sudo
- Chạy lệnh cài | Dán đoạn lệnh Quick Install, script sẽ tải và cài NOMAD
- Chờ cài xong | Máy cần có internet và đủ dung lượng đĩa
- Mở trình duyệt | Vào địa chỉ http://localhost:8080 hoặc http://IP_MAY:8080
- Làm theo trình hướng dẫn | Chọn nội dung và công cụ muốn tải về
```

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

Nếu máy có giao diện desktop, mở ứng dụng Terminal. Nếu máy là server không màn hình, đăng nhập qua SSH. Tài khoản của bạn phải dùng được sudo. Người mới hay vấp ở chỗ này: dán lệnh vào máy Windows thường sẽ không chạy, vì lệnh dành cho Debian/Ubuntu.

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

Đây là lệnh trong README. Dán nguyên khối vào terminal rồi nhấn Enter:

```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
```

Lệnh này làm bốn việc nối nhau. Thứ nhất, cập nhật danh sách gói của hệ thống. Thứ hai, cài curl, công cụ để tải file. Thứ ba, tải script cài đặt về thành file `install_nomad.sh`. Thứ tư, chạy script đó bằng quyền sudo. Các dấu `&&` nghĩa là bước trước thành công thì bước sau mới chạy. Hệ thống có thể hỏi mật khẩu sudo của bạn.

```note
Script cài đặt chạy với quyền root. Trước khi chạy, bạn nên mở file install_nomad.sh trong repo (thư mục install/) để đọc xem nó làm gì. Chỉ cài trên máy mà bạn sẵn sàng giao quyền đó.
```

### Mở giao diện trong trình duyệt

Cài xong, README cho biết bạn mở trình duyệt và vào `http://localhost:8080`. Nếu truy cập từ máy khác trong cùng mạng, dùng `http://DEVICE_IP:8080`, trong đó DEVICE_IP là địa chỉ IP của máy đã cài NOMAD. Từ đây bạn làm theo trình hướng dẫn để chọn bộ nội dung cần tải.

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

Nếu bạn quen Docker, README có cách khác: lấy file mẫu `management_compose.yaml` trong thư mục `install/` của repo, lưu thành `docker-compose.yml`, thay các giá trị giữ chỗ bằng giá trị thật của bạn, rồi chạy:

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

Lệnh này khởi động Command Center và các thành phần phụ thuộc. README ghi rõ 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 khi chạy.

### Cài trên Windows

README chưa đưa lệnh cài riêng cho Windows ngay trong file. Nó chỉ dẫn đến hướng dẫn WSL2 (do cộng đồng hỗ trợ) trên trang web của dự án. Bạn nên đọc hướng dẫn đó, vì nó nói về cả hai đường: Docker bản gốc và Docker Desktop.

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

Cách kiểm tra đơn giản nhất theo README: mở trình duyệt và vào `http://localhost:8080` (hoặc `http://DEVICE_IP:8080` từ máy khác). Nếu thấy giao diện Command Center hiện ra thì NOMAD đã chạy.

Nếu trang không mở, bạn thử bật lại các container bằng script đi kèm. Script nằm trong thư mục cài đặt `/opt/project-nomad`:

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

Lệnh này khởi động tất cả container của dự án đã cài. Muốn dừng thì dùng:

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

Ngoài ra, README cho biết NOMAD kiểm tra kết nối mạng bằng cách gọi thử một địa chỉ tiện ích của Cloudflare, rồi mới dùng địa chỉ dự phòng. Nếu mạng bạn chặn các địa chỉ này, bạn có thể đổi địa chỉ kiểm tra trong phần Settings → Advanced hoặc bằng biến môi trường `INTERNET_STATUS_TEST_URL`.

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

### Làm kho tra cứu dự phòng cho gia đình hoặc cửa hàng ở vùng mạng yếu

Bối cảnh: bạn ở nơi mạng chập chờn, hoặc muốn con cái có chỗ tra bài mà không phải lên mạng lung tung. Bạn cài NOMAD lên một máy cũ trong nhà. Khi còn internet, vào trình hướng dẫn và chọn bộ nội dung Wikipedia, tài liệu tham khảo và sách điện tử. Sau đó cả nhà mở `http://IP_MAY:8080` trên điện thoại hoặc laptop là tra cứu được, kể cả lúc mất mạng. Kết quả: có một thư viện nội bộ luôn sẵn sàng. Dung lượng từng bộ nội dung khác nhau, nên bạn xem trang FAQ của dự án trước khi tải để khỏi đầy ổ.

> Cài một lần lúc có mạng, rồi cả nhà tra cứu được kể cả khi mạng đã mất.
>
> — Ông T

### Dựng góc học tập cho lớp hoặc nhóm học

Bối cảnh: bạn là thầy cô hoặc người phụ trách một lớp học nhỏ, muốn học viên cùng dùng một nguồn bài giảng. Bạn bật Kolibri trong NOMAD và tải các khoá Khan Academy bạn cần. Học viên vào cùng địa chỉ trong mạng nội bộ, có tài khoản riêng và được theo dõi tiến độ, vì Kolibri hỗ trợ nhiều người dùng. Lưu ý: README nói rõ NOMAD hiện không có đăng nhập cho chính nó, nên bạn nên kiểm soát ai được vào mạng đó (xem phần lỗi bên dưới).

### Hỏi AI về tài liệu nội bộ của văn phòng

Bối cảnh: bạn làm văn phòng, có một đống quy trình, hợp đồng mẫu, hướng dẫn nội bộ dạng tài liệu và không muốn tải lên dịch vụ AI bên ngoài. Bạn cài trợ lý AI trong NOMAD (máy cần đủ mạnh, nhất là RAM hoặc VRAM). Sau đó tải tài liệu lên khung chat và hỏi ví dụ: "Tóm tắt quy trình duyệt chi trong tài liệu vừa tải lên" hoặc "Điều khoản thanh toán trong mẫu hợp đồng này là gì?". Kết quả là AI trả lời dựa trên kho tài liệu bạn đã đưa vào, nhờ tìm kiếm ngữ nghĩa. Chất lượng câu trả lời phụ thuộc vào mô hình và cấu hình máy bạn dùng.

### Dev: tách AI sang máy khác và chạy thêm dịch vụ riêng

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

```bash
OLLAMA_HOST=0.0.0.0
```

Với LM Studio, bạn phải tải mô hình ngay trong LM Studio, vì chức năng tải mô hình chỉ có khi dùng Ollama. Bạn tự chịu trách nhiệm cài đặt máy chủ Ollama/OpenAI ở máy kia. Thêm vào đó, Supply Depot cho phép bạn chạy container Docker riêng, rất tiện nếu muốn gom thêm vài dịch vụ nội bộ vào cùng một giao diện quản lý.

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

### Không mở được trang localhost:8080

Nguyên nhân hay gặp là container chưa chạy hoặc bạn đang gõ sai địa chỉ. Thử chạy lại script khởi động `sudo bash /opt/project-nomad/start_nomad.sh`. Nếu truy cập từ máy khác, dùng đúng IP của máy cài NOMAD thay vì `localhost` (vì `localhost` chỉ có nghĩa là chính máy bạn đang ngồi). Kiểm tra thêm tường lửa có chặn cổng 8080 không.

### Lệnh cài báo thiếu quyền hoặc lỗi trên Windows

Script cần sudo, nên chạy bằng tài khoản không có quyền sẽ lỗi. Ngoài ra lệnh này chỉ dành cho hệ Debian. Trên Windows, đừng dán thẳng vào PowerShell. Hãy làm theo hướng dẫn WSL2 của dự án, hoặc cài một máy Ubuntu riêng.

### Đầy ổ đĩa khi tải nội dung

NOMAD tự nó chỉ cần khoảng 5 GB, nhưng nội dung offline và AI mới là thứ ngốn dung lượng: thêm AI đã khoảng 25 GB. Hãy xem dung lượng từng bộ nội dung trong FAQ trước khi tải, và chọn từng phần thay vì tải hết một lần. Nếu cần bắt đầu lại từ đầu, repo có script gỡ cài đặt, nhưng README cảnh báo là không hoàn tác được:

```bash
curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/uninstall_nomad.sh -o uninstall_nomad.sh && sudo bash uninstall_nomad.sh
```

### AI chạy rất chậm hoặc không chạy nổi

Mô hình cần dung lượng bộ nhớ xấp xỉ kích thước file tải về khi trả lời. Có card rời thì lấy từ VRAM, không có thì lấy từ RAM hệ thống. Máy ít RAM và không có GPU sẽ rất khó chịu. Cách xử lý an toàn: chọn mô hình nhỏ hơn, nâng cấp máy, hoặc chạy AI trên máy khác như mục trên.

### Mở NOMAD cho cả mạng nhưng ai cũng vào được

Đây là điểm cần chú ý nhất. README nói rõ NOMAD không có xác thực. Ai vào được địa chỉ của nó là dùng được. Nếu bạn cho thiết bị khác trong mạng truy cập, hãy dùng kiểm soát ở mức mạng, ví dụ mở hoặc chặn cổng. Đừng đưa trực tiếp NOMAD ra internet.

```note
NOMAD hiện không có đăng nhập. Chỉ cho truy cập trong mạng bạn tin tưởng, và không mở thẳng ra internet. Tác giả khuyến cáo mạnh là không nên, trừ khi bạn hiểu rõ rủi ro và đã có biện pháp bảo vệ.
```

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

Điểm mạnh: ý tưởng rất thực tế. Một lần cài là có thư viện, lớp học, bản đồ và AI cục bộ gói gọn trong một giao diện. README nói không có telemetry tích hợp, và internet chỉ cần khi cài hoặc khi bạn chủ động tải thêm. Giấy phép Apache-2.0, repo vẫn được cập nhật gần đây. Có sẵn script khởi động, dừng, cập nhật và gỡ cài đặt để bảo trì.

Giới hạn: bạn phải có máy Debian/Ubuntu (Windows chỉ đi qua đường WSL2 do cộng đồng hỗ trợ). Muốn dùng AI cho ra hồn thì cần phần cứng khá mạnh, và dung lượng ổ đĩa tăng nhanh theo nội dung. NOMAD chưa có xác thực người dùng, nên không hợp nếu bạn cần phân quyền chặt (như lớp học có tài khoản giáo viên và quản trị riêng) hoặc muốn đưa ra internet.

Khi nào chọn cách khác: nếu bạn chỉ cần một khung chat AI cho cá nhân, một công cụ chạy mô hình cục bộ trực tiếp như Ollama hay LM Studio gọn hơn. Nếu bạn chỉ cần Wikipedia offline, dùng thẳng Kiwix là đủ. NOMAD đáng cài khi bạn muốn gom nhiều thứ vào một chỗ và để nó lo phần cài đặt, cập nhật. Cách tốt nhất là bắt đầu nhỏ: cài phần lõi, tải vài bộ nội dung, rồi mới thêm AI khi đã chắc phần cứng chịu nổi.

## 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 nên bạn tải và dùng được. Tư liệu không nói gì về phí dịch vụ nào đi kèm. Chi phí thực tế chủ yếu là phần cứng và dung lượng ổ đĩa.

### Có cần card đồ hoạ (GPU) không?

Phần lõi của NOMAD không cần GPU, chỉ cần khoảng 5 GB đĩa và dưới 1 GB RAM khi chưa có AI. Với trợ lý AI, tác giả khuyên dùng máy có GPU, ví dụ NVIDIA RTX 3060 hoặc tương đương AMD trở lên. Không có card rời thì mô hình dùng RAM hệ thống.

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

Lệnh cài chính thức dành cho hệ Debian (khuyên dùng Ubuntu 26.04 LTS). Người dùng Windows có hướng dẫn WSL2 do cộng đồng hỗ trợ trên trang web của dự án, gồm cả đường Docker gốc và Docker Desktop.

### Dữ liệu của tôi có an toàn không, có bị gửi đi đâu không?

README nói NOMAD có ZERO 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 NOMAD không có đăng nhập, nên bạn cần tự kiểm soát ai truy cập được vào máy. Tác giả khuyến cáo không đưa nó trực tiếp ra internet.

### Dùng AI có phải trả tiền cho dịch vụ bên ngoài không?

AI chạy cục bộ qua Ollama, hoặc qua phần mềm tương thích OpenAI API như LM Studio và llama.cpp mà bạn tự cài. Tư liệu không nhắc đến API key hay thuê bao nào. Bạn có thể trỏ sang máy chủ AI ở máy khác trong phần cài đặt của AI Assistant.

### Khác gì so với tự cài Kiwix hoặc Ollama?

NOMAD là giao diện quản lý, tự cài đặt, cấu hình và cập nhật một bộ công cụ (Kiwix, Kolibri, Ollama, Qdrant, ProtoMaps, CyberChef, FlatNotes…) bằng Docker. Bạn không phải ghép từng thứ thủ công. Tư liệu chưa so sánh chi tiết với việc cài riêng từng công cụ.

### Cập nhật và gỡ cài đặt như thế nào?

Sau khi cài, các script nằm trong /opt/project-nomad: start_nomad.sh, stop_nomad.sh và update_nomad.sh. Script cập nhật chỉ cập nhật Command Center, còn ứng dụng cài thêm phải cập nhật qua giao diện. Có script gỡ cài đặt riêng, nhưng không hoàn tác được.
