Searx czy SearXNG: czy projekt Searx jest martwy?

Searx czy SearXNG: co zainstalować?

Searx i SearXNG to dwa różne projekty o niemal identycznej nazwie, z których tylko jeden otrzymuje poprawki. Należy zainstalować SearXNG. Oryginalny projekt Searx nie otrzymał żadnego commita kodu od kwietnia 2023 roku, a jego plik README jasno określa sytuację w jednym zdaniu: "Searx nie jest już utrzymywany".

Stanowi to problem praktyczny, a nie filozoficzny. Oba projekty współdzielą zrzut ekranu, większość pliku konfiguracyjnego oraz połowę nazwy, przez co poradnik napisany dla jednego z nich wygląda na mający zastosowanie do drugiego. Tak nie jest. Plik ustawień znajduje się w innej lokalizacji, ochrona przed botami jest nowa, a nazwa pakietu zniknęła z aktualnych wydań Ubuntu. Poniżej przedstawiono podział projektów, polecenia pozwalające samodzielnie sprawdzić status oraz listę zmian istotnych dla osoby uruchamiającej instancję.

Czym jest Searx i skąd wywodzi się SearXNG

Searx to metawyszukiwarka. Nie posiada własnego indeksu. Pobiera zapytanie użytkownika, przekazuje je do innych usług wyszukiwania, takich jak Bing, DuckDuckGo czy Wikipedia, a następnie scala otrzymane wyniki na jednej stronie. Korzyścią jest to, że wspomniane usługi widzą adres serwera, a nie adres użytkownika. Kosztem jest utrzymanie. Każdy silnik to fragment kodu analizujący HTML lub API zewnętrznych serwisów, dlatego silnik przestaje działać, gdy tylko zmieni się struktura źródła. Sprawność metawyszukiwarki zależy wyłącznie od osób naprawiających jej moduły.

Repozytorium searx powstało w październiku 2013 roku. W kwietniu 2021 roku były opiekun projektu uruchomił SearXNG jako jego fork. Skrót "NG" oznacza next generation. Plik README projektu searx opisuje oba projekty równolegle i ten opis pozostaje najbardziej przejrzystym podsumowaniem podziału:

SearXNG to fork searx, stworzony przez byłego opiekuna searx.

SearXNG posiada wydania typu rolling release, częściej aktualizowane zależności oraz szybciej naprawiane silniki.

Przyczyną podziału były różnice w podejściu do diagnostyki. Searx traktował dane o użytkowaniu jako informacje, których instancja nie powinna przechowywać, co wprost deklarują jego domyślne ustawienia: enable_stats: False # activate /stats page - note: it may leak usage data. SearXNG przyjął odmienne założenie i domyślnie dostarcza enable_metrics: true. Te metryki wypełniają paski czasu odpowiedzi oraz strony błędów, które ułatwiają identyfikację i naprawę uszkodzonego silnika. Oba stanowiska są uzasadnione. Tylko jedno z nich kontynuowało aktywne wydawanie kodu.

Czy projekt Searx jest martwy? Jak to sprawdzić samodzielnie

„Martwy” nie jest statusem raportowanym przez GitHub, dlatego należy przeanalizować dwa istniejące sygnały i wyciągnąć wnioski. Pierwszym jest informacja, czy repozytorium zostało zarchiwizowane oraz kiedy ostatnio wypchnięto do niego zmiany.

curl -s https://api.github.com/repos/searx/searx | jq -r '.archived, .pushed_at'
curl -s https://api.github.com/repos/searxng/searxng | jq -r '.archived, .pushed_at'

W dniu 18 października 2026 r. pierwsze polecenie wyświetla false oraz 2026-05-14T10:02:22Z. Drugie wyświetla false oraz niedawną sygnaturę czasową, zazwyczaj z ostatnich jednego lub dwóch dni. Należy zwrócić uwagę na pierwszą wartość. Repozytorium searx nie jest zarchiwizowane i nikt nie zablokował dostępu, dlatego pytanie o jego status powraca.

pushed_at jest słabym sygnałem, ponieważ zmienia się przy wypchnięciu zmian do dowolnej gałęzi, w tym przy poprawce dokumentacji składającej się z jednej linii. Zamiast tego należy przejrzeć listę commitów.

curl -s 'https://api.github.com/repos/searx/searx/commits?per_page=5' \
  | jq -r '.[] | .commit.committer.date[:10] + "  " + (.commit.message | split("\n")[0])'

Na dzień 18 października 2026 r. polecenie to wyświetla:

2026-05-14  [doc] add hister reference
2023-09-07  Searx is no longer maintained
2023-04-05  Fix quoting issue in search_operator plugin (#3479)
2023-04-04  Bump pallets-sphinx-themes from 2.0.2 to 2.0.3 (#3450)
2023-04-04  Update searx.data - update_wikidata_units.py (#3454)

Należy czytać listę od dołu. Standardowe prace ustały w kwietniu 2023 r. Commit z września 2023 r. to informacja od opiekunów projektu umieszczona w pliku README. Jedyny commit od tego czasu dotyczy dokumentacji, ponieważ pierwotny autor przeniósł się do Hister, narzędzia wyszukiwawczego, które indeksuje wybrane strony i pliki zamiast odpytywać inne wyszukiwarki. Jest to inna koncepcja, użyteczna, jeśli celem jest własna wyszukiwarka treści osobistych.

Drugim sygnałem jest pakietowanie, na którym po cichu polega większość starych poradników.

• PyPI zawiera dwadzieścia wydań searx, od 0.1.2 w styczniu 2014 r. do 0.17.0 w lipcu 2020 r., a każde z nich jest nadal dostępne do pobrania. pip install searx kończy się powodzeniem i dostarcza najnowszą wersję, 0.17.0, czyli kod sprzed dziewięciu miesięcy przed powstaniem forka.
• Debian dostarczył searx 1.1.0 w Debian 12 (bookworm) i nadal utrzymuje go w wersji unstable. Pakiet został usunięty z wersji testing w październiku 2023 r., więc Debian 13 (trixie) nie posiada już pakietu searx.
• Ubuntu ostatni raz dostarczyło go w wersji 23.10 (mantic), w wersji 1.1.0. Ostatnie wydanie LTS z tym pakietem to 22.04, w wersji 1.0.0, a pakiet został usunięty z 24.04 przed premierą tego wydania. W systemie Ubuntu 24.04 polecenie sudo apt install searx kończy się błędem E: Unable to locate package searx.
• searx.space, katalog publicznych instancji wskazywany przez projekt, wymienia teraz instancje SearXNG.

Oto rzeczywisty status. Kod jest publiczny, nadal działa, można go sklonować i uruchomić. Użytkownik nie otrzymuje jednak poprawek silników wyszukiwania ani aktualizacji bezpieczeństwa, co w przypadku metawyszukiwarki stanowi istotę działania. Silniki tracą użyteczność zgodnie z harmonogramem zewnętrznych dostawców. Nieutrzymywana instancja zwraca z każdym miesiącem coraz mniej wyników, nawet bez ingerencji w konfigurację serwera.

Co się zmieniło w nowej instancji

Plik ustawień został przeniesiony i działa teraz jako nakładka

W Searx edytowano searx/settings.yml wewnątrz drzewa źródłowego. W SearXNG plik znajduje się w /etc/searxng/settings.yml, a proces odnajduje go poprzez zmienną środowiskową SEARXNG_SETTINGS_PATH. Szablon kopiowany tam przez instalator jest krótki:

use_default_settings: true

general:
  debug: false
  instance_name: "SearXNG"

search:
  safe_search: 2
  autocomplete: 'duckduckgo'
  formats:
    - html

server:
  # Is overwritten by ${SEARXNG_SECRET}
  secret_key: "ultrasecretkey"
  limiter: true
  image_proxy: true

valkey:
  # URL to connect valkey database. Is overwritten by ${SEARXNG_VALKEY_URL}.
  url: valkey://localhost:6379/0

use_default_settings: true to linia, która zmienia sposób pracy. Dzięki niej plik zawiera tylko nadpisania, a każdy klucz, którego nie uwzględnisz, jest pobierany z wartości domyślnych dostarczonych w pakiecie. Bez niej plik musi opisywać całą konfigurację, silnik po silniku. W ten sposób powstają instancje, które uruchamiają się poprawnie, ale niczego nie znajdują. Stary plik ustawień Searx wklejony w tę ścieżkę jest kompletną konfiguracją z innymi nazwami kluczy, więc wybiera drugą drogę i robi to w sposób błędny.

Klucz tajny zatrzymuje proces

sudo -H sed -i -e "s/ultrasecretkey/$(openssl rand -hex 16)/g" \
              "/etc/searxng/settings.yml"

Uruchom to polecenie raz, po skopiowaniu szablonu. Pomiń ten krok, a SearXNG zarejestruje jedną linię w dzienniku i zakończy działanie z kodem 1, ponieważ webapp.py porównuje klucz z wartością w szablonie przed obsłużeniem jakiegokolwiek żądania:

server.secret_key is not changed. Please use something else instead of ultrasecretkey.

Sprawdzenie jest pomijane, gdy general.debug ma wartość true, więc instancja może działać poprawnie w sesji debugowania, a następnie odmawiać startu pod systemd lub w kontenerze. Kontener restartujący się w pętli z tą linią w docker compose logs oznacza, że to sprawdzenie wyzwala błąd, a nie uszkodzony obraz.

Limiter jest nowy i wymaga Valkey

Searx nie posiadał wbudowanego ograniczania liczby żądań (rate limiting). Publiczne instancje Searx umieszczały przed nim osobne usługi: filtron do filtrowania żądań oraz morty do proxy treści wyników. Żadne z tych repozytoriów nie otrzymało commita od stycznia 2023 roku: ostatni commit filtron pochodzi z tego miesiąca, a morty z kwietnia 2021 roku.

SearXNG wykonuje tę pracę samodzielnie. Ograniczanie żądań i wykrywanie botów to limiter, włączany za pomocą server.limiter. W dostarczonych ustawieniach domyślnych jest to false, a w szablonie instalatora true; wymaga on bazy danych Valkey do przechowywania liczników. Valkey to fork Redis, dostępny w pakietach Ubuntu 24.04:

sudo apt install -y valkey-server

server:
  limiter: true

valkey:
  url: valkey://localhost:6379/0

Poradniki napisane przed tą zmianą nazw konfigurują blok redis:, więc skopiuj nazwę klucza z aktualnej dokumentacji limitera. Dostrajanie odbywa się w drugim pliku, /etc/searxng/limiter.toml, a server.public_instance: true włącza bardziej rygorystyczne wykrywanie botów, którego wymaga publiczna instancja, w tym metodę tokena linku. Widocznym skutkiem jest odpowiadanie na niektóre żądania kodem HTTP 429 zamiast wynikami, co dotyczy również własnych żądań, jeśli używasz skryptów do odpytywania instancji. Temat ten posiada własną stronę: dlaczego instancja SearXNG odpowiada 429 Too Many Requests.

Silniki zawieszają się same, a limity czasu są długie

Gdy usługa nadrzędna odpowiada stroną z CAPTCHA lub informacją o limicie żądań, SearXNG zgłasza wyjątek i przestaje odpytywać dany silnik przez określony czas, zamiast ponawiać próby aż do zablokowania. Wartości domyślne znajdują się w searx/settings.yml w sekcji search.suspended_times. Są to wartości 6 opublikowane w październiku 2026 roku:

[
  {
    "label": "SearxEngineAccessDenied",
    "suspend_seconds": "180"
  },
  {
    "label": "SearxEngineCaptcha",
    "suspend_seconds": "3,600"
  },
  {
    "label": "SearxEngineTooManyRequests",
    "suspend_seconds": "180"
  },
  {
    "label": "cf_SearxEngineCaptcha",
    "suspend_seconds": "1,296,000"
  },
  {
    "label": "cf_SearxEngineAccessDenied",
    "suspend_seconds": "86,400"
  },
  {
    "label": "recaptcha_SearxEngineCaptcha",
    "suspend_seconds": "604,800"
  }
]

Zwykła odpowiedź o odmowie dostępu zawiesza silnik na 180 sekund. CAPTCHA zawiesza go na 3,600 sekund. Cloudflare CAPTCHA zawiesza go na 1,296,000 sekund, co oznacza piętnaście dni, a Google reCAPTCHA na 604,800 sekund, czyli tydzień. Długie wartości są celowe, ponieważ ponawianie zapytań po tym, jak usługa oznaczyła już adres IP, prowadzi do trwałego zablokowania instancji.

Podczas zawieszenia silnika strona wyników pomija go i zgłasza to w bloku paska bocznego zatytułowanym "Wiadomości z wyszukiwarek", a /stats/errors wymienia, co zawiodło. Świeża instancja zwracająca ubogie wyniki zazwyczaj pokazuje właśnie ten stan, a nie uszkodzoną instalację.

Interfejs JSON API jest domyślnie wyłączony

Domyślnym ustawieniem jest formats: [html] i nic więcej, więc API, którego wymaga każdy skrypt, jest zamknięte, dopóki go nie otworzysz.

curl -s -o /dev/null -w '%{http_code}\n' \
  'http://127.0.0.1:8888/search?q=test&format=json'

To wypisuje 403, ponieważ ścieżka wyszukiwania wywołuje flask.abort(403), gdy żądany format nie znajduje się na liście search.formats. Dodaj format i zrestartuj usługę:

search:
  formats:
    - html
    - json

Plik ustawień searx w ogóle nie posiadał klucza formats, więc jego wyjście JSON było dostępne od razu. Każdy skrypt i fragment kodu z tamtego okresu zakłada to samo, a trybem awarii jest zwykłe 403 bez wyjaśnienia. Jeśli integrujesz instancję z narzędziami, udostępnienie agentowi punktu końcowego SearXNG do wyszukiwania zaczyna się od tego jednego ustawienia.

Dlaczego kopiowane poradniki do Searx zawodzą

Każda z poniższych linii pojawia się w poradnikach, które nadal są wysoko w wynikach wyszukiwania, a każda z nich zawodzi lub wprowadza w błąd w aktualnej instalacji.

• sudo apt install searx na Ubuntu 24.04 zatrzymuje się na E: Unable to locate package searx, ponieważ pakiet został wydany ostatni raz w wersji 23.10 i usunięto go z 24.04 przed premierą.
• pip install searx kończy się sukcesem i instaluje wersję 0.17.0 z lipca 2020 roku. Brak ostrzeżenia, że wersja ta powstała przed forkami projektu.
• git clone https://github.com/asciimoo/searx nadal działa, ponieważ GitHub przekierowuje zapytania ze starej nazwy właściciela. Pobiera ona bieżącą domyślną gałąź, w której commit dokumentacji z maja 2026 roku znajduje się na kodzie aplikacji, który przestał być rozwijany w kwietniu 2023 roku.
• Kroki edytujące searx/settings.yml w drzewie źródłowym nie zmieniają niczego w SearXNG, który odczytuje /etc/searxng/settings.yml.
• Kroki instalujące filtron lub morty to ponowne budowanie elementów, które SearXNG już zawiera.
• Adres URL redis: dla limitera jest o jedną zmianę nazwy za aktualnym kluczem valkey:.

Poradniki do SearXNG również ulegają dezaktualizacji, a adres URL klonowania jest najszybszym sposobem na sprawdzenie ich wieku. Pliki compose znajdowały się wcześniej w oddzielnym repozytorium searxng-docker. Repozytorium to jest obecnie zarchiwizowane, ostatni push miał miejsce w marcu 2026 roku, a jego pliki przeniesiono do container/ w głównym repozytorium. Aktualny szybki start kontenerowy z dokumentacji to:

mkdir -p ./searxng/core-config/
cd ./searxng/
curl -fsSL \
    -O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
    -O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
cp -i .env.example .env
nano .env
docker compose up -d

Edytuj .env przed wykonaniem ostatniego polecenia. Obraz mapuje zmienne środowiskowe na klucze ustawień, więc SEARXNG_SECRET staje się server.secret_key, a SEARXNG_BASE_URL staje się server.base_url. Skryptowa instalacja na hoście to inna ścieżka o tym samym rezultacie:

git clone https://github.com/searxng/searxng.git searxng
cd searxng
sudo -H ./utils/searxng.sh install all

Tworzy ona użytkownika searxng, środowisko wirtualne w /usr/local/searxng oraz usługę uWSGI, co stanowi referencyjną konfigurację w dokumentacji SearXNG. Dłuższy opis tej ścieżki znajduje się w instalacja SearXNG na własnym VPS.

Instancja publiczna czy własna

Instancja publiczna to serwer należący do podmiotu trzeciego, który dokonuje terminacji połączenia TLS (transport layer security), co oznacza, że oprogramowanie na tym serwerze odczytuje zapytanie jako tekst jawny. Dokumentacja SearXNG stawia kwestię zaufania wprost: użytkownik musi ufać administratorowi i nie ma możliwości sprawdzenia, czy zapytania są logowane, agregowane lub przekazywane podmiotom trzecim. Widoczna lista jest krótka i kompletna. Stos technologiczny operatora widzi treść zapytania, czas, adres IP, z którego pochodzi żądanie, user agent przeglądarki oraz plik cookie z preferencjami użytkownika. Operator kontroluje również kod, więc każda wprowadzona przez niego poprawka jest wykonywana przy każdym wyszukiwaniu.

Domyślne ustawienie ułatwia przypadkowe logowanie. Searx wysyłał zapytania metodą POST. SearXNG dostarcza method: "GET" z komentarzem, że POST usuwa zapytania z historii przeglądarki, ale powoduje problemy z użytecznością. W przypadku GET zapytanie znajduje się w linii żądania, więc domyślnie trafia do logów dostępu reverse proxy oraz do historii przeglądarki. Jest to standardowe zachowanie serwera WWW. Warto o tym wiedzieć przed wyborem serwera, na którym odbywa się wyszukiwanie.

Uruchomienie własnej instancji przenosi zaufanie, zamiast je usuwać. Kontroluje się kod i dzienniki. Jeśli nie chcesz w ogóle publikować nazwy hosta ani certyfikatu TLS dla instancji przeznaczonej dla jednego użytkownika, dostęp przez usługę onion v3 pozwala pozostawić instancję poza publicznym DNS, a jednocześnie uzyskiwać do niej dostęp z dowolnego miejsca. W zamian silniki nadrzędne widzą jeden adres dla wszystkich wyszukiwań. W przypadku instancji jednoosobowej każde zapytanie można powiązać z tobą, zamiast mieszać je z zapytaniami innych użytkowników. Zajęta instancja publiczna zapewnia tę grupę użytkowników i przenosi obsługę dzienników poza ciebie. Należy wybrać właściwość, która ma największe znaczenie. Jeśli najpierw potrzebna jest pełna lista zagrożeń, czy korzystanie z SearXNG jest bezpieczne omawia ten temat. Historia lokalizacji wymaga takiego samego podejścia, ale przy większej stawce, ponieważ telefon raportujący położenie przez cały dzień ujawnia więcej niż jakikolwiek dziennik wyszukiwania. porównanie samodzielnie hostowanych trackerów lokalizacji to dobry punkt wyjścia, jeśli dane mają być przechowywane na serwerze pozostającym pod własną kontrolą.

Praktyczna uwaga dotycząca VPS. Zakresy adresów centrów danych są oznaczane szybciej niż połączenia domowe, dlatego nowa instancja może napotkać CAPTCHA w niektórych wyszukiwarkach już podczas kilku pierwszych wyszukiwań. Jest to opisane wyżej działanie mechanizmu zawieszania, a nie błąd konfiguracji. Jeżeli te same wyszukiwarki nadal są blokowane po wygaśnięciu zawieszenia, odczytanie rzeczywistego błędu przed wprowadzeniem zmian pozwoli uniknąć zgadywania przy wyborze poprawek.

Jeśli korzystasz już z instancji Searx

Nic nie ulegnie awarii w dniu, w którym przeczytasz ten tekst. Serwer będzie działał do momentu, aż kolejna zmiana w kodzie źródłowym spowoduje awarię silnika, po czym pozostanie w stanie niedziałającym. Zaplanuj migrację i nie przenoś pliku konfiguracyjnego. Zacznij od szablonu SearXNG, a następnie dodaj ponownie tylko te elementy, które celowo zmieniłeś: nazwę instancji, safe_search, nazwy włączonych lub wyłączonych silników oraz domyślne ustawienia interfejsu. Nazwy silników i opcje uległy zmianie w forku, dlatego sprawdź każdą z nich w aktualnej dokumentacji, zamiast zakładać, że klucz nadal istnieje. Reguły Filtron oraz adres URL dla morty nie mają odpowiedników, ponieważ te zadania zostały przeniesione do wnętrza aplikacji.

Uruchom nową instancję na innym porcie, podczas gdy stara jest nadal aktywna. Migracja przebiegła pomyślnie, gdy strona główna zwraca kod 200, wyszukiwanie zwraca wyniki z więcej niż jednego silnika, a /stats/errors jest puste lub zawiera tylko zrozumiałe błędy. Następnie przekieruj ruch na reverse proxy i zatrzymaj starą usługę.

FAQ

Czy Searx jest martwy w 2026 roku?

Repozytorium nie jest zarchiwizowane, więc nic nie stoi na przeszkodzie, aby je sklonować, jednak projekt nie jest utrzymywany. Ostatni commit kodu pojawił się w kwietniu 2023 roku, a plik README zawiera informację: "Searx is no longer maintained". Sprawdź to samodzielnie za pomocą curl -s https://api.github.com/repos/searx/searx | jq -r '.pushed_at', a następnie przejrzyj ostatnie komunikaty commitów, ponieważ sama data wypchnięcia zmian może wynikać z edycji dokumentacji. W przypadku wyszukiwarki metawyszukiwań brak utrzymania oznacza, że jakość wyników samoistnie spada, ponieważ każdy moduł wyszukiwarki zależy od zewnętrznego serwisu, który nieustannie wprowadza zmiany.

Czy nadal mogę zainstalować Searx za pomocą apt lub pip?

Nie w obecnych systemach i bezcelowo tam, gdzie jest to możliwe. Ubuntu ostatni raz spakowało searx w wersji 23.10 (wersja 1.1.0), a ostatnie wydanie LTS z tym pakietem to 22.04 (wersja 1.0.0). Pakiet został usunięty z wersji 24.04 przed jej wydaniem, więc sudo apt install searx w systemie 24.04 zwraca E: Unable to locate package searx. Debian dostarczał wersję 1.1.0 w wydaniu Debian 12, ale usunął ją z wersji testowej w październiku 2023 roku, więc Debian 13 nie posiada tego pakietu. PyPI nadal udostępnia wszystkie wydania searx, a najnowsze to 0.17.0 z lipca 2020 roku, które jest starsze niż sam fork. Zamiast tego zainstaluj SearXNG.

Czy moje stare ustawienia z settings.yml będą działać w SearXNG?

Nie. Skopiuj wartości, a nie cały plik. SearXNG odczytuje /etc/searxng/settings.yml i oczekuje use_default_settings: true na początku, dzięki czemu plik działa jako nakładka na domyślną konfigurację. Stary plik searx to pełna konfiguracja z innymi nazwami kluczy, która nie zawiera limiter, bloku valkey ani listy formats. Rozpocznij od szablonu dostępnego pod utils/templates/etc/searxng/settings.yml i dodawaj swoje zmiany pojedynczo.

Dlaczego moja własna instancja SearXNG zwraca mniej wyników niż instancja publiczna?

Niektóre wyszukiwarki są zawieszone. Gdy wyszukiwarka odpowiada za pomocą CAPTCHA lub strony z ograniczeniem częstotliwości zapytań (rate limit), SearXNG przestaje wysyłać do niej zapytania na określony czas, od 180 sekund w przypadku zwykłej odmowy do 1,296,000 sekund w przypadku CAPTCHA od Cloudflare. Strona z wynikami raportuje to w sekcji "Messages from the search engines", a /stats/errors wyświetla listę błędów wraz z przyczynami. Adresy IP centrów danych są blokowane szybciej niż połączenia domowe, dlatego nowa instancja na VPS napotyka ten problem wcześnie.

Czy powinienem korzystać z publicznej instancji SearXNG, czy uruchomić własną?

Uruchom własną instancję, jeśli chcesz mieć kontrolę nad kodem i logami, akceptując fakt, że zewnętrzne wyszukiwarki będą widzieć jeden adres IP dla wszystkich Twoich zapytań. Korzystaj z instancji publicznej, jeśli mieszanie Twoich zapytań z zapytaniami innych osób jest dla Ciebie ważniejsze niż wiedza o tym, co jest logowane. W przypadku instancji publicznej operator może widzieć treść zapytania, czas, Twój adres IP oraz User Agent, a także może zmienić kod w dowolnym momencie. Deklarowana polityka logowania nie może zostać zweryfikowana z zewnątrz.