# Vane: công cụ trả lời bằng AI tự host, có dẫn nguồn — hướng dẫn cài đặt và dùng

> Vane là một công cụ trả lời câu hỏi bằng AI mã nguồn mở (giấy phép MIT), chạy trên máy hoặc máy chủ của bạn, kết hợp tìm kiếm web với mô hình ngôn ngữ và trả lời kèm nguồn. Bạn có thể dùng mô hình chạy cục bộ qua Ollama hoặc mô hình đám mây như OpenAI, Claude, Groq. Cài bằng Docker chỉ cần một lệnh, rồi điền khoá và mô hình ngay trên giao diện web.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-23 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/vane-cong-cu-tra-loi-ai-tu-host-co-dan-nguon

Vane là một công cụ hỏi đáp bằng AI mà bạn tự chạy trên máy của mình. Bạn gõ câu hỏi, Vane tìm thông tin trên web, nhờ mô hình ngôn ngữ tổng hợp lại và trả lời kèm các nguồn đã dùng. Cách làm quen thuộc với ai từng dùng Perplexity, nhưng ở đây mọi thứ nằm trong tay bạn. Repo hiện có khoảng 38.194 sao và 4.295 fork, viết chủ yếu bằng TypeScript, giấy phép MIT.

Vane hợp với ba nhóm người. Thứ nhất là người làm văn phòng, kinh doanh hay phải tra cứu nhanh: giá thị trường, quy định, tin tức ngành. Thứ hai là người quan tâm riêng tư, không muốn mọi câu hỏi bị gửi cho một dịch vụ bên thứ ba. Thứ ba là lập trình viên mới muốn có một công cụ tìm kiếm AI để tự chỉnh, tự nhúng vào ứng dụng của mình qua API.

Điểm đáng giá nhất: bạn chọn được mô hình. Có thể dùng mô hình chạy ngay trên máy qua Ollama, hoặc cắm khoá API của OpenAI, Claude, Gemini, Groq. Bản Docker lại đóng gói sẵn công cụ tìm kiếm SearxNG, nên bạn không phải dựng thêm gì. Một lệnh là chạy.

```repo
- repo | ItzCrazyKns/Vane
- kind | Ứng dụng
- desc | Vane là công cụ hỏi đáp bằng AI chạy trên máy bạn, tìm web qua SearxNG, dùng được Ollama hoặc OpenAI/Claude/Groq và luôn kèm nguồn trích dẫn.
- stars | 38k
- lang | TypeScript
- license | MIT
```

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

Dưới đây là các tính năng chính, kèm lợi ích thực tế khi dùng.

- **Dùng nhiều loại mô hình AI.** Chạy cục bộ qua Ollama hoặc nối với OpenAI, Anthropic Claude, Google Gemini, Groq và các nhà cung cấp khác. Bạn có thể phối nhiều mô hình tuỳ nhu cầu. Muốn tiết kiệm tiền thì dùng mô hình chạy trên máy. Muốn câu trả lời chắc tay hơn thì đổi sang mô hình đám mây.
- **Ba chế độ tìm kiếm.** Speed cho câu trả lời nhanh, Balanced cho việc tra cứu hằng ngày, Quality cho nghiên cứu sâu. Câu hỏi đơn giản thì chọn nhanh cho đỡ chờ, chủ đề khó thì chọn kỹ.
- **Chọn nguồn tìm.** Tìm trên web, trong các thảo luận hoặc trong bài báo học thuật. README nói thêm nguồn và tích hợp đang được phát triển.
- **Widget.** Khi phù hợp, Vane hiện thẻ nhỏ như thời tiết, phép tính, giá cổ phiếu. Tra nhanh mà không cần đọc cả đoạn văn.
- **Tìm web bằng SearxNG.** SearxNG gom kết quả từ nhiều công cụ tìm kiếm và giữ danh tính của bạn riêng tư. README cho biết Tavily và Exa sẽ được hỗ trợ trong thời gian tới.
- **Tìm hình ảnh và video.** Kết quả không chỉ là chữ.
- **Tải tài liệu lên để hỏi.** README nêu PDF, file văn bản và hình ảnh. Bạn tải hợp đồng, báo cáo lên rồi hỏi thẳng nội dung trong đó.
- **Giới hạn theo trang web.** Biết rõ nên tìm ở đâu, ví dụ trang tài liệu kỹ thuật, thì khoanh vùng cho kết quả sạch hơn.
- **Gợi ý khi gõ.** Vane gợi ý câu hỏi để bạn diễn đạt tốt hơn.
- **Discover.** Mục duyệt bài viết và nội dung nổi bật trong ngày, không cần tìm gì.
- **Lịch sử tìm kiếm.** Mọi lần tìm được lưu cục bộ để xem lại sau.
- **Có API.** Lập trình viên có thể gọi Vane từ ứng dụng của mình. Chi tiết nằm trong tài liệu API của repo (thư mục docs).

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

Theo README, bạn có hai đường cài: dùng Docker (được khuyên dùng) hoặc không dùng Docker. Phần chuẩn bị phụ thuộc vào đường bạn chọn.

- **Nếu dùng Docker:** cài Docker và để nó đang chạy. README không ghi yêu cầu hệ điều hành cụ thể cho cách này, nhưng có hướng dẫn riêng cho Windows, Mac và Linux ở phần Ollama.
- **Nếu không dùng Docker:** cần tự cài SearXNG, bật định dạng `JSON` trong cài đặt của nó và bật công cụ tìm kiếm Wolfram Alpha. Cần có Node và npm để chạy `npm i`. README không ghi phiên bản Node cần dùng, bạn xem thêm file `package.json` trong repo.
- **Một mô hình AI:** hoặc Ollama chạy trên máy, hoặc khoá API của nhà cung cấp bạn chọn (OpenAI, Claude, Gemini, Groq…). Khoá được điền ngay trên màn hình thiết lập của Vane, không cần sửa file.
- **Phần cứng:** README không nêu yêu cầu cấu hình hay GPU. Nếu bạn chạy mô hình cục bộ, cấu hình cần thiết do mô hình bạn chọn quyết định, chưa có thông tin cụ thể trong tư liệu.

```note
Khoá API là chìa khoá tính tiền. Đừng dán vào ảnh chụp màn hình, tin nhắn nhóm hay file chia sẻ. Nếu dùng mô hình đám mây, mỗi câu hỏi có thể phát sinh chi phí theo bảng giá của nhà cung cấp đó.
```

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

Cách dễ nhất là Docker với ảnh dựng sẵn. Tóm tắt nhanh:

```steps
- Cài Docker | Cài Docker và bảo đảm nó đang chạy
- Chạy container | Một lệnh docker run kéo ảnh Vane (đã gồm SearxNG) về và chạy
- Mở trình duyệt | Vào http://localhost:3000
- Thiết lập | Điền khoá API, chọn mô hình trên màn hình setup
- Dùng thử | Gõ câu hỏi đầu tiên
```

### Cài Docker và mở terminal

Cài Docker theo hướng dẫn của Docker cho hệ điều hành của bạn, rồi mở ứng dụng Docker lên cho nó chạy nền. Trên Windows, bạn mở PowerShell. Trên Mac hoặc Linux, mở Terminal. Chưa bật Docker thì lệnh bên dưới sẽ báo lỗi không kết nối được.

### Chạy Vane bằng một lệnh

Gõ đúng lệnh sau:

```bash
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latest
```

Giải thích ngắn: `-d` cho chạy nền, `-p 3000:3000` mở cổng 3000 để bạn vào bằng trình duyệt, `-v vane-data:/home/vane/data` tạo nơi lưu dữ liệu bền vững (lịch sử, file đã tải lên), `--name vane` đặt tên container là vane. README ghi ảnh này đã gồm cả Vane lẫn SearxNG, nên không cần cài thêm gì.

Lần đầu chạy, Docker phải tải ảnh về nên có thể hơi lâu. Bạn cứ chờ lệnh chạy xong.

### Mở Vane và thiết lập mô hình

Mở trình duyệt, vào `http://localhost:3000`. Bạn sẽ thấy màn hình thiết lập. Tại đây bạn điền khoá API, chọn mô hình và các cài đặt khác. Chưa thiết lập nhà cung cấp mô hình thì Vane sẽ báo chưa cấu hình mô hình chat, đây là chuyện bình thường ở lần đầu.

Nếu dùng Ollama, hãy xem mục lỗi hay gặp bên dưới để điền đúng địa chỉ, vì đây là chỗ người mới hay vấp nhất.

### Tuỳ chọn: dùng SearxNG có sẵn của bạn

Nếu bạn đã có SearxNG riêng, hãy dùng bản slim:

```bash
docker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:slim-latest
```

Thay `http://your-searxng-url:8080` bằng địa chỉ SearxNG thật của bạn. README nhấn mạnh SearxNG này phải bật định dạng JSON và bật công cụ Wolfram Alpha. Sau đó vẫn vào `http://localhost:3000` để thiết lập nhà cung cấp AI.

### Tuỳ chọn: tự build từ mã nguồn bằng Docker

Cần Docker đang chạy. Tải mã nguồn về:

```bash
git clone https://github.com/ItzCrazyKns/Vane.git
```

Sau đó dùng lệnh `cd Vane` để vào thư mục vừa tải (bước này là lệnh phổ thông, README chỉ ghi chung là vào thư mục dự án). Rồi build và chạy:

```bash
docker build -t vane .
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vane
```

Lệnh `docker build` phải chạy ở thư mục có file `Dockerfile`, nếu không sẽ báo không tìm thấy. Xong thì vào `http://localhost:3000` để thiết lập.

### Tuỳ chọn: cài không dùng Docker

README khuyên dùng Docker vì đỡ phải lo biến môi trường và thư viện phụ thuộc. Nếu vẫn muốn cài tay, trước hết cài SearXNG, bật định dạng `JSON` và bật Wolfram Alpha. Rồi chạy:

```bash
git clone https://github.com/ItzCrazyKns/Vane.git
cd Vane
```

Cài thư viện:

```bash
npm i
```

Build ứng dụng:

```bash
npm run build
```

Chạy ứng dụng:

```bash
npm run start
```

Cuối cùng mở `http://localhost:3000` và điền khoá, mô hình, địa chỉ SearxNG trong màn hình thiết lập. Bạn phải đứng đúng trong thư mục `Vane` khi chạy các lệnh `npm`. README còn có tài liệu cài đặt chi tiết hơn (cập nhật phiên bản, v.v.) trong thư mục `docs/installation` của repo.

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

Cách kiểm tra đơn giản nhất: mở `http://localhost:3000` trong trình duyệt. Nếu thấy giao diện Vane, hoặc màn hình thiết lập, nghĩa là ứng dụng đã chạy.

Với Docker, bạn có thể xem container có đang chạy không:

```bash
docker ps
```

Lệnh này liệt kê các container đang chạy. Bạn nên thấy một dòng có tên `vane`. Đây là lệnh Docker phổ thông, không có trong README.

Bước thử cuối cùng: sau khi điền mô hình ở màn hình thiết lập, gõ một câu hỏi thật, ví dụ về thời tiết hôm nay ở thành phố bạn. Nếu Vane trả lời kèm danh sách nguồn và có thể hiện thêm thẻ widget thời tiết, là mọi thứ đã nối thông: giao diện, SearxNG và mô hình AI.

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

### Chủ shop theo dõi giá và tin ngành

Chị Lan bán hàng online, mỗi sáng muốn biết nhanh tin về vận chuyển, quy định bán hàng và đối thủ. Chị mở Vane, chọn chế độ Balanced, nguồn Web và gõ:

```text
Các thay đổi gần đây về chính sách phí sàn thương mại điện tử cho người bán nhỏ là gì?
```

Vane trả về đoạn tóm tắt kèm các nguồn. Chị bấm vào nguồn để kiểm tra lại trước khi áp dụng. Lưu ý Vane chỉ nhanh hơn việc tự tìm, quyết định vẫn là của chị.

> Cái đáng tiền ở một công cụ trả lời không phải câu trả lời trơn tru, mà là dòng nguồn để bạn kiểm chứng.
>
> — Ông T

### Nhân viên văn phòng hỏi trên tài liệu

Anh Minh làm hành chính, nhận file PDF quy chế dài vài chục trang. Anh tải file lên Vane (README nói Vane đọc được PDF, file văn bản và hình ảnh) rồi hỏi:

```text
Trong tài liệu này, quy định về thời hạn thanh toán và phạt chậm nằm ở đâu? Tóm tắt giúp mình.
```

Kết quả là bản tóm tắt các điều khoản liên quan. Anh vẫn nên mở lại file gốc để đối chiếu những điều khoản quan trọng.

### Sinh viên hoặc người nghiên cứu tìm tài liệu học thuật

Bạn đang viết báo cáo về một chủ đề. Chọn nguồn học thuật, đặt chế độ Quality để Vane tìm sâu hơn, rồi hỏi bằng tiếng Anh hoặc tiếng Việt tuỳ nguồn bạn cần. Bạn nhận lại phần tổng hợp và các đường dẫn tới bài viết để đọc tiếp. Chế độ Quality chậm hơn Speed, đổi lại bạn được kết quả kỹ hơn.

### Lập trình viên đưa Vane làm công cụ tìm kiếm mặc định

Nếu bạn quen gõ câu hỏi lên thanh địa chỉ, README hướng dẫn thêm Vane như một công cụ tìm kiếm của trình duyệt: vào phần cài đặt trình duyệt, mục Search Engines, thêm một site search mới với địa chỉ sau:

```text
http://localhost:3000/?q=%s
```

Nếu Vane không chạy trên máy bạn, thay `localhost` bằng địa chỉ IP hoặc tên miền và đổi cổng cho đúng. Từ đó, gõ câu hỏi lên thanh tìm kiếm là đi thẳng vào Vane. Nếu muốn nhúng vào ứng dụng của mình, đọc tài liệu API trong thư mục `docs/API` của repo (README không chép ví dụ gọi API nên mình không trích ở đây).

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

### Vane báo chưa cấu hình nhà cung cấp mô hình chat

Đây là lỗi mới dùng với máy chủ mô hình cục bộ tương thích OpenAI. README gợi ý kiểm tra ba thứ: máy chủ phải chạy ở `0.0.0.0` chứ không phải `127.0.0.1` và đúng cổng bạn ghi trong địa chỉ API; tên mô hình phải đúng với mô hình đang nạp; ô khoá API không được bỏ trống, nếu máy chủ không cần khoá thì vẫn điền một giá trị bất kỳ.

### Không kết nối được Ollama

Nguyên nhân thường là Vane (trong Docker) không gọi được tới API của Ollama. Hãy kiểm tra địa chỉ API Ollama trong phần cài đặt. README hướng dẫn: trên Windows và Mac dùng `http://host.docker.internal:11434`. Trên Linux dùng địa chỉ IP của máy đang chạy Ollama cùng cổng 11434 (bản README tư liệu này bị mất phần địa chỉ, bạn xem lại README gốc cho chắc). Nếu bạn dùng cổng khác thì đổi cho khớp.

### Ollama trên Linux không mở ra mạng

Theo README, bạn thêm dòng `Environment="OLLAMA_HOST=0.0.0.0:11434"` vào file `/etc/systemd/system/ollama.service`, rồi chạy `systemctl daemon-reload` và `systemctl restart ollama`. Đồng thời bảo đảm tường lửa không chặn cổng 11434. Chỉ mở ra mạng nội bộ khi bạn hiểu rõ, đừng mở ra Internet công cộng.

### Lỗi kết nối Lemonade

Tương tự Ollama: trên Windows và Mac dùng `http://host.docker.internal:8000`, kiểm tra Lemonade đang chạy, cấu hình nhận kết nối từ mọi giao diện (`0.0.0.0`), và cổng 8000 không bị tường lửa chặn.

### Tìm kiếm không ra kết quả khi dùng SearxNG riêng

Với bản slim hoặc cài không Docker, hãy kiểm tra SearxNG đã bật định dạng JSON và Wolfram Alpha như README yêu cầu, và địa chỉ `SEARXNG_API_URL` đúng. Đây là suy luận từ yêu cầu của README. Nếu vẫn lỗi, thử chạy bản Docker mặc định có sẵn SearxNG để loại trừ nguyên nhân.

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

**Điểm mạnh.** Cài nhanh bằng một lệnh Docker, đã gồm SearxNG. Chọn được mô hình cục bộ hay đám mây. Có chế độ tốc độ, nguồn học thuật, widget, tải file, lịch sử cục bộ và API. Giấy phép MIT, repo đang được cập nhật trong vài tháng gần đây và có cộng đồng lớn.

**Giới hạn.** README ghi phần xác thực người dùng (authentication) vẫn nằm trong danh sách việc sắp làm. Vì vậy nếu bạn mở Vane ra mạng, hãy cân nhắc kỹ ai có thể truy cập. Chất lượng câu trả lời phụ thuộc vào mô hình bạn chọn và nguồn tìm được. Mô hình nhỏ chạy trên máy thường kém hơn mô hình đám mây. Tư liệu cũng chưa nêu yêu cầu cấu hình phần cứng.

**Về riêng tư.** README mô tả Vane hướng đến riêng tư và chạy trên phần cứng của bạn. Tuy nhiên nếu bạn dùng mô hình đám mây thì nội dung câu hỏi vẫn được gửi cho nhà cung cấp đó. Muốn tách biệt hoàn toàn, hãy dùng mô hình cục bộ.

**Khi nào chọn cách khác.** Nếu bạn chỉ hỏi thỉnh thoảng và không muốn quản lý gì, một dịch vụ hỏi đáp AI có sẵn trên web sẽ đỡ công hơn. Nếu bạn cần tài khoản nhiều người dùng với phân quyền, hãy chờ tính năng xác thực hoặc đặt Vane sau một lớp bảo vệ khác. Còn nếu bạn thích tự chủ, thích thử mô hình mới và cần công cụ tìm kiếm AI có dẫn nguồn trên máy mình, Vane là lựa chọn đáng thử.

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

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

Bản thân Vane là mã nguồn mở với giấy phép MIT, bạn tải về và chạy miễn phí. Tuy nhiên nếu dùng mô hình đám mây như OpenAI, Claude hay Groq thì có thể phát sinh chi phí theo nhà cung cấp đó. Dùng mô hình cục bộ qua Ollama thì không tính phí API, nhưng cần máy đủ mạnh.

### Vane có chạy được trên Windows không?

README có hướng dẫn riêng cho Windows ở phần kết nối Ollama và Lemonade (dùng địa chỉ host.docker.internal), nên Windows chạy được qua Docker. README không nêu yêu cầu phiên bản Windows cụ thể.

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

README không nêu yêu cầu GPU hay cấu hình phần cứng. Nếu bạn dùng mô hình đám mây qua khoá API thì máy chỉ cần chạy được Docker. Nếu dùng mô hình cục bộ, yêu cầu phụ thuộc vào mô hình bạn chọn, tư liệu chưa có thông tin cụ thể.

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

README mô tả Vane hướng đến riêng tư: chạy trên phần cứng của bạn, tìm web qua SearxNG và lưu lịch sử tìm kiếm cục bộ. Nhưng nếu bạn chọn mô hình đám mây thì nội dung câu hỏi vẫn được gửi cho nhà cung cấp mô hình đó. README cũng ghi tính năng xác thực người dùng chưa có, nên hãy cẩn thận khi mở Vane ra mạng.

### Vane khác gì Perplexity?

Cả hai đều là công cụ trả lời bằng AI kèm nguồn. Điểm khác theo README là Vane mã nguồn mở, tự host trên máy bạn và cho chọn mô hình (cục bộ hoặc đám mây). Tư liệu không có so sánh chi tiết về chất lượng giữa hai bên.

### Nên cài bằng Docker hay không dùng Docker?

README khuyên dùng Docker vì đơn giản hơn, nhất là phần biến môi trường và thư viện. Ảnh Docker mặc định còn có sẵn SearxNG. Cài không dùng Docker thì bạn phải tự cài SearXNG, bật JSON và Wolfram Alpha rồi chạy npm i, npm run build, npm run start.

### Tôi có thể dùng Vane làm công cụ tìm kiếm trong trình duyệt không?

Có. README hướng dẫn thêm một site search mới trong phần Search Engines của trình duyệt, với địa chỉ http://localhost:3000/?q=%s. Nếu Vane chạy ở máy khác thì thay localhost bằng IP hoặc tên miền và đổi cổng cho đúng.
