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.

Jak používat SearXNG: Od prvního vyhledávání po mistrovství v self-hostingu

Pokud jste někdy chtěli výsledky jako z Googlu, ale bez sledování, SearXNG je metavyhledávač, který klade soukromí na první místo. Agreguje výsledky z desítek zdrojů – bez profilování – a dává vám plnou kontrolu nad filtry, enginy a dokonce i hostingem. V tomto průvodci projdeme tři cesty: používání veřejné instance, přizpůsobení vyhledávání a nasazení vlastního soukromého SearXNG pro maximální kontrolu.

Aby to bylo praktické, zvolíme praktický a na řešení orientovaný přístup s praktickými kroky, nastaveními, která můžete kopírovat, a běžnými úskalími, kterým se vyhnout.

Co je SearXNG a proč ho používat?

SearXNG je open-source metavyhledávač. Místo procházení webu samotným dotazuje jiné vyhledávače a prezentuje výsledky v jednotném rozhraní. Zásadní rozdíl: odstraňuje sledování, odstraňuje reklamy (ve většině instancí) a poskytuje vám jemnou kontrolu nad tím, které enginy zahrnout, které kategorie prohledávat (web, obrázky, videa, soubory, IT, zprávy, věda) a jak jsou výsledky prezentovány.

Ve výchozím nastavení žádné sledování nebo profilování

Konfigurovatelné enginy a kategorie

Self-hosting pro plnou kontrolu

API-friendly pro vývojáře a automatizace.

Rychlý start: Používání veřejné instance SearXNG

Můžete začít s veřejnou instancí (server SearXNG provozovaný dobrovolníky). Typický postup:

Otevřete spolehlivou veřejnou instanci (vyhledejte „SearXNG instances list“ nebo komunitní vlákna a najděte aktivní a renomované servery). Posuďte dobu provozu, limity a prohlášení o ochraně osobních údajů.

Zadejte svůj dotaz a vyberte kategorie (např. Web, Obrázky, Zprávy) pomocí horních záložek.

Použijte Předvolby (ikona ozubeného kola) k nastavení:

Jazyk rozhraní

Úroveň SafeSearch

Výchozí kategorie

Motiv UI a nekonečné posouvání

Používejte „bangs“ a operátory:

!g váš dotaz vynutí engine Google (pokud je v dané instanci povolen)

!ddg, !bing, !yt, !wp atd., v závislosti na konfiguraci instance

Standardní operátory jako uvozovky, site:, filetype:pdf, inurl:, intitle: fungují na mnoha enginech

Uložte si svou oblíbenou instanci do záložek a exportujte/importujte Předvolby jako JSON blob, pokud to rozhraní podporuje.

Profesionální tip: Veřejné instance mohou omezovat anonymní uživatele, aby se chránily před zneužitím. Pokud vidíte captchy nebo zpomalení, zkuste jinou instanci nebo si ji sami hostujte.

Pokročilé triky v rozhraní

Přepínejte enginy za běhu: V Předvolbách → Enginy přepínejte konkrétní zdroje pro každou kategorii.

Laďte výsledky: Skryjte duplikáty, změňte časový rozsah (např. za poslední rok), seřaďte podle relevance nebo data.

Přepínače soukromí: Zakažte jakýkoli engine, který nechcete dotazovat. Některé enginy vyžadují API klíče; pokud chybí, jednoduše se nebudou používat.

Klávesové zkratky: Mnoho motivů SearXNG podporuje / pro zaměření na vyhledávací pole a klávesy se šipkami pro navigaci ve výsledcích.

Jak si sami hostovat SearXNG (způsob Docker)

Self-hosting vám dává spolehlivost, rychlost a kontrolu nad tím, které enginy používat. Cesta Docker je nejjednodušší.

Požadavky

Linux VPS nebo domácí server (2 vCPU/2 GB RAM jsou pohodlné pro lehké použití)

Nainstalovaný Docker a Docker Compose

Doména/subdoména a volitelný reverzní proxy (Caddy/Traefik/Nginx) pro HTTPS

Kroky

Klonujte repozitář nasazení SearXNG (nebo použijte minimální soubor Compose):

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

Vygenerujte silný SEARXNG_SECRET_KEY (např. openssl rand -hex 32).

Spusťte službu:

docker compose up -d

Konfigurujte reverzní proxy s HTTPS (příklad Caddy):

search.example.com {
reverse_proxy 127.0.0.1:8080
}

Caddy automaticky zajistí TLS přes Let’s Encrypt.

Navštivte `` a potvrďte, že se načítá.

Základní konfigurace: `settings.yml`

Po prvním spuštění budete mít konfiguraci pod připojeným svazkem (např. ./searxng/settings.yml). Klíčové sekce:

general: název, režim ladění, počet výsledků

server: tajný klíč, adresa pro vazbu, limity

engines: povolení/zakázání enginů, kategorií, časové limity

ui: motiv, nekonečné posouvání, automatické dokončování

search: výchozí nastavení bezpečného vyhledávání, jazyk, lokalizace

Příklad úryvku:

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 "

Odpověď zahrnuje organické výsledky, použité enginy a časování. Skvělé pro vytváření výzkumných automatizací, místních dashboardů a vlastních UI.

Ladění Enginů a Kategorií

Preferujte rychlé zdroje, které dbají na soukromí (např. Wikipedia, Stack Exchange, MDN, DuckDuckGo, Brave, pokud je to povoleno, oficiální API pro YouTube/Reddit/Mastodon).

Zakažte enginy s častými captchami nebo vysokou latencí ve vaší síti.

Používejte výchozí nastavení pro jednotlivé kategorie; například povolte GitHub, Stack Overflow a PyPI pod „IT“, povolte arXiv/Crossref pod „Věda“ a nastavte time_range na nedávné pro „Zprávy“.

Kontrolní seznam pro řešení problémů

Vidíte captchy nebo prázdné výsledky? Snižte nebo rotujte enginy způsobující blokování; mírně zvyšte časové limity; povolte ukládání do mezipaměti.

Selhávají požadavky API? Zkontrolujte hlavičky reverzního proxy a CORS; potvrďte format=json.

UI je pomalé? Snižte počet výsledků na stránku; zakažte náročné enginy; povolte mezipaměť Redis.

Smyčka restartování Dockeru? Ověřte syntaxi settings.yml a proměnné prostředí.

Osvědčené postupy pro týmy a pokročilé uživatele

Exportujte a spravujte verze settings.yml (bez tajných klíčů) pro sledování změn.

Používejte správce tajných klíčů nebo soubory .env pro API klíče.

Naplánujte si týdenní obnovování kontejnerů, abyste byli neustále informováni o změnách enginů.

Monitorujte protokoly pro chyby enginů nebo dosažení limitů.

Pokud vkládáte SearXNG do aplikací, snižte počet opakování a randomizujte zpoždění, abyste se vyhnuli banům.

Volitelné: Propojte SearXNG s dalšími nástroji

Používejte JSON API ve svých výzkumných noteboocích nebo pracovních postupech chatu.

Směrujte webové vyhledávání založené na aplikacích přes vaši soukromou instanci, abyste zachovali soukromí.

Některá AI/web UI se mohou připojit k SearXNG pro procházení prostřednictvím vašeho vlastního koncového bodu (podle toho nakonfigurujte základní URL a parametry API).

Stojí za zmínku: Pokud vytváříte výzkumné pracovní postupy nebo shrnujete výsledky ve velkém měřítku, nástroj jako Sider.AI může zjednodušit krok čtení a shrnutí napříč více kartami nebo dotazy. Můžete nasměrovat prohlížení na soukromý koncový bod SearXNG a poté použít Sider.AI k automatickému zachycení poznatků, návrhu briefů nebo kompilaci citací, což šetří čas, když spouštíte mnoho vyhledávání za sebou.

Bezpečnost a Etika

Respektujte podmínky enginů, které povolíte.

Nevystavujte svou instanci veřejnému zneužívání; omezte rychlost a v případě potřeby omezte přístup.

Informujte členy týmu o očekáváních v oblasti ochrany osobních údajů; protokoly lze nakonfigurovat tak, aby se zabránilo ukládání IP adres nebo dotazů.

Vaše první 15minutové nastavení: Mini kontrolní seznam

Spusťte Docker a vytvořte soubor Compose

Nastavte SEARXNG_SECRET_KEY

Spusťte kontejner a potvrďte, že funguje :8080

Umístěte jej za HTTPS pomocí proxy

Upravte settings.yml a povolte enginy, kterým důvěřujete

Nastavte výchozí kategorie a SafeSearch

Otestujte API pomocí požadavku curl

Uložte si instanci do záložek a sdílejte ji se svým týmem

Klíčové poznatky

SearXNG vám dává soukromí, kontrolu a flexibilitu bez psaní crawleru.

Začněte na veřejné instanci a poté si ji sami hostujte pro spolehlivost a přizpůsobení.

Laďte enginy a kategorie pro rychlost a relevanci.

JSON API dělá SearXNG ideálním pro výzkum a automatizaci.

Zabezpečte své nasazení pomocí HTTPS, limitů a minimálního protokolování.

Reference a další četba

Oficiální přehled vyhledávacího API pro parametry a formáty.

Podrobné návody k self-hostingu a komunitní tutoriály mohou být užitečné pro nastavení Docker a Windows.

Integrace SearXNG do pracovních postupů a nástrojů aplikací často sleduje stejný vzor API, jaký byl použit výše.

FAQ

Q1: Co je SearXNG a jak funguje? SearXNG je metavyhledávač zaměřený na soukromí, který dotazuje více zdrojů a agreguje výsledky bez sledování uživatelů. Můžete použít veřejnou instanci nebo si ji sami hostovat pro plnou kontrolu nad enginy, filtry a nastavením soukromí.

Q2: Jak si mohu sami hostovat SearXNG pomocí Dockeru? Vytvořte službu Docker Compose pomocí oficiálního obrázku, nastavte silný tajný klíč a vystavte ji za reverzní proxy s HTTPS. Upravte settings.yml pro povolení enginů, konfiguraci kategorií a úpravu možností ochrany osobních údajů.

Q3: Mohu použít SearXNG pro programové vyhledávání prostřednictvím API? Ano. Volejte /search s parametry jako q, categories a format=json pro příjem JSON výsledků pro automatizace a aplikace. To je ideální pro výzkumné kanály a interní nástroje.

Q4: Jak si mohu vybrat bezpečnou veřejnou instanci SearXNG? Hledejte aktivní a renomované instance s jasnými prohlášeními o ochraně osobních údajů, dobrou dobou provozu a minimálními captchami. Můžete také přepínat instance nebo si ji sami hostovat, pokud narazíte na omezení rychlosti nebo problémy se spolehlivostí.

Q5: Které vyhledávací operátory fungují v SearXNG? Běžné operátory jako uvozovky, site:, filetype:, inurl: a intitle: obecně fungují a jsou předávány podkladovým enginům. Můžete také použít bang zkratky (např. !g, !ddg, !yt), pokud je instance podporuje.