SearXNGの429エラーとレート制限を直す方法
SearXNGの429エラーは自前のLimiterが原因です。上流の検索エンジンがサーバーIPをブロックすると429ではなく結果が欠けます。ログで原因を切り分け、正しい設定だけを直します。
SearXNG が 429 エラーを返す理由
自己ホスト型の SearXNG インスタンスでは、無関係な 2 か所でレート制限に達することがあります。通常、修正が必要なのは想定していたレート制限とは別のものです。429 を返すのは、そのうち 1 つだけです。1 つ目はローカル側です。SearXNG 自身のリミッターがリクエストを bot からのものと判断し、Too Many Requests に status 429 を返します。SearXNG がクライアントに 429 を送信するのは、このリミッターだけです。2 つ目は upstream 側です。検索エンジンがサーバーの IP アドレスからのアクセスを拒否します。SearXNG はそのエンジンを応答なしとして扱い、一時停止します。この場合、ユーザーには 429 ではなく、一部の結果が欠けた通常の検索結果ページが表示されます。
この 2 つのケースに共通する対処方法はありません。リミッターは自分の環境にあるため、変更できます。upstream によるブロックは Google 側で発生するため、settings.yml の設定を変更しても解除されません。どちらのケースかは、ログを確認すれば約 1 分で判断できます。まずログから確認してください。
このガイドでは、自身の VPS 上で自己ホストする SearXNG インスタンスで説明している container install を前提とします。以下の設定名はすべて、2026 年 10 月 23 日に確認した最新の upstream documentation と source に基づいています。
設定を変更する前にログを読む
ログ画面を開いたまま問題を再現します。upstream の compose ファイルでは、SearXNG サービス名は core です(コンテナ名は searxng-core です)。docker compose コマンドでは、このサービス名を指定します。
cd ./searxng/
docker compose logs -f coreLimiter のメッセージは searx.limiter という名前の logger から出力され、クライアントのネットワークを示します。blocklist に該当すると BLOCK 203.0.113.10/32: matched BLOCKLIST、allowlist に該当すると PASS 203.0.113.10/32: matched PASSLIST と表示されます。どちらの場合も、その後に一致したリスト項目が続きます。Limiter がカウンターストアに接続できない場合は The limiter requires Valkey, please consult the documentation と記録されます。これは、何もカウントされていないことを意味します。
個々の bot チェックはすべて debug レベルで記録されるため、デフォルトでは表示されません。settings.yml で、1 回のテスト中だけ debug を有効にします。
general:
debug: trueその後のログには BLOCK 203.0.113.10/32: missing HTTP header Accept-Language のような行が追加され、クライアントのネットワークと失敗したヘッダーが示されます。テスト後は再び無効にしてください。upstream では、debug を有効にしたまま稼働中のインスタンスを実行しないよう案内しています。
Engine の失敗は、これとはまったく異なります。IP ではなく engine 名が示され、現在のソースではこれも debug レベルで記録されます。最も一般的なのは timeout で、その後に例外名が続きます。
HTTP requests timeout (search duration : 3.1 s, timeout: 3.0 s)この内容を確認できるページもあります。enable_metrics がデフォルトの true のままであれば、インスタンスは engine エラーを /stats/errors に記録し、/preferences で現在応答している engine を一覧表示します。/stats/errors が埋まっていて、ログに searx.limiter 行がない場合、問題は limiter ではありません。
デバッグを始める前にバージョンを固定する
上流のコンテナ構成は2つのファイルで成り立っています。
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 .envcompose ファイルは docker.io/searxng/searxng:${SEARXNG_VERSION:-latest} を取得します。変数が未設定の場合は latest になり、latest では次の docker compose pull にインスタンスの内容が変わるため、先週動作した設定が、その設定を読み込むコードと一致しなくなることがあります。SearXNG のタグには日付とコミットが含まれます。2026年10月時点で上流の .env.example にある例のタグは 2026.3.25-541c6c3cb です。.env には実際の値を設定してください。
SEARXNG_VERSION=2026.3.25-541c6c3cb公開されているタグを確認し、実際にテストしたリリースを固定してから、固定した対象に対してデバッグします。同じ .env ファイルには Secret key も保存されます。そのため、そのディレクトリをどこかにコミットする前に、Docker Compose で env ファイルと Secret がどのように機能するかを確認してください。
リミッターには Valkey が必要です。Valkey がないと動作しません
リミッターはクライアントごとのリクエスト数を数えます。これらのカウントはワーカープロセス間で共有する必要があります。その保存先が Valkey です。Valkey は Redis の保守継続フォークです。古い SearXNG ガイドでは、この設定を redis: と記載しています。現在のリリースでは valkey: を読み取るため、古い投稿ではなく、現在のドキュメントからキー名をコピーしてください。さらに古いページには、SearXNG ではなく Searx について説明しているものもあります。両者は異なるコードベースで、リミッターも異なります。そのため、設定ブロックをコピーする前に、そのページがどちらのプロジェクト向けに書かれたものかを確認してください。
use_default_settings: true
server:
secret_key: "change-this-value"
limiter: true
public_instance: false
valkey:
url: valkey://searxng-valkey:6379/0upstream の compose ファイルは、docker.io/valkey/valkey:9-alpine イメージを使用する valkey サービスをすでに実行しています。コンテナ名は searxng-valkey です。そのため、compose ネットワーク内ではそのホスト名を解決できます。同じ値は SEARXNG_VALKEY_URL 環境変数でも設定できます。SearXNG と Valkey が同じホストを共有する場合は、Unix ソケット URL(unix:///path/to/socket.sock?db=0)も使用できます。
ストアがない場合の動作は、もう1つのキーによって変わります。public_instance: false の場合、リミッターは Valkey のエラーをログに記録して処理を中止します。そのため、インスタンスはレート制限なしでサービスを提供し続けます。public_instance: true の場合、プロセスは代わりに sys.exit(1) を呼び出します。ボット対策が壊れた状態で公開インスタンスを運用すると、1日以内にすべての検索エンジンから CAPTCHA(completely automated public turing test to tell computers and humans apart)を収集することになるためです。public_instance: true を設定した直後からコンテナがループして再起動する場合は、この状態です。各終了直前の最後の行に Valkey が示されます。
リミッターが実際に数えるもの
このグラフのデータ
[
{
"label": "Burst, normal client",
"max_requests": 15,
"window": "20 seconds"
},
{
"label": "Burst, flagged client",
"max_requests": 2,
"window": "20 seconds"
},
{
"label": "Sustained, normal client",
"max_requests": 150,
"window": "10 minutes"
},
{
"label": "Sustained, flagged client",
"max_requests": 10,
"window": "10 minutes"
},
{
"label": "Any non-HTML format",
"max_requests": 4,
"window": "1 hour"
},
{
"label": "Flagged requests before block",
"max_requests": 3,
"window": "30 days"
}
]通常のクライアントは、20 秒のバーストウィンドウ内で 15 件、10 分のウィンドウ内で 150 件のリクエストを送信できます。クライアントが不審と判定されると、バーストウィンドウあたり 2 件まで減ります。最後の行が最も厳しい制限です。30 日のウィンドウ内で 3 件の不審なリクエストがあると、そのアドレスは検索ページではなく開始ページへリダイレクトされ、ログには BLOCK: too many request from ... in SUSPICIOUS_IP_WINDOW (redirect to /) と記録されます。
これらの数値は searx/botdetection/ip_limit.py に定数として定義されています。設定値ではなく、limiter.toml からも変更できないため、変更するにはソースを編集する必要があります。/etc/searxng/limiter.toml で制御できるのは、クライアントをグループ化するアドレスプレフィックス、信頼するプロキシの一覧、オプションのリンクトークン検査、許可リストとブロックリストです。
不審と判定された行は、リンクトークン検査が有効な場合だけ適用されます。これは limiter.toml の link_token = true で有効にするか、public_instance: true が自動的に有効にする場合です。その後、ブラウザーが、ランダムなトークンを含む URL のスタイルシートを読み込むまで、クライアントは不審な状態として扱われます。スクリプトがこの処理を行うことはありません。リンクトークン検査が無効なデフォルト状態では、すべてのクライアントに通常の行が適用されます。
ヘッダーチェックは、何かを不審と判定するのではなく、失敗したリクエストをその場で 429 として拒否するため、より厳格です。各チェックは searx/botdetection/ のモジュールで、デバッグログの行には失敗したヘッダーが記録されます。
http_accept:Acceptヘッダーにtext/htmlが含まれていません。http_accept_encoding:Accept-Encodingヘッダーにgzipもdeflateも指定されていません。http_accept_language:Accept-Languageヘッダーがありません。http_user_agent:User-Agentがないか、既知のボットパターンに一致しています。http_sec_fetch:Sec-Fetch-*ヘッダーがブラウザーの送信する内容になっていません。このチェックは、それらのヘッダーを送信することが既知のブラウザーのバージョンから HTTPS リクエストを受けた場合だけ実行されます。429 を返す代わりに開始ページへリダイレクトします。現在のソースでは、実際にこのリダイレクトを発生させるのは無効なSec-Fetch-Modeだけです。無効なSec-Fetch-SiteやSec-Fetch-Destはデバッグレベルで記録されますが、リクエストは処理を続行します。
ブラウザーはこれらをすべて送信します。一方、通常の curl 呼び出しでは、これらのほとんどが送信されません。そのため、手書きのテストリクエストは最初の試行で拒否され、同じ検索がブラウザーのタブでは成功します。「ブラウザーでは動作するのに、スクリプトでは 429 になる」のは、この仕組みでは不思議な結果ではなく、通常の結果です。
リバースプロキシの背後でリミッターを使用すると全員が同時にブロックされる
これは、動作しているインスタンスを壊す最も一般的な原因です。SearXNG は X-Forwarded-For にある最初の信頼されていない IP からクライアントアドレスを取得し、取得できなければ X-Real-IP にフォールバックし、それでも取得できなければ接続元のアドレスを使用します。これらのヘッダーを信頼するかどうかは、limiter.toml にある trusted_proxies で決まります。botdetection のドキュメントでは X-Real-IP だけが設定されている場合、trusted_proxies は無視されると説明されています。しかし、2026 年 10 月 23 日に確認した searx/botdetection/trusted_proxies.py のコードでは、接続元アドレスが信頼されていない場合に両方のヘッダーが破棄されます。そのため、X-Real-IP だけを送信してもリストを回避できません。
プロキシのアドレスがそのリストに含まれていない場合、ヘッダーは無視され、すべての訪問者がプロキシのアドレスからアクセスしたように扱われます。その結果、全員で 1 つのカウンターを共有します。10 分間の合計が 150 リクエストを超えると、サイト全体がまとめてブロックされます。1 人のユーザーが結果ページを数回再読み込みしただけで、全員がアクセスできなくなります。
信頼しすぎる構成はさらに危険です。公開範囲をリストに追加すると、訪問者は誰でも独自の X-Forwarded-For ヘッダーを送信し、リクエストごとに新しい識別情報を選べます。これにより、その方法を知っているユーザーはリミッターを無効化できます。リストには、自分のプロキシが接続元として使用するアドレスだけを追加してください。Docker では通常、172.16.0.0/12 内の bridge network が該当します。この行はコメントアウトされた状態で出荷されています。
[botdetection]
ipv4_prefix = 32
ipv6_prefix = 48
trusted_proxies = [
'127.0.0.0/8',
'::1',
'172.16.0.0/12',
]プロキシ側でもヘッダーを送信する必要があります。Nginx はこれらを自動的に追加しません。
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 と Traefik は転送ヘッダーを自動的に設定するため、これらを使用する場合は trusted_proxies 側だけ設定すれば済みます。トレードオフについては、自己ホストサービス用のリバースプロキシを選ぶで説明しています。どちらの構成でも、確認するには debug を有効にし、モバイルデータ通信中のスマートフォンから 1 回検索します。その後、ログ行に表示されるネットワークがプロキシのアドレスではなく、スマートフォンのアドレスになっていることを確認してください。
エージェントは 1 時間あたり 4 件の API リクエストを実行できます
JSON 出力はデフォルトで無効になっているため、エージェント側で有効にする必要があります。
search:
formats:
- html
- jsonここで、もう一度チャートの行を確認します。HTML 以外の形式を要求するリクエストは、アドレスごとに独自のウィンドウでカウントされます。上限は 4 件、期間は 1 hour です。リサーチエージェントは 1 つのタスクでこの上限を使い切り、それ以降の呼び出しはすべて 429 を返します。この数値はソース内の定数であるため、config から増やすことはできません。ただし、増やす必要はありません。エージェントのアドレスをカウント対象から完全に除外できます。
確実な修正方法は、このクライアントを未登録のクライアントとして扱わないよう limiter に伝えることです。limiter.toml の pass list にアドレスを追加します。
[botdetection.ip_lists]
block_ip = []
pass_ip = [
'10.8.0.0/24',
]
pass_searxng_org = truepass_ip は他のすべての方法より優先されます。また、upstream 自身の limiter.toml にあるコメントでは、このリストのアドレスに無制限のアクセスを許可すると説明されています。したがって、allowlist に登録したクライアントは 4 件のリクエストウィンドウの制限を受けず、ヘッダーチェックもスキップされ、引数なしの curl 呼び出しも機能します。範囲は可能な限り小さくし、ルーティング可能なネットワークより VPN のサブネットやコンテナネットワークを優先してください。もう 1 つの確実な方法は、エージェントをパブリック経路から完全に外すことです。内部ネットワーク上のコンテナアドレスを接続先にすれば、proxy とその limiter はトラフィックを認識しません。この構成については、AI エージェントに SearXNG 検索スキルを追加するで説明しています。
避けるべき方法は、他者が運用するパブリックインスタンスをエージェントの接続先にすることです。これは volunteer の IP アドレスが upstream のエンジンによってブロックされる最短の経路です。JSON 形式がデフォルトで無効になっているのも、そのためです。
エンジンにブロックされた場合
このグラフのデータ
[
{
"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"
}
]エンジンが独自の 429 または CAPTCHA ページを返すと、SearXNG は名前付き例外を発生させ、そのエンジンへのリクエストをしばらく停止します。訪問者に 429 が表示されることはありません。検索結果は通常どおり返りますが、そのエンジンの結果だけが含まれなくなります。too many requests の応答では 180 秒間、一時停止します。access denied の応答でも 3 minutes の間、一時停止します。通常の CAPTCHA では 1 hour の間、一時停止します。Cloudflare 経由で提供された CAPTCHA では 15 days の間、一時停止します。これは一覧の既定値で最も長い期間です。この応答はブロックがエッジ側にあることを示し、再試行しても解決しないためです。該当した CAPTCHA の行によって、次に試す価値のある対処が変わります。インスタンスが記録した例外が分かれば、CAPTCHA エラーには専用の対処方法があります。
以下は、SearXNG に付属する searx/settings.yml の値です。23 October 2026 に確認しています。設定ドキュメントには、より古く長い値が掲載されています。too many requests は 1 hour、access denied と通常の CAPTCHA は 1 day です。そのため、値を引用しているページよりも、インスタンスが実際に読み込んでいるファイルを優先してください。
通常の失敗には別の設定が使われます。タイムアウトまたは接続失敗では、エンジンを search.ban_time_on_fail 秒間停止します。既定値は 5 です。ただし、停止時間は既定で search.max_ban_time_on_fail を超えません。既定値は 120 です。パースエラーは /stats/errors に記録されますが、エンジンは停止しません。そのため、応答の遅いエンジンは数秒以内に自動的に復旧します。一方、CAPTCHA を返したエンジンは 1 hour 以上利用できなくなります。この違いが、ランダムに見える現象の原因です。検索結果は正常なのに、あるエンジンの結果だけが毎回 1 hour 消えることがあります。
誰かを疑う前に、タイムアウトを修正してください。既定の request_timeout は 3.0 seconds です。エンジンの最寄りのエッジサーバーから遠い小規模 VPS では、これでも短すぎる場合があります。
outgoing:
request_timeout: 3.5
max_request_timeout: 10.0
engines:
- name: bing
timeout: 5.0request_timeout はすべてのエンジンに対する既定値です。max_request_timeout は上限です。個々のエンジンには独自の timeout を設定できます。値を大きくすると、ページの待ち時間と引き換えに失敗を減らせます。10 まで一気に増やすのではなく、0.5 seconds ずつ変更し、/stats/errors を確認してください。
アドレスを実際にブロックしているエンジンは削除してください。各検索は最も遅いエンジンを待つため、恒久的に停止されているエンジンを残しても、待ち時間が増えるだけで結果は返りません。
use_default_settings:
engines:
remove:
- googledocker compose restart core で変更を適用し、いくつか検索を実行してから /stats/errors を再読み込みします。実際に 5 minutes 使用した後も空のページが表示されるなら、変更は有効です。
データセンターのIPはボットとして扱われます
VPSのIPアドレスはホスティング事業者の範囲に属しており、大手検索エンジンはその範囲を自動化されたアクセス元としてスコアリングします。一部のエンジンは、ヘッダーがどれほど適切であっても、リクエストの間隔がどれほど長くても、そのようなアドレスからのすべてのリクエストに対してCAPTCHAを表示します。settings.ymlの設定でこの判定を変更することはできません。ユーザーが入力したクエリではなくサーバーが検索エンジンと通信するという点は、セルフホストによって生じるプライバシー上のトレードオフそのものであり、SearXNGが実際にどの程度隠すのかを読んでから、それ以上の保護が期待できると判断することをお勧めします。
変更可能なのは、どの検索エンジンに問い合わせるか、およびインスタンスを公開するかどうかです。1世帯で利用するプライベートなインスタンスであれば、制限に抵触することはほとんどありません。ホスティングIP上の公開インスタンスは、最も厳格なエンジンから順次アクセス停止処分を受けることになりますが、これは設定の不備ではなく、ソフトウェアの仕様として正常な状態です。SearXNGはoutgoing.proxiesまたはoutgoing.using_tor_proxyを使用してエンジンへのリクエストをプロキシ経由でルーティングでき、これにより通信元アドレスを変更可能です。ただし、出口ノードや安価なプロキシプールはホスティング範囲よりもさらに低い評価を受けるため、この対策によって検索結果の質が低下する可能性がある点に留意してください。
インスタンスを監視し、最初に異常を把握する
すべてのエンジンが停止中でも、SearXNG はポートへの応答を返します。そのため、ステータスコードだけを監視する稼働確認では、インスタンスが何も返していなくても正常な状態が続きます。応答内容を確認してください。実際の検索を実行し、応答本文に含まれる想定した単語を照合します。Uptime Kuma のキーワード監視なら、追加のツールなしでこれを実行できます。バージョンを更新するたびに /stats/errors も監視してください。エンジンの HTML が変更されると、レート制限が関係していなくてもパーサーが壊れるためです。
FAQ
SearXNG をリバースプロキシの背後に配置すると、なぜすべての訪問者に 429 が返るのですか?
リミッターがプロキシをクライアントとして数えているためです。SearXNG は、接続元アドレスが /etc/searxng/limiter.toml の trusted_proxies に登録されている場合にのみ X-Forwarded-For を読み取ります。登録されていない場合、すべての訪問者が 1 つのカウンターを共有し、10 分あたり 150 リクエストの上限を全員で同時に超えます。プロキシの接続元アドレスを追加してください。Docker では通常、ブリッジ範囲の 172.16.0.0/12 です。また、プロキシが X-Real-IP と X-Forwarded-For を送信することを確認してください。管理していない範囲は絶対に登録しないでください。信頼されたネットワークからは、訪問者がそのヘッダーを任意に設定し、リクエストごとに新しい識別情報を選べるためです。
SearXNG のリミッターは、1 時間あたり何件の API リクエストを許可しますか?
IP アドレスごとに 1 時間あたり 4 件です。HTML 以外の形式を要求するリクエストは、別の 1 時間ウィンドウで数えられます。この数値は limiter.toml ではなく searx/botdetection/ip_limit.py で設定されるため、config から増やすことはできません。agent またはスクリプトは、1 つのタスクでこの制限に達します。limiter.toml の pass_ip に登録されたアドレスは無制限にアクセスでき、カウント対象にもなりません。そのため、クライアントのアドレスをそこに追加するか、リミッターがリクエストを認識しない内部ネットワーク経由でインスタンスにアクセスしてください。
検索結果が 429 エラーなしで空になるのはなぜですか?
拒否しているのはユーザーではなく、サーバーです。自分のインスタンスで /stats/errors を開いてください。失敗した各エンジンとその理由が表示されます。CAPTCHA またはアクセス拒否の項目がある場合、そのエンジンがサーバーの IP アドレスをブロックしています。SearXNG はその後、エンジンを一時停止します。too-many-requests またはアクセス拒否の応答後は 3 分間、通常の CAPTCHA 後は 1 時間、Google または Cloudflare の CAPTCHA 後は 1 週間以上停止します。ローカル設定で上流側のブロックを解除することはできません。そのため、アドレスをブロックするエンジンを削除し、応答するエンジンを残してください。
プライベートなインスタンスでもリミッターを有効にすべきですか?
自分以外からインスタンスにアクセスされない場合は、limiter: false のままにしてください。リミッターを有効にすると Valkey への依存関係が追加され、自分のスクリプトもブロックされます。また、存在しないトラフィックから保護することになります。インスタンスにパブリックアドレスを割り当てた時点で、public_instance: true と併せて有効にしてください。この組み合わせには意図があります。public_instance: true が設定されていて Valkey が正常に動作しない場合、プロセスは保護なしで実行を続けず、ステータス 1 で終了します。