Giới thiệu tổng quan
SearXNG là một metasearch engine (công cụ tìm kiếm siêu dữ liệu) hoàn toàn miễn phí và mã nguồn mở. Dự án này được phát triển bởi tổ chức searxng trên GitHub với mục tiêu chính: tổng hợp kết quả tìm kiếm từ nhiều dịch vụ và cơ sở dữ liệu khác nhau, đồng thời không theo dõi (track) hay lập hồ sơ (profile) người dùng.
Theo mô tả chính thức từ repository:
SearXNG is a free internet metasearch engine which aggregates results from various search services and databases. Users are neither tracked nor profiled.
Thông tin dự án
| Thông số | Chi tiết |
|---|---|
| Tổ chức | searxng (GitHub Organization) |
| Repository | searxng/searxng |
| Website | docs.searxng.org |
| Giấy phép | GNU Affero General Public License v3.0 (AGPL-3.0) |
| Sao (Stars) | 29,400+ ⭐ |
| Fork | 2,800+ |
| Người theo dõi | 151 |
| Tổng số Commits | 9,365 |
| Ngôn ngữ chính | Python (80.5%), Shell (6.4%), HTML (5.4%), Less (4.1%), TypeScript (2.9%) |
| Chi nhánh mặc định | master |
| Ngày tạo | 12 tháng 4, 2021 |
Các chủ đề (Topics) mà SearXNG hướng tới
Dưới đây là các từ khóa (topics) được gắn chính thức trên repository — phản ánh đúng phạm vi và mục tiêu dự án:
| # | Topic | Ý nghĩa |
|---|---|---|
| 1 | python |
Ngôn ngữ lập trình chính |
| 2 | search |
Tìm kiếm |
| 3 | search-engine |
Công cụ tìm kiếm |
| 4 | google |
Tổng hợp kết quả từ Google |
| 5 | privacy |
Bảo vệ quyền riêng tư |
| 6 | bing |
Tổng hợp kết quả từ Bing |
| 7 | duckduckgo |
Tổng hợp kết quả từ DuckDuckGo |
| 8 | yahoo |
Tổng hợp kết quả từ Yahoo |
| 9 | startpage |
Tổng hợp kết quả từ Startpage |
| 10 | brave |
Tổng hợp kết quả từ Brave Search |
| 11 | searx |
Là phiên bản fork/cải tiến từ SearX |
| 12 | metasearch |
Metasearch engine |
| 13 | qwant |
Tổng hợp kết quả từ Qwant |
| 14 | degoogle |
Phong trào giảm phụ thuộc Google |
| 15 | searxng |
Tên gọi riêng của dự án |
➡️ Điều này cho thấy SearXNG tổng hợp kết quả từ Google, Bing, DuckDuckGo, Yahoo, Startpage, Brave, Qwant và nhiều dịch vụ khác — đúng với bản chất của một metasearch engine.
Cấu trúc thư mục Repository
Dựa trên source code chính thức tại branch master, dự án được tổ chức như sau:
| Thư mục / File | Mô tả |
|---|---|
.devcontainer/ |
Cấu hình Development Container (VS Code / Docker) |
.github/ |
GitHub Actions, issue templates, PR templates, CI/CD workflows |
.vscode/ |
Cấu hình cho Visual Studio Code |
client/simple/ |
Client giao diện web đơn giản (HTML/JS/CSS) |
container/ |
Cấu hình Docker container |
docs/ |
Tài liệu hướng dẫn dự án |
searx/ |
Thư mục mã nguồn chính (Python) – engine tìm kiếm |
searxng_extra/ |
Các tiện ích mở rộng bổ sung cho SearXNG |
tests/ |
Unit tests và integration tests |
utils/ |
Các script tiện ích quản trị |
LICENSE |
Giấy phép AGPL-3.0 |
README.rst |
Tài liệu đọc chính |
CONTRIBUTING.rst |
Hướng dẫn đóng góp |
SECURITY.md |
Chính sách bảo mật |
AI_POLICY.rst |
Chính sách về AI |
CHANGELOG.rst |
Lịch sử thay đổi |
Makefile |
Tập tin build tự động |
setup.py |
Cấu hình cài đặt Python package |
requirements.txt |
Các thư viện Python cần thiết |
requirements-dev.txt |
Thư viện cho môi trường phát triển |
requirements-server.txt |
Thư viện cho môi trường server |
go.mod / go.sum |
Cấu hình Go module |
package.json |
Cấu hình Node.js / frontend |
manage |
Script quản trị chính |
.weblate |
Cấu hình dịch thuật Weblate |
Ngôn ngữ lập trình được sử dụng
Dựa trên thống kê trực tiếp từ repository:
| Ngôn ngữ | Tỷ lệ | Vai trò |
|---|---|---|
| Python | 80.5% | Backend engine chính, xử lý tìm kiếm, API, logic tổng hợp kết quả |
| Shell | 6.4% | Script tiện ích, tự động hóa deployment |
| HTML | 5.4% | Giao diện web frontend |
| Less | 4.1% | Stylesheet (CSS preprocessor) |
| TypeScript | 2.9% | Một số thành phần frontend nâng cao |
| Emacs Lisp | 0.3% | Cấu hình Editor |
| Other | 0.4% | Các file cấu hình khác |
Hướng dẫn Setup (Cài đặt)
Theo README chính thức, dự án cung cấp các hướng dẫn chi tiết:
Cài đặt
Để cài đặt SearXNG, dự án hướng dẫn đến Installation guide tại tài liệu chính thức: docs.searxng.org/admin/installation.html
Cấu hình tinh chỉnh
Để tinh chỉnh SearXNG, có Configuration guide: docs.searxng.org/admin/settings/index.html
Thông tin thêm
Các hướng dẫn how-to khác có tại: docs.searxng.org/admin/index.html
Dịch thuật (Translation)
SearXNG hỗ trợ đa ngôn ngữ thông qua nền tảng Weblate tại translate.codeberg.org/projects/searxng/. Badge “Translated” trên README cho thấy tiến độ dịch thuật cộng đồng được cập nhật liên tục.
Kết nối cộng đồng
Theo phần “Connect” trong README, cộng đồng SearXNG giao tiếp thông qua:
- Matrix: #searxng:matrix.org
Đây là kênh giao tiếp chính thức duy nhất được ghi nhận trên repository để đặt câu hỏi và kết nối với thành viên cộng đồng.
Đóng góp (Contributing)
Dự án hoan nghênh đóng góp từ cộng đồng. Hướng dẫn chi tiết được nêu trong file CONTRIBUTING.rst tại repository.
Chính sách bảo mật và AI
Chính sách bảo mật
SearXNG có file SECURITY.md riêng biệt, thể hiện sự nghiêm túc trong việc xử lý các vấn đề bảo mật.
Chính sách AI
Đặc biệt, dự án có file AI_POLICY.rst — chính sách về việc sử dụng AI trong dự án, cho thấy SearXNG có quy định rõ ràng về cách AI được / không được phép sử dụng trong quá trình phát triển.
Tổng kết các tính năng cốt lõi
Từ tất cả thông tin trên repository, có thể tóm tắt chính xác các tính năng/dấu hiệu của SearXNG:
- ✅ Metasearch Engine — Tổng hợp kết quả từ nhiều nguồn tìm kiếm khác nhau
- ✅ Không theo dõi người dùng — Users are neither tracked
- ✅ Không lập hồ sơ người dùng — Users are neither profiled
- ✅ Hỗ trợ nhiều nguồn tìm kiếm: Google, Bing, DuckDuckGo, Yahoo, Startpage, Brave, Qwant
- ✅ Mã nguồn mở — AGPL-3.0 License
- ✅ Viết chủ yếu bằng Python (80.5%)
- ✅ Container support — Hỗ trợ Docker
- ✅ Đa ngôn ngữ — Hỗ trợ dịch thuật qua Weblate
- ✅ Tài liệu đầy đủ — Installation guide, Configuration guide, How-to guides
- ✅ CI/CD — Có GitHub Actions workflows
- ✅ DevContainer — Hỗ trợ phát triển trong container
- ✅ Chính sách bảo mật riêng biệt (SECURITY.md)
- ✅ Chính sách AI riêng biệt (AI_POLICY.rst)
- ✅ Community mạnh mẽ — 29,400+ stars, kênh Matrix
Source link: SearXNG – GitHub Repository
