What is SearXNG and how does it work?

SearXNG is a privacy-focused metasearch engine that queries multiple sources and aggregates the results, without tracking users. You can use a public instance or self-host for full control over engines, filters, and privacy settings.

How do I self-host SearXNG with Docker?

Create a Docker Compose service using the official image, set a strong secret key, and expose it behind a reverse proxy with HTTPS. Edit `settings.yml` to enable engines, configure categories, and adjust privacy options.

Can I use SearXNG for programmatic searches via API?

Yes. Call `/search` with parameters like `q`, `categories`, and `format=json` to receive JSON results for automations and apps. This is ideal for research pipelines and internal tools.

How do I choose a safe public SearXNG instance?

Look for active, reputable instances with clear privacy statements, good uptime, and minimal captchas. You can also switch instances or self-host if you encounter rate limits or reliability issues.

Which search operators work in SearXNG?

Common operators like quotes, `site:`, `filetype:`, `inurl:`, and `intitle:` generally work and are passed to underlying engines. You can also use bang shortcuts (e.g., `!g`, `!ddg`, `!yt`) if the instance supports them.

Cách Sử Dụng SearXNG: Từ Tìm Kiếm Đầu Tiên Đến Làm Chủ Khả Năng Tự Lưu Trữ

Nếu bạn từng muốn có kết quả giống như Google mà không bị theo dõi, thì SearXNG là công cụ metasearch ưu tiên quyền riêng tư của bạn. Nó tổng hợp kết quả từ hàng tá nguồn—mà không lập hồ sơ về bạn—và cho phép bạn kiểm soát hoàn toàn các bộ lọc, công cụ và thậm chí cả việc lưu trữ. Trong hướng dẫn này, chúng ta sẽ đi qua ba con đường: sử dụng một phiên bản công khai, tùy chỉnh trải nghiệm tìm kiếm của bạn và triển khai SearXNG riêng tư của riêng bạn để có khả năng kiểm soát tối đa.

Để giữ cho điều này có tính khả thi, chúng ta sẽ thực hiện một cách tiếp cận thực tế và hướng đến giải pháp với các bước thực hành, cài đặt bạn có thể sao chép và những cạm bẫy phổ biến cần tránh.

SearXNG Là Gì và Tại Sao Nên Sử Dụng?

SearXNG là một công cụ metasearch mã nguồn mở. Thay vì tự thu thập dữ liệu trên web, nó truy vấn các công cụ tìm kiếm khác và trình bày kết quả trong một giao diện thống nhất. Điểm đặc biệt: nó loại bỏ theo dõi, loại bỏ quảng cáo (trên hầu hết các phiên bản) và cho phép bạn kiểm soát chi tiết những công cụ nào nên đưa vào, những danh mục nào nên tìm kiếm (web, hình ảnh, video, tệp, IT, tin tức, khoa học) và cách trình bày kết quả.

Không theo dõi hoặc lập hồ sơ theo mặc định

Các công cụ và danh mục có thể định cấu hình

Có thể tự lưu trữ để kiểm soát hoàn toàn

Thân thiện với API dành cho nhà phát triển và tự động hóa.

Khởi Đầu Nhanh Chóng: Sử Dụng Một Phiên Bản SearXNG Công Khai

Bạn có thể bắt đầu với một phiên bản công khai (một máy chủ SearXNG do các tình nguyện viên điều hành). Quy trình điển hình:

Mở một phiên bản công khai đáng tin cậy (tìm kiếm “danh sách các phiên bản SearXNG” hoặc các chủ đề cộng đồng để tìm các máy chủ đang hoạt động, có uy tín). Đánh giá thời gian hoạt động, giới hạn tỷ lệ và tuyên bố về quyền riêng tư.

Nhập truy vấn của bạn và chọn danh mục (ví dụ: Web, Hình ảnh, Tin tức) thông qua các tab trên cùng.

Sử dụng Tùy chọn (biểu tượng bánh răng) để đặt:

Ngôn ngữ giao diện

Mức độ Tìm kiếm An toàn

Danh mục mặc định

Giao diện người dùng và cuộn vô hạn

Sử dụng “bangs” và toán tử:

!g truy vấn của bạn buộc công cụ Google (nếu được bật trên phiên bản đó)

!ddg, !bing, !yt, !wp v.v., tùy thuộc vào cấu hình phiên bản

Các toán tử tiêu chuẩn như dấu ngoặc kép, site:, filetype:pdf, inurl:, intitle: hoạt động trên nhiều công cụ

Đánh dấu phiên bản yêu thích của bạn và xuất/nhập Tùy chọn dưới dạng một blob JSON nếu được UI hỗ trợ.

Mẹo chuyên nghiệp: Các phiên bản công khai có thể giới hạn tỷ lệ người dùng ẩn danh để bảo vệ chúng khỏi lạm dụng. Nếu bạn thấy mã xác thực hoặc chậm trễ, hãy thử một phiên bản khác hoặc tự lưu trữ.

Các Thao Tác Nâng Cao của Người Dùng Thành Thạo trong Giao Diện

Chuyển đổi công cụ ngay lập tức: Trong Tùy chọn → Công cụ, hãy bật/tắt các nguồn cụ thể theo danh mục.

Điều chỉnh kết quả: Ẩn các bản sao, thay đổi phạm vi thời gian (ví dụ: năm ngoái), sắp xếp theo mức độ liên quan hoặc ngày tháng.

Bật/tắt quyền riêng tư: Tắt bất kỳ công cụ nào bạn không muốn truy vấn. Một số công cụ yêu cầu khóa API; nếu không có, chúng sẽ không được sử dụng.

Phím tắt: Nhiều giao diện SearXNG hỗ trợ / để tập trung vào hộp tìm kiếm và các phím mũi tên để điều hướng kết quả.

Cách Tự Lưu Trữ SearXNG (Theo Cách Docker)

Tự lưu trữ mang lại cho bạn độ tin cậy, tốc độ và quyền kiểm soát đối với các công cụ sẽ sử dụng. Đường dẫn Docker là đơn giản nhất.

Yêu Cầu

Một VPS Linux hoặc một máy chủ tại nhà (2 vCPU/2 GB RAM là thoải mái cho việc sử dụng nhẹ)

Đã cài đặt Docker và Docker Compose

Một miền/tên miền phụ và proxy ngược tùy chọn (Caddy/Traefik/Nginx) cho HTTPS

Các Bước

Sao chép kho lưu trữ triển khai SearXNG (hoặc sử dụng tệp Compose tối thiểu):

version: "3.8"
services:
searxng:
image: searxng/searxng:latest
container_name: searxng
environment:
- BASE_URL=
- SEARXNG_SECRET_KEY=change_me_to_a_long_random_value
volumes:
- ./searxng:/etc/searxng
ports:
- "8080:8080"
restart: unless-stopped

Tạo một SEARXNG_SECRET_KEY mạnh (ví dụ: openssl rand -hex 32).

Khởi động dịch vụ:

docker compose up -d

Định cấu hình proxy ngược với HTTPS (ví dụ Caddy):

search.example.com {
reverse_proxy 127.0.0.1:8080
}

Caddy sẽ tự động cung cấp TLS thông qua Let’s Encrypt.

Truy cập `<your domain>` và xác nhận nó tải.

Cấu Hình Cốt Lõi: `settings.yml`

Sau lần chạy đầu tiên, bạn sẽ có cấu hình trong volume đã gắn (ví dụ: ./searxng/settings.yml). Các phần chính:

general: tên, chế độ gỡ lỗi, số lượng kết quả

server: khóa bí mật, địa chỉ liên kết, giới hạn tỷ lệ

engines: bật/tắt công cụ, danh mục, thời gian chờ

ui: giao diện, cuộn vô hạn, tự động hoàn thành

search: mặc định tìm kiếm an toàn, ngôn ngữ, địa phương

Đoạn mã ví dụ:

general:
instance_name: "My Private SearXNG"
server:
secret_key: "<same as env or longer>"
image_proxy: true
rate_limit: "60/minute"
search:
safe_search: 1 # 0 off, 1 moderate, 2 strict
autocomplete: "duckduckgo"
ui:
default_theme: "simple"
infinite_scroll: true
engines:
- name: duckduckgo
engine: duckduckgo
categories: .
### Quick Example
- Endpoint: `/search`
- Methods: GET or POST
- Parameters: `q` (query), `categories`, `language`, `format=json`, `time_range`, `safesearch`
```bash
curl "

Phản hồi bao gồm kết quả tự nhiên, các công cụ đã sử dụng và thời gian. Tuyệt vời để xây dựng tự động hóa nghiên cứu, bảng điều khiển cục bộ và giao diện người dùng tùy chỉnh.

Điều Chỉnh Các Công Cụ và Danh Mục

Ưu tiên các nguồn nhanh chóng, thân thiện với quyền riêng tư (ví dụ: Wikipedia, Stack Exchange, MDN, DuckDuckGo, Brave nếu được phép, API chính thức cho YouTube/Reddit/Mastodon).

Tắt các công cụ có mã xác thực thường xuyên hoặc độ trễ cao trên mạng của bạn.

Sử dụng các mặc định theo danh mục; ví dụ: bật GitHub, Stack Overflow và PyPI trong “IT,” bật arXiv/Crossref trong “Khoa học” và đặt time_range thành gần đây cho “Tin tức”.

Danh Sách Kiểm Tra Khắc Phục Sự Cố

Bạn thấy mã xác thực hoặc kết quả trống? Giảm hoặc xoay vòng các công cụ gây ra chặn; tăng thời gian chờ một chút; bật bộ nhớ đệm.

Yêu cầu API không thành công? Kiểm tra tiêu đề proxy ngược và CORS; xác nhận format=json.

Giao diện người dùng chậm? Giảm số lượng kết quả trên mỗi trang; tắt các công cụ nặng; bật bộ nhớ đệm Redis.

Vòng lặp khởi động lại Docker? Xác thực cú pháp settings.yml và các biến môi trường của bạn.

Các Phương Pháp Hay Nhất cho Nhóm và Người Dùng Thành Thạo

Xuất và kiểm soát phiên bản settings.yml của bạn (không có bí mật) để theo dõi các thay đổi.

Sử dụng trình quản lý bí mật hoặc tệp .env cho khóa API.

Lên lịch làm mới container hàng tuần để luôn cập nhật các thay đổi của công cụ.

Giám sát nhật ký để tìm lỗi công cụ hoặc số lần truy cập giới hạn tỷ lệ.

Nếu bạn nhúng SearXNG vào các ứng dụng, hãy giảm số lần thử lại và ngẫu nhiên hóa độ trễ để tránh bị cấm.

Tùy Chọn: Kết Nối SearXNG Với Các Công Cụ Khác

Sử dụng API JSON trong sổ tay nghiên cứu hoặc quy trình làm việc trò chuyện của bạn.

Định tuyến tìm kiếm web dựa trên ứng dụng thông qua phiên bản riêng tư của bạn để duy trì quyền riêng tư.

Một số giao diện người dùng AI/web có thể cắm vào SearXNG để duyệt qua điểm cuối của riêng bạn (định cấu hình URL cơ sở và các tham số API tương ứng).

Điều đáng chú ý: Nếu bạn đang tạo quy trình làm việc nghiên cứu hoặc tóm tắt kết quả ở quy mô lớn, một công cụ như Sider.AI có thể hợp lý hóa bước đọc và tóm tắt trên nhiều tab hoặc truy vấn. Bạn có thể trỏ trình duyệt của mình đến một điểm cuối SearXNG riêng tư, sau đó sử dụng Sider.AI để thu thập thông tin chi tiết, soạn thảo bản tóm tắt hoặc biên soạn trích dẫn một cách tự động, giúp tiết kiệm thời gian khi bạn chạy nhiều tìm kiếm liên tiếp.

Bảo Mật và Đạo Đức

Tôn trọng các điều khoản của các công cụ bạn bật.

Không để phiên bản của bạn bị lạm dụng công khai; giới hạn tỷ lệ và, nếu cần, hạn chế quyền truy cập.

Thông báo cho các thành viên trong nhóm về các kỳ vọng về quyền riêng tư; có thể định cấu hình nhật ký để tránh lưu trữ IP hoặc truy vấn.

Thiết Lập 15 Phút Đầu Tiên Của Bạn: Một Danh Sách Kiểm Tra Nhỏ

Khởi động Docker và tạo một tệp Compose

Đặt SEARXNG_SECRET_KEY

Khởi động container và xác nhận :8080 hoạt động

Đặt nó sau HTTPS với một proxy

Chỉnh sửa settings.yml để bật các công cụ bạn tin tưởng

Đặt danh mục mặc định và Tìm kiếm An toàn

Kiểm tra API bằng yêu cầu curl

Đánh dấu phiên bản của bạn và chia sẻ nó với nhóm của bạn

Những Điểm Chính

SearXNG mang lại cho bạn quyền riêng tư, quyền kiểm soát và tính linh hoạt mà không cần viết trình thu thập dữ liệu.

Bắt đầu trên một phiên bản công khai, sau đó tự lưu trữ để có độ tin cậy và tùy chỉnh.

Điều chỉnh các công cụ và danh mục để có tốc độ và mức độ liên quan.

API JSON làm cho SearXNG trở nên lý tưởng cho nghiên cứu và tự động hóa.

Tăng cường triển khai của bạn bằng HTTPS, giới hạn tỷ lệ và ghi nhật ký tối thiểu.

Tài Liệu Tham Khảo và Đọc Thêm

Tổng quan về API Tìm kiếm chính thức để biết các tham số và định dạng.

Hướng dẫn từng bước về tự lưu trữ và hướng dẫn cộng đồng có thể hữu ích cho thiết lập Docker và Windows.

Tích hợp SearXNG vào quy trình làm việc và công cụ ứng dụng thường tuân theo cùng một mẫu API được sử dụng ở trên.

Câu Hỏi Thường Gặp

Q1: SearXNG là gì và nó hoạt động như thế nào? SearXNG là một công cụ metasearch tập trung vào quyền riêng tư, truy vấn nhiều nguồn và tổng hợp kết quả mà không theo dõi người dùng. Bạn có thể sử dụng một phiên bản công khai hoặc tự lưu trữ để kiểm soát hoàn toàn các công cụ, bộ lọc và cài đặt quyền riêng tư.

Q2: Làm cách nào để tự lưu trữ SearXNG bằng Docker? Tạo một dịch vụ Docker Compose bằng hình ảnh chính thức, đặt khóa bí mật mạnh và hiển thị nó sau một proxy ngược với HTTPS. Chỉnh sửa settings.yml để bật các công cụ, định cấu hình danh mục và điều chỉnh các tùy chọn quyền riêng tư.

Q3: Tôi có thể sử dụng SearXNG cho các tìm kiếm theo chương trình thông qua API không? Có. Gọi /search với các tham số như q, categories và format=json để nhận kết quả JSON cho tự động hóa và ứng dụng. Điều này lý tưởng cho các quy trình nghiên cứu và các công cụ nội bộ.

Q4: Làm cách nào để chọn một phiên bản SearXNG công khai an toàn? Tìm các phiên bản đang hoạt động, có uy tín với các tuyên bố về quyền riêng tư rõ ràng, thời gian hoạt động tốt và mã xác thực tối thiểu. Bạn cũng có thể chuyển đổi phiên bản hoặc tự lưu trữ nếu bạn gặp phải giới hạn tỷ lệ hoặc các vấn đề về độ tin cậy.

Q5: Những toán tử tìm kiếm nào hoạt động trong SearXNG? Các toán tử phổ biến như dấu ngoặc kép, site:, filetype:, inurl: và intitle: thường hoạt động và được chuyển đến các công cụ cơ bản. Bạn cũng có thể sử dụng các phím tắt bang (ví dụ: !g, !ddg, !yt) nếu phiên bản hỗ trợ chúng.