SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

SearXNG: 429-Fehler und Rate-Limits beheben

SearXNG meldet `Too Many Requests` aus zwei Quellen: lokalem Limiter oder Upstream-Bildanfrage. Prüfen Sie Logs und API-Zähler, bevor Sie die Sperre ändern.

Warum SearXNG 429-Fehler zurückgibt

Eine selbst gehostete SearXNG-Instanz stößt an zwei voneinander unabhängigen Stellen auf Rate-Limits. Das Rate-Limit, das Sie beheben müssen, ist meist nicht das, welches Sie vermuten. Sowohl die lokale Begrenzung als auch eine Anfrage nach einem Bild bei einem Upstream-Dienst können einen 429-Fehler verursachen. Die erste Ursache ist lokal: Der eigene Limiter von SearXNG stuft eine Anfrage als Bot ein und antwortet auf Too Many Requests mit dem Status 429. Der Endpunkt /image leitet ebenfalls Upstream-Fehlerstatus weiter, darunter 429. Die zweite Ursache liegt beim Upstream-Dienst: Eine Suchmaschine lehnt die IP-Adresse Ihres Servers ab. SearXNG markiert diese Suchmaschine als nicht erreichbar und deaktiviert sie vorübergehend. Ihre Benutzer erhalten weiterhin eine normale Ergebnisseite, auf der Inhalte fehlen, aber keinen 429-Fehler.

Für die beiden Fälle gibt es keine gemeinsame Lösung. Der Limiter gehört zu Ihrer Instanz, daher können Sie ihn ändern. Eine Sperre durch einen Upstream-Dienst erfolgt auf dessen Seite. Eine Änderung Ihres lokalen Limiters hebt sie daher nicht auf. Anhand des Logs erkennen Sie innerhalb von etwa einer Minute, welcher Fall vorliegt. Beginnen Sie deshalb dort.

Diese Anleitung setzt die in eine selbst gehostete SearXNG-Instanz auf Ihrem eigenen VPS beschriebene Installation mit einem Container voraus. Alle unten genannten Einstellungsnamen stammen aus der aktuellen Upstream-Dokumentation und dem Quellcode. Sie wurden am 16. November 2026 überprüft.

Lesen Sie das Protokoll, bevor Sie eine Einstellung ändern

Reproduzieren Sie das Problem mit geöffnetem Protokollfenster. In der Upstream-Compose-Datei heißt der SearXNG-Dienst core; sein Container heißt searxng-core. docker compose-Befehle verwenden den Dienstnamen:

cd ./searxng/
docker compose logs -f core

Limiter-Meldungen stammen von Loggern mit den Namen searx.limiter und searx.botdetection. Sie nennen das Client-Netzwerk. Ein Treffer in der Blocklist wird als BLOCK 203.0.113.10/32: matched BLOCKLIST protokolliert. Ein Treffer in der Allowlist wird als PASS 203.0.113.10/32: matched PASSLIST protokolliert. Auf beide Einträge folgt der passende Listeneintrag. Kann der Limiter seinen Zählerspeicher nicht initialisieren, lautet die Meldung The limiter requires Valkey, please consult the documentation. Das bedeutet, dass der Limiter nicht installiert wurde.

Jede einzelne Bot-Prüfung wird auf Debug-Level protokolliert. Standardmäßig sehen Sie diese Meldungen daher nicht. Aktivieren Sie Debug für einen Test in settings.yml:

general:
  debug: true

Das Protokoll enthält dann zusätzliche Zeilen im Format BLOCK 203.0.113.10/32: missing HTTP header Accept-Language. Diese nennen das Client-Netzwerk und den Header, der die Prüfung nicht bestanden hat. Deaktivieren Sie Debug anschließend wieder. Upstream weist darauf hin, dass eine bereitgestellte Instanz nicht mit aktiviertem Debug betrieben werden soll.

Fehler von Engines sehen ganz anders aus. Sie nennen statt einer IP-Adresse eine Engine. Die detaillierte Timeout-Meldung wird auf Debug-Level protokolliert. Die Meldung engine timeout des Such-Threads wird auf Error-Level protokolliert:

HTTP requests timeout (search duration : 3.1 s, timeout: 3.0 s)

Dafür gibt es außerdem eine Seite. Wenn enable_metrics den Standardwert true hat, protokolliert Ihre Instanz Engine-Fehler in /stats/errors. /preferences listet die Engines auf, die derzeit Antworten liefern. Ein Eintrag in /stats/errors weist auf einen Engine-Fehler hin. Fehlende searx.limiter-Zeilen schließen jedoch keine Blockierung durch den Limiter aus, da einzelne Bot-Prüfungen mit searx.botdetection auf Debug-Level protokolliert werden.

Version festlegen, bevor Sie mit der Fehlersuche beginnen

Das Upstream-Container-Setup besteht aus zwei Dateien.

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

Die Compose-Datei ruft docker.io/searxng/searxng:${SEARXNG_VERSION:-latest} ab. Eine nicht gesetzte Variable bedeutet latest. latest bedeutet, dass sich die Instanz beim nächsten docker compose pull unter Ihnen ändert. Dadurch kann eine Einstellung, die letzte Woche funktioniert hat, nicht mehr zum Code passen, der sie einliest. SearXNG-Tags enthalten ein Datum und einen Commit. Das Beispiel-Tag im Upstream-.env.example vom Oktober 2026 lautet 2026.3.25-541c6c3cb. Setzen Sie daher in .env einen konkreten Wert:

SEARXNG_VERSION=2026.3.25-541c6c3cb

Prüfen Sie die veröffentlichten Tags und legen Sie das tatsächlich getestete Release fest. Führen Sie die Fehlersuche anschließend gegen ein unveränderliches Ziel durch. Dieselbe .env-Datei kann Ihren geheimen Schlüssel über SEARXNG_SECRET aufnehmen. Lesen Sie daher wie Umgebungsdateien und Secrets in Docker Compose funktionieren, bevor Sie dieses Verzeichnis an irgendeinem Ort einchecken.

Der Limiter benötigt Valkey, sonst läuft er nicht

Der Limiter zählt Anfragen pro Client. Diese Zähler müssen zwischen Worker-Prozessen gemeinsam verwendet werden. Dafür wird Valkey eingesetzt, der gepflegte Fork von Redis. Ältere SearXNG-Anleitungen nennen diese Einstellung redis:. Aktuelle Releases lesen valkey:. Übernehmen Sie den Schlüsselnamen daher aus der aktuellen Dokumentation und nicht aus einem älteren Beitrag. Manche dieser Seiten gehen noch weiter zurück und beschreiben Searx statt SearXNG. Dabei handelt es sich um eine andere Codebasis mit einem anderen Limiter. Prüfen Sie daher, für welches der beiden Projekte die Seite geschrieben wurde, bevor Sie daraus einen Konfigurationsblock übernehmen.

use_default_settings: true
server:
  secret_key: "change-this-value"
  limiter: true
  public_instance: false
valkey:
  url: valkey://searxng-valkey:6379/0

Die Upstream-Compose-Datei startet bereits einen valkey-Dienst mit dem Image docker.io/valkey/valkey:9-alpine in einem Container namens searxng-valkey. Dieser Hostname wird daher innerhalb des Compose-Netzwerks aufgelöst. Derselbe Wert kann mit der Umgebungsvariablen SEARXNG_VALKEY_URL gesetzt werden. Eine Unix-Socket-URL (unix:///path/to/socket.sock?db=0) funktioniert, wenn SearXNG und Valkey denselben Host verwenden.

Was passiert, wenn der Store fehlt, hängt von einem weiteren Schlüssel ab. Mit public_instance: false protokolliert der Limiter den Valkey-Fehler und beendet sich. Die Instanz stellt dann weiterhin Anfragen bereit, jedoch vollständig ohne Rate Limiting. Mit public_instance: true ruft der Prozess stattdessen sys.exit(1) auf. Dadurch wird keine öffentliche Instanz ohne Bot-Schutz betrieben. Ein Container, der nach diesem Valkey-Initialisierungsfehler in einer Neustartschleife läuft, benötigt eine korrigierte Valkey-Verbindung.

Was der Limiter tatsächlich zählt

DiagrammSearXNG limiter: requests allowed per client network, defaults in ip_limit.py
Die Daten hinter diesem Diagramm
[
  {
    "label": "Burst, link token off",
    "max_requests": 15,
    "window": "20 seconds"
  },
  {
    "label": "Burst, flagged client",
    "max_requests": 2,
    "window": "20 seconds"
  },
  {
    "label": "Sustained, link token off",
    "max_requests": 150,
    "window": "10 minutes"
  },
  {
    "label": "Sustained, flagged client",
    "max_requests": 10,
    "window": "10 minutes"
  },
  {
    "label": "Non-HTML format in URL query",
    "max_requests": 4,
    "window": "1 hour"
  },
  {
    "label": "Flagged requests before block",
    "max_requests": 3,
    "window": "30 days"
  }
]

Wenn die Prüfung des Link-Tokens deaktiviert ist, erhält ein Client innerhalb eines 20-Sekunden-Burst-Fensters 15 Anfragen und innerhalb eines 10-Minuten-Fensters 150. Ist sie aktiviert, umgeht ein Client, der die Link-Token-Prüfung besteht, beide Zähler. Ein verdächtiger Client erhält 2 Anfragen pro Burst-Fenster. Die letzte Zeile ist am strengsten: Nach 3 markierten Anfragen innerhalb eines 30-Tage-Fensters wird diese Adresse statt zur Suche auf die Startseite umgeleitet. Im Log steht dann BLOCK: too many request from ... in SUSPICIOUS_IP_WINDOW (redirect to /). Das Bestehen der Link-Token-Prüfung setzt den Zähler für verdächtige Anfragen dieses Clients zurück.

Diese Zahlen sind Konstanten in searx/botdetection/ip_limit.py. Sie sind keine Einstellungen, und limiter.toml stellt sie nicht bereit. Zum Ändern müssen Sie daher den Quellcode bearbeiten. /etc/searxng/limiter.toml steuert hingegen die Adresspräfixe, nach denen Clients gruppiert werden, die Liste der vertrauenswürdigen Proxies, die optionale Link-Token-Prüfung sowie die Pass- und Blocklisten.

Die markierten Zeilen gelten nur, wenn diese Link-Token-Prüfung aktiviert ist. Das kann entweder über link_token = true in limiter.toml geschehen oder weil public_instance: true sie für Sie aktiviert. Ein Client gilt dann als verdächtig, bis er ein Stylesheet lädt, dessen URL ein zufälliges Token enthält. Bei deaktiviertem Link-Token, also standardmäßig, erhält jeder Client, der diese Zähler erreicht, die normalen Zeilen.

Die Header-Prüfungen sind strenger, weil sie nichts markieren: Eine Anfrage, die eine dieser Prüfungen nicht besteht, wird sofort mit 429 abgewiesen. Jede Prüfung ist ein Modul in searx/botdetection/. Die Debug-Logzeile nennt den Header, an dem die Prüfung fehlgeschlagen ist:

  • http_accept: Der Accept-Header enthält nicht text/html.
  • http_accept_encoding: Der Accept-Encoding-Header nennt weder gzip noch deflate.
  • http_accept_language: Es gibt keinen Accept-Language-Header.
  • http_user_agent: Der User-Agent fehlt oder entspricht einem bekannten Bot-Muster.
  • http_sec_fetch: Die Sec-Fetch-*-Header entsprechen nicht denen, die ein Browser sendet. Diese Prüfung läuft nur bei HTTPS-Anfragen von Browserversionen, die diese Header bekanntermaßen senden. Statt mit 429 zu antworten, wird die Anfrage auf die Startseite umgeleitet. Im aktuellen Quellcode löst nur ein ungültiger Sec-Fetch-Mode diese Umleitung tatsächlich aus. Ein ungültiger Sec-Fetch-Site oder Sec-Fetch-Dest wird auf Debug-Ebene protokolliert, aber die Anfrage wird zugelassen.

Ein Browser sendet all diese Header. Ein einfacher curl-Aufruf sendet fast keinen davon. Deshalb wird eine manuell erstellte Testanfrage bereits beim ersten Versuch abgewiesen, während dieselbe Suche in einem Browser-Tab funktioniert. Daher ist „Im Browser funktioniert es, aber mein Skript erhält 429“ das normale Ergebnis und kein rätselhaftes Verhalten.

Hinter einem Reverse Proxy blockiert der Limiter alle gleichzeitig

Dies ist die häufigste Ursache dafür, dass eine zuvor funktionierende Instanz nicht mehr funktioniert. SearXNG übernimmt die Client-Adresse aus der ersten nicht vertrauenswürdigen IP-Adresse in X-Forwarded-For, verwendet ersatzweise X-Real-IP und greift danach auf die Adresse zurück, von der die Verbindung geöffnet wurde. Ob diesen Headern überhaupt vertraut wird, legt trusted_proxies in limiter.toml fest. Die Dokumentation zur Bot-Erkennung besagt, dass trusted_proxies ignoriert wird, wenn nur X-Real-IP gesetzt ist. Der Code in searx/botdetection/trusted_proxies.py, geprüft am 16 November 2026, verwirft jedoch beide Header, sobald die verbindende Adresse nicht vertrauenswürdig ist. Nur X-Real-IP zu senden, umgeht die Liste daher nicht.

Wenn die Adresse Ihres Proxy nicht in dieser Liste steht, werden die Header ignoriert. Jeder Besucher erscheint dann mit der Adresse des Proxy. Alle verwenden denselben Zähler. Bei deaktivierter Prüfung von Link-Tokens wird dadurch die gesamte Website gemeinsam blockiert, sobald die Gesamtzahl 150 Anfragen innerhalb von 10 Minuten überschreitet. Bei aktivierter Prüfung von Link-Tokens verwenden verdächtige Clients gemeinsam die strengeren Zähler. Ein Client, der die Prüfung besteht, umgeht dagegen die Zähler für Bursts und lange Zeitfenster.

Zu viel Vertrauen ist noch problematischer. Wenn ein öffentliches Netzwerk eingetragen ist, kann ein Besucher aus diesem vertrauenswürdigen Netzwerk seinen eigenen X-Forwarded-For-Header senden und für jede Anfrage eine neue Identität auswählen. Tragen Sie nur die Adresse ein, von der aus Ihr eigener Proxy Verbindungen herstellt. In Docker ist das normalerweise ein Bridge-Netzwerk innerhalb von 172.16.0.0/12. Diese Zeile ist standardmäßig auskommentiert.

[botdetection]
ipv4_prefix = 32
ipv6_prefix = 48

trusted_proxies = [
  '127.0.0.0/8',
  '::1',
  '172.16.0.0/12',
]

Auch der Proxy muss die Header senden. Nginx fügt X-Forwarded-Proto, X-Real-IP oder X-Forwarded-For nicht selbst hinzu:

location / {
    proxy_pass http://127.0.0.1:8080;

    proxy_set_header Host              $host;
    proxy_set_header Connection        $http_connection;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
}

Caddy und Traefik setzen die weitergeleiteten Header automatisch. Bei diesen Proxys müssen Sie daher nur den Teil trusted_proxies konfigurieren. Die jeweiligen Vor- und Nachteile werden unter Auswahl eines Reverse Proxy für einen selbst gehosteten Dienst erläutert. Um eine der beiden Konfigurationen zu prüfen, aktivieren Sie debug, führen Sie einmal über Ihr Smartphone im Mobilfunknetz eine Suche durch und prüfen Sie, ob die Netzwerkadresse in der Logzeile die Adresse Ihres Smartphones und nicht die des Proxy ist.

Die API-Grenze Ihres Agenten hängt von der Anfrage ab

Die JSON-Ausgabe ist standardmäßig deaktiviert. Ein Agent muss sie daher anfordern:

search:
  formats:
    - html
    - json

Lesen Sie nun erneut die entsprechende Zeile in der Tabelle. Eine /search-Anfrage mit einem URL-Abfrageparameter format, der nicht html entspricht, wird in einem eigenen Zeitfenster gezählt: 4 Anfragen pro 1 hour und Clientnetzwerk. Die API unterstützt POST-Formularparameter. Ein Nicht-HTML-Format, das ausschließlich über POST-Formulardaten angegeben wird, erhöht diesen API-Zähler jedoch nicht. Andere Prüfungen des Limiters gelten weiterhin. Die Prüfung des Link-Tokens zu bestehen, umgeht den API-Zähler nicht. Dieser wird zuerst ausgeführt. Ein Research-Agent, der ?format=json verwendet, verbraucht dieses Kontingent mit einer Aufgabe. Jeder weitere Aufruf liefert anschließend 429 zurück. Die Zahl selbst ist im Quellcode als Konstante festgelegt. Sie können sie daher nicht über die Konfiguration erhöhen. Das ist aber auch nicht nötig: Sie können die Adresse des Agenten vollständig aus der Zählung herausnehmen.

Die saubere Lösung besteht darin, dem Limiter mitzuteilen, dass dieser Client kein unbekannter Client ist. Fügen Sie seine Adresse in limiter.toml zur Pass-Liste hinzu:

[botdetection.ip_lists]
block_ip = []

pass_ip = [
  '10.8.0.0/24',
]

pass_searxng_org = true

pass_ip hat Vorrang vor allen anderen Methoden. Der eigene Kommentar des Upstream-Projekts in limiter.toml besagt außerdem, dass eine Adresse in dieser Liste uneingeschränkten Zugriff erhält. Ein Client auf der Allowlist unterliegt daher nicht dem Limit von vier Anfragen pro Zeitfenster. Er überspringt außerdem die Header-Prüfungen, und ein einfacher curl-Aufruf funktioniert. Halten Sie den Bereich so klein wie möglich. Bevorzugen Sie ein VPN-Subnetz oder ein Containernetzwerk gegenüber einem von außen routbaren Netzwerk. Wenn Sie den Agenten direkt auf den Container in einem internen Netzwerk verweisen, wird der eigene Limiter von SearXNG nicht umgangen. Setzen Sie die Adresse des Clients auf die Allowlist, die SearXNG tatsächlich sieht. Die Einrichtung wird unter einem SearXNG-Suchmodul für einen AI-Agenten beschrieben.

Vermeiden Sie es, einen Agenten auf eine öffentliche Instanz zu verweisen, die von einer anderen Person betrieben wird. Automatisierter Datenverkehr über SearXNG kann dazu führen, dass diese Instanz von den Upstream-Suchmaschinen gesperrt wird.

Wenn die Engines stattdessen blockieren

DiagrammHow long SearXNG suspends an engine, search.suspended_times defaults
Die Daten hinter diesem Diagramm
[
  {
    "label": "SearxEngineTooManyRequests",
    "suspended_seconds": 180,
    "roughly": "3 minutes"
  },
  {
    "label": "SearxEngineAccessDenied",
    "suspended_seconds": 180,
    "roughly": "3 minutes"
  },
  {
    "label": "SearxEngineCaptcha",
    "suspended_seconds": 3600,
    "roughly": "1 hour"
  },
  {
    "label": "recaptcha_SearxEngineCaptcha",
    "suspended_seconds": 604800,
    "roughly": "7 days"
  },
  {
    "label": "cf_SearxEngineCaptcha",
    "suspended_seconds": 1296000,
    "roughly": "15 days"
  }
]

Wenn eine Engine mit einem eigenen 429-Fehler oder einer CAPTCHA-Seite antwortet, löst SearXNG eine benannte Exception aus und fragt diese Engine eine Zeit lang nicht mehr ab. Ihre Besucher sehen diesen 429-Fehler der Such-Engine nie: Die Suche liefert weiterhin eine normale Ergebnisseite, nur ohne diese Engine. Eine Antwort mit zu vielen Anfragen setzt die Engine für 180 Sekunden aus, eine Antwort mit verweigertem Zugriff ebenfalls für 3 minutes. Ein einfaches CAPTCHA setzt sie für 1 hour aus. Ein über Cloudflare ausgeliefertes CAPTCHA setzt sie für 15 days aus, also für die längste Standarddauer in der Liste. Welche der drei CAPTCHA-Zeilen bei Ihnen zutrifft, bestimmt, was Sie als Nächstes versuchen sollten. Die CAPTCHA-Fehler haben eigene Fehlerbehebungen, sobald Sie wissen, welche Exception Ihre Instanz aufgezeichnet hat.

Dies sind die Werte aus der searx/settings.yml, die mit SearXNG ausgeliefert wird, geprüft am 16. November 2026. Die Einstellungsdokumentation nennt weiterhin ältere, längere Werte: eine Stunde für zu viele Anfragen sowie einen Tag für verweigerten Zugriff und für ein einfaches CAPTCHA. Verlassen Sie sich daher auf die Datei, die Ihre Instanz tatsächlich lädt, und nicht auf eine Seite, die diese Werte zitiert.

Für gewöhnliche Fehler gelten andere Einstellungen. Ein Timeout oder eine fehlgeschlagene Verbindung setzt die Engine für search.ban_time_on_fail Sekunden aus, standardmäßig 5, und nie länger als search.max_ban_time_on_fail, standardmäßig 120. Ein Parse-Fehler wird in /stats/errors aufgezeichnet, setzt die Engine jedoch nicht aus. Eine langsame Engine wird daher innerhalb weniger Sekunden automatisch wieder verwendet, während eine Engine, die ein CAPTCHA ausgeliefert hat, mindestens eine Stunde lang nicht verfügbar ist. Dieser Unterschied erklärt ein Symptom, das häufig als zufällig beschrieben wird: Die Ergebnisse sind zunächst vollständig, dann fehlen die Ergebnisse einer Engine jeweils eine Stunde lang.

Timeouts sollten Sie beheben, bevor Sie anderen Ursachen die Schuld geben. Der Standardwert request_timeout beträgt 3.0 Sekunden. Das kann für einen kleinen VPS, der weit vom nächstgelegenen Edge-Server einer Engine entfernt steht, knapp bemessen sein.

outgoing:
  request_timeout: 3.5
  max_request_timeout: 10.0
engines:
  - name: bing
    timeout: 5.0

request_timeout ist der Standardwert für jede Engine, max_request_timeout ist die Obergrenze, und eine einzelne Engine kann einen eigenen Wert für timeout verwenden. Höhere Werte erhöhen die Latenz der Seite und reduzieren zugleich die Zahl der Fehler. Erhöhen Sie den Wert daher in Schritten von einer halben Sekunde und beobachten Sie /stats/errors, statt sofort auf 10 zu springen.

Wenn eine Engine Ihre Adresse tatsächlich blockiert, entfernen Sie sie. Ausgesetzte Engines werden übersprungen, bis ihre Aussetzungsdauer abgelaufen ist. Eine Engine, die Sie wiederholt blockiert, verursacht weitere fehlgeschlagene Wiederholungsversuche, sobald sie wieder verwendet werden darf.

use_default_settings:
  engines:
    remove:
      - google

Übernehmen Sie die Änderungen mit docker compose restart core. Führen Sie anschließend einige Suchvorgänge aus und laden Sie /stats/errors neu. Prüfen Sie nicht nur die aufgezeichneten Fehler, sondern auch, ob die Suchvorgänge Ergebnisse liefern.

Eine Rechenzentrums-IP-Adresse kann als Bot eingestuft werden

Google blockiert Netzwerke, bei denen automatisierter Datenverkehr festgestellt wird. Dazu gehören auch gemeinsam genutzte VPN-Netzwerke. Keine lokale Limiter-Einstellung hebt diese Sperre auf upstream auf. Dass die Suchmaschinen statt der Person, die die Anfrage eingibt, Ihren Server sehen, ist außerdem der gesamte Datenschutzkompromiss des Self-Hostings. Daher lohnt es sich, wie viel SearXNG tatsächlich verbirgt zu lesen, bevor Sie annehmen, dass es mehr abdeckt.

Sie können ändern, welche Suchmaschinen Sie abfragen und ob Ihre Instanz öffentlich gelistet ist. SearXNG kann Anfragen an Suchmaschinen mit outgoing.proxies oder outgoing.using_tor_proxy über einen Proxy leiten. Dadurch wird der Datenverkehr über eine andere Adresse übertragen. Eine andere Ausgangsadresse garantiert keinen Zugriff. Google blockiert auch einige gemeinsam genutzte VPN- und Tunneldienste, weil von deren Benutzern automatisierter Datenverkehr ausgeht.

Überwachen Sie die Instanz, damit Sie Probleme zuerst erkennen

SearXNG antwortet auf seinem Port, auch wenn alle Engines angehalten sind. Eine Uptime-Prüfung, die nur den Statuscode überwacht, bleibt deshalb grün, obwohl die Instanz keine Ergebnisse zurückgibt. Prüfen Sie stattdessen den Inhalt: Führen Sie eine echte Suche aus und suchen Sie im Antworttext nach einem erwarteten Wort. Keyword-Überwachung mit Uptime Kuma erledigt genau das ohne zusätzliche Werkzeuge. Überwachen Sie /stats/errors außerdem nach jedem Versionssprung, da sich das HTML der Engines ändern kann und ein Parser dadurch ohne Beteiligung eines Rate-Limits ausfällt.

FAQ

Warum gibt SearXNG jedem Besucher 429 zurück, nachdem ich es hinter einen Reverse Proxy gestellt habe?

Weil der Limiter den Proxy als Client zählt. SearXNG liest X-Forwarded-For nur dann aus, wenn die Verbindungsadresse in trusted_proxies in /etc/searxng/limiter.toml aufgeführt ist. Ist sie dort nicht aufgeführt, teilen sich alle Besucher einen Zähler. Bei deaktivierter Link-Token-Prüfung überschreiten sie gemeinsam das Limit von 150 Anfragen innerhalb von 10 Minuten. Bei aktivierter Link-Token-Prüfung teilen sich verdächtige Clients strengere Zähler. Clients, die die Prüfung bestehen, umgehen dagegen die Burst- und Langzeitfenster-Zähler. Fügen Sie die Adresse hinzu, von der aus Ihr Proxy die Verbindung herstellt. In Docker ist dies normalerweise der Bridge-Bereich 172.16.0.0/12. Stellen Sie außerdem sicher, dass der Proxy X-Real-IP und X-Forwarded-For sendet. Führen Sie niemals einen Bereich auf, den Sie nicht kontrollieren. Ein Client aus einem vertrauenswürdigen Bereich kann diesen Header setzen und für jede Anfrage eine neue Identität wählen.

Wie viele API-Anfragen pro Stunde erlaubt der SearXNG-Limiter?

Vier pro Client-Netzwerk und Stunde für /search Anfragen, deren URL-Abfrageparameter format nicht html ist. Ein Nicht-HTML-Format, das ausschließlich in POST-Formulardaten angegeben wird, erhöht diesen API-Zähler nicht. Andere Prüfungen des Limiters gelten jedoch weiterhin. Dieser Wert ist in searx/botdetection/ip_limit.py und nicht in limiter.toml festgelegt. Er kann daher nicht über die Konfiguration erhöht werden. Ein Agent oder ein Skript, das ?format=json verwendet, übermittelt es in einer Aufgabe. Eine in pass_ip in limiter.toml aufgeführte Adresse erhält uneingeschränkten Zugriff und wird überhaupt nicht gezählt. Fügen Sie daher die Adresse des Clients dort hinzu. Eine Verbindung über ein internes Netzwerk allein umgeht den SearXNG-Limiter nicht.

Warum bleiben meine Suchergebnisse ohne 429-Fehler leer?

Die Engines lehnen Ihren Server ab, nicht Ihre Benutzer. Öffnen Sie /stats/errors auf Ihrer eigenen Instanz. Dort wird jede Engine aufgeführt, die fehlgeschlagen ist, einschließlich des Grundes. Ein CAPTCHA- oder Access-Denied-Eintrag bedeutet, dass diese Engine die IP-Adresse Ihres Servers blockiert hat. SearXNG setzt die Engine anschließend aus: für drei Minuten nach einer Antwort mit zu vielen Anfragen oder einer Zugriffsverweigerung, für eine Stunde nach einem einfachen CAPTCHA und für mindestens eine Woche nach einem reCAPTCHA oder Cloudflare CAPTCHA. Keine lokale Einstellung des Limiters hebt eine Sperre durch einen Upstream-Dienst auf. Entfernen Sie daher die Engines, die Ihre Adresse blockieren, und behalten Sie die Engines, die antworten.

Sollte ich den Limiter auf einer privaten Instanz aktivieren?

Wenn nur Sie auf die Instanz zugreifen, lassen Sie limiter: false. Der Limiter fügt eine Valkey-Abhängigkeit hinzu und blockiert Ihre eigenen Skripte. Außerdem schützt er vor Datenverkehr, dem die Instanz nicht ausgesetzt ist. Aktivieren Sie ihn, sobald die Instanz eine öffentliche Adresse erhält, zusammen mit public_instance: true. Diese Kombination ist beabsichtigt: Wenn public_instance: true gesetzt ist und bei der Initialisierung kein funktionierendes Valkey verfügbar ist, beendet sich der Prozess mit Status 1, statt ungeschützt weiterzulaufen.

War dieser Artikel hilfreich?