Browse Source

[doc] settings.py document search.suspended_times

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Markus Heiser 2 years ago
parent
commit
031162be04
1 changed files with 27 additions and 0 deletions
  1. 27 0
      docs/admin/engines/settings.rst

+ 27 - 0
docs/admin/engines/settings.rst

@@ -110,6 +110,13 @@ Global Settings
      default_lang: ""
      default_lang: ""
      ban_time_on_fail: 5
      ban_time_on_fail: 5
      max_ban_time_on_fail: 120
      max_ban_time_on_fail: 120
+     suspended_times:
+       SearxEngineAccessDenied: 86400
+       SearxEngineCaptcha: 86400
+       SearxEngineTooManyRequests: 3600
+       cf_SearxEngineCaptcha: 1296000
+       cf_SearxEngineAccessDenied: 86400
+       recaptcha_SearxEngineCaptcha: 604800
      formats:
      formats:
        - html
        - html
 
 
@@ -159,6 +166,25 @@ Global Settings
 ``max_ban_time_on_fail``:
 ``max_ban_time_on_fail``:
   Max ban time in seconds after engine errors.
   Max ban time in seconds after engine errors.
 
 
+``suspended_times``:
+  Engine suspension time after error (in seconds; set to 0 to disable)
+
+  ``SearxEngineAccessDenied``: 86400
+    For error "Access denied" and "HTTP error [402, 403]"
+
+  ``SearxEngineCaptcha``: 86400
+    For error "CAPTCHA"
+
+  ``SearxEngineTooManyRequests``: 3600
+    For error "Too many request" and "HTTP error 429"
+
+  Cloudflare CAPTCHA:
+     - ``cf_SearxEngineCaptcha``: 1296000
+     - ``cf_SearxEngineAccessDenied``: 86400
+
+  Google CAPTCHA:
+    - ``recaptcha_SearxEngineCaptcha``: 604800
+
 ``formats``:
 ``formats``:
   Result formats available from web, remove format to deny access (use lower
   Result formats available from web, remove format to deny access (use lower
   case).
   case).
@@ -168,6 +194,7 @@ Global Settings
   - ``json``
   - ``json``
   - ``rss``
   - ``rss``
 
 
+
 .. _settings server:
 .. _settings server:
 
 
 ``server:``
 ``server:``