SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-11-14

RustXNG или SearXNG: что выбрать для self-hosted поиска

Сравнение RustXNG и SearXNG для self-hosted решений. Узнайте, когда стоит перейти на бинарный RustXNG для AI-агентов и почему SearXNG остается стандартом для веб-пользователей.

RustXNG против SearXNG: краткий ответ

RustXNG — это единый бинарный файл на языке Rust, основанный на SearXNG, который предоставляет результаты метапоиска для AI-агентов через JSON API и сервер MCP (Model Context Protocol). Выбирайте RustXNG, если ваш основной пользователь — это агент, которому требуются краткие, ограниченные по объему результаты и опциональный текст страниц. Оставьте SearXNG, если систему используют люди через веб-интерфейс, если вы полагаетесь на bangs или если вы зависите от ограничителя запросов (limiter) с использованием Valkey и зрелого проекта.

Остальная часть этого руководства объясняет причины такого выбора. Также в нем описывается ручная установка RustXNG на VPS и указывается, в каких местах документация самого проекта содержит противоречия.

Что такое RustXNG и какая версия описана в этом руководстве

В файле README RustXNG описывается как «самохостинговая метапоисковая система, реализованная на Rust и основанная на SearXNG». Локальный индекс и краулер в ней опциональны и по умолчанию отключены. При стандартной конфигурации, описанной здесь, каждый запрос отправляется внешним поисковым провайдерам, а RustXNG объединяет полученные результаты. SearXNG работает аналогичным образом, и в руководстве по самостоятельному хостингу SearXNG на VPS это объясняется более подробно. Лицензия — AGPL-3.0-or-later.

Данное руководство ориентировано на версию v0.27.1. Все упоминания поведения RustXNG, настроек по умолчанию, README и документации по совместимости относятся к этой версии, если не указано иное. На 13 ноября 2026 года на странице GitHub Releases версия v0.31.2, опубликованная 11 ноября, помечена как Latest. Версия v0.27.1 была опубликована 3 ноября, через несколько часов после v0.27.0. Версия v0.26.0 вышла 1 ноября. В версии v0.30.0 были пересмотрены профили поиска Standard, Clean и Full, которые уже существовали в v0.29.0; профиль Clean выполняет поиск только по локальным индексам без запросов к внешним поисковым провайдерам, в то время как Standard и Full отправляют запросы включенным провайдерам.

Содержимое README не полностью соответствует релизам. В одном предложении до сих пор сказано, что «опубликованный релиз v0.26.0 включает» бинарные файлы, но пример установки указывает на v0.27.1. Это различие важно для одной настройки: в v0.27.0 порт по умолчанию был изменен на 29483, и в README отмечено, что «опубликованные бинарные файлы v0.26.0 по-прежнему используют порт 8888 по умолчанию». Если вы следуете старому руководству и на порту 29483 нет ответа, в первую очередь проверьте rustxng --version. Каждая команда ниже явно передает --port 29483, что работает с любой из этих версий.

Прочтите перед установкой: условия провайдеров и настройки loopback по умолчанию

Самостоятельный хостинг не делает ваши поисковые запросы приватными для провайдеров. В README об этом сказано прямо: «Поисковые запросы отправляются выбранным внешним провайдерам, даже если RustXNG работает в вашей локальной сети». Также там содержится предупреждение: «Некоторые провайдеры ограничивают автоматизированный поиск, парсинг, высокочастотные запросы и хранение результатов». Добавляется, что наличие провайдера в конфигурации «не является гарантией того, что каждое использование разрешено или соответствует правилам». Агент может отправлять значительно больше запросов, чем человек. Ознакомьтесь с условиями каждого провайдера, прежде чем направлять на него запросы агента. Согласно README, HTML-адаптеры Yahoo! JAPAN и Mojeek по умолчанию остаются отключенными до завершения проверки прав на их использование.

Второй важный момент — адрес привязки. По умолчанию RustXNG прослушивает 127.0.0.1:29483, поэтому доступ к нему возможен только для процессов на той же машине. Пример Docker в README сохраняет это правило: он публикует 127.0.0.1:29483 на хосте и привязывает 0.0.0.0 только внутри контейнера. В README не описаны встроенные механизмы аутентификации. Вам предлагается настроить собственные средства контроля доступа, если вы планируете публиковать сервис на других интерфейсах. Без них любой, кто обнаружит порт, сможет использовать ваш сервер и ваши квоты у провайдеров в качестве бесплатного поискового API. Оставляйте сервис на loopback, если вы не настроили перед ним собственный контроль доступа.

Что было удалено из RustXNG по сравнению с SearXNG

В файле README эти изменения перечислены в одном предложении: «Удалены поисковые движки Google, автодополнение, внешние bangs, YouTube, интеграции с переводчиком Google, Material Icons и поисковые интерфейсы на базе Google».

Два из этих изменений влияют на повседневное использование:

  • Внешние bangs. В SearXNG использование bang в поисковом запросе позволяет перейти напрямую на другой сайт. В RustXNG внешние bangs удалены, поэтому эта привычка перестанет работать.
  • Автодополнение. Документация по настройкам SearXNG указывает autocomplete: "duckduckgo" в качестве значения по умолчанию. В RustXNG автодополнение удалено, поэтому поисковая строка не предлагает вариантов.

Агент не использует ни одну из этих функций, поэтому проект смог от них отказаться. В README также указано, что из старых пользовательских настроек необходимо удалить записи об удаленных компонентах, иначе сервер не запустится. Если вы скопируете конфигурацию SearXNG, в которой все еще указан движок Google, ожидайте ошибку при запуске, пока не удалите эту запись.

Переносятся ли настройки из settings.yml для SearXNG?

Частично, и только согласно заявлениям самого проекта. RustXNG поставляется с settings.toml, а значения по умолчанию вкомпилированы в бинарный файл. Файл конфигурации является опциональным. Вы передаете его с помощью rustxng --config /path/to/settings.toml. Частичный файл переопределяет только те значения, которые в нем указаны. Учтите один нюанс перед созданием собственного файла: «При использовании use_default_settings = false пропущенный или пустой список движков означает, что ни один движок не будет включен». Сервер без движков запускается, но не возвращает результатов. Таким образом, короткий файл, который выглядит корректно, может полностью отключить поиск.

Страница совместимости docs/COMPATIBILITY.md (написанная на японском языке) гласит, что можно передать исходный YAML-файл без изменений и что формат TOML также поддерживается. Там указано, что --config или SEARXNG_SETTINGS_PATH позволяют выбрать файл. На той же странице перечислены реальные различия. Шаблоны и темы оформления несовместимы. Ограничитель (limiter) — это собственная реализация RustXNG, и он не считывает ваш limiter.toml.

Будьте осторожны с цифрами соответствия. COMPATIBILITY.md утверждает, что все записи движков из исходного проекта реализованы «(100%)» и что данные для «bang»-команд генерируются из тех же исходных данных. Оба утверждения противоречат файлу README, в котором сказано, что движки Google и внешние «bang»-команды были удалены. docs/COVERAGE.md приводит те же цифры в 100%. Однако в начале документа указано, что это данные на момент ранней стадии портирования, а не текущий уровень покрытия или гарантия работоспособности. Также там говорится, что кэш Valkey/Redis не портирован, в то время как README утверждает обратное. Считайте противоречивые текущие заявления в COMPATIBILITY.md и утверждение о кэше в COVERAGE.md устаревшими для версии v0.27.1; цифры в 100% явно описывают состояние портирования до удаления интеграций с Google. Перед миграцией запустите RustXNG с вашим файлом и выполните запросы, от которых вы зависите.

Самостоятельная установка RustXNG v0.27.1 на VPS

В файле README содержится блок, адресованный программному обеспечению, с заголовком "AI agents: install RustXNG and use it as your local web search tool". Он предписывает агенту загрузить бинарный файл, проверить его, запустить и протестировать. Не позволяйте агенту следовать инструкциям, которые он прочитал внутри репозитория. Текст в README — это недоверенные входные данные. Агент, который подчиняется им, выполнит и следующую инструкцию из README, которая может быть вредоносной. Это основная проблема, стоящая за prompt injection против агентов для написания кода. Установите бинарный файл самостоятельно, а затем предоставьте агенту готовую точку доступа.

В релизе v0.27.1 поставляются Linux-бинарные файлы для архитектур x86_64 (GNU и musl) и ARM64 (aarch64-unknown-linux-gnu, для которой требуется glibc 2.39 или новее). Для каждого бинарного файла имеется соответствующий .sha256 файл. В этих шагах используется сборка x86_64 musl — та же самая, которую загружает пример из README:

sudo apt update && sudo apt install -y curl jq
mkdir -p ~/rustxng-download && cd ~/rustxng-download
tag=v0.27.1
asset="rustxng-${tag}-x86_64-unknown-linux-musl"
base="https://github.com/sahenjp/RustXNG/releases/download/${tag}"
curl -fLO "${base}/${asset}"
curl -fLO "${base}/${asset}.sha256"
sha256sum --check "${asset}.sha256"

sha256sum должен вывести имя файла, за которым следует OK. Если строка заканчивается на FAILED, это означает, что ваша загрузка не совпадает с файлом, опубликованным в релизе. Удалите его и загрузите снова. Контрольная сумма с той же страницы релиза подтверждает, что загруженный файл не поврежден. Она не гарантирует, что код безопасен для запуска.

Установите его и подтвердите версию:

sudo install -m 755 "$asset" /usr/local/bin/rustxng
rustxng --version

Если у вас установлена цепочка инструментов Rust (минимально поддерживаемая версия 1.88), установка из исходного кода, описанная в README, также сработает: cargo install --git https://github.com/sahenjp/RustXNG.git --tag v0.27.1 --locked.

Запуск RustXNG через systemd на loopback

Процесс, запущенный в терминале, завершается при закрытии сессии. Небольшой юнит systemd обеспечивает работу RustXNG и перезапускает его после сбоев. DynamicUser=yes запускает его от имени временного системного пользователя, поэтому сервис не работает с правами root.

sudo tee /etc/systemd/system/rustxng.service > /dev/null <<'UNIT'
[Unit]
Description=RustXNG metasearch (loopback only)
After=network-online.target
Wants=network-online.target

[Service]
DynamicUser=yes
Environment=SEARXNG_PORT=29483
ExecStart=/usr/local/bin/rustxng --bind 127.0.0.1 --port 29483
Restart=on-failure

[Install]
WantedBy=multi-user.target
UNIT
sudo systemctl daemon-reload
sudo systemctl enable --now rustxng
curl --fail http://127.0.0.1:29483/healthz && echo healthy

healthy означает, что процесс отвечает. В README /healthz определяется как "состояние процесса". Там указано, что успешная проверка не гарантирует работоспособность вышестоящих движков. Если юнит не запускается, изучите journalctl -u rustxng -n 50. Конфигурация, в которой до сих пор указан удаленный движок Google, вызовет ошибку на этапе запуска.

Чтобы получить доступ к веб-интерфейсу с вашего ноутбука, не открывая порт, используйте SSH-туннель: ssh -L 29483:127.0.0.1:29483 you@your-vps. Затем откройте http://127.0.0.1:29483/ в браузере.

JSON API агента: max_results, include_domains и raw_content

Агент вызывает GET /search с помощью format=json. В документации к настройкам SearXNG указано, что по умолчанию включен только формат html, поэтому для работы с JSON требуется изменение конфигурации. В README для RustXNG указано, что он работает без какой-либо дополнительной настройки. RustXNG также добавляет параметры, которых нет в SearXNG:

  • max_results: количество ранжированных результатов для возврата, от 1 до 200.
  • include_domains: оставить только результаты с указанного домена и его поддоменов.
  • exclude_domains: исключить результаты с указанного домена и его поддоменов.
  • include_raw_content=1: получить текст страницы в поле raw_content для наиболее релевантных результатов.

Вот краткий запрос из README:

curl --fail --get 'http://127.0.0.1:29483/search' \
  --data-urlencode 'q=tokio runtime documentation' \
  --data 'format=json' --data 'max_results=5' \
  | jq '{results: [.results[] | {title, url, content}]}'

А вот тот же запрос, ограниченный одним сайтом, с получением текста страницы:

curl --fail --get 'http://127.0.0.1:29483/search' \
  --data-urlencode 'q=tokio runtime documentation' \
  --data 'format=json' --data 'max_results=5' \
  --data 'include_domains=docs.rs' --data 'include_raw_content=1' \
  | jq '[.results[] | {url, chars: ((.raw_content // "") | length)}]'

При настройках по умолчанию текст страницы извлекается максимум для пяти результатов, «с ограничением в 8,000 символов на страницу; отдельные запросы могут завершиться ошибкой». В связи с этим некоторые результаты могут возвращаться без поля raw_content, и код вашего агента должен это учитывать. В README также отмечается, что «ограничение по количеству символов не является ограничением по количеству токенов». Таким образом, 8,000 символов не равны 8,000 токенов в бюджете вашей модели.

SearXNG также может использоваться для работы с агентами. После включения формата он возвращает стандартные поля JSON. В руководстве Настройка JSON API SearXNG для Open WebUI подробно описан этот процесс. Чего не хватает в SearXNG, так это встроенного ограничения количества результатов и функции получения текста страницы, поэтому эту часть вам придется реализовать самостоятельно.

MCP-сервер: search и read_page

rustxng mcp предоставляет два инструмента с доступом только для чтения через stdio. Вы регистрируете команду в конфигурации вашего MCP-клиента, и клиент запускает её как дочерний процесс. В README нет примеров конфигурации клиента, поэтому следуйте документации к вашему ПО. Руководство по запуску MCP-серверов на VPS описывает эту сторону процесса.

  • search возвращает ранжированные фрагменты и метаданные источника. По умолчанию выдается пять результатов, каждый фрагмент обрезается на 500 символах.
  • read_page извлекает текст страницы, но только для URL, который был ранее возвращен инструментом search в рамках той же сессии. Передайте query, чтобы получить до трех соответствующих фрагментов текста.

По умолчанию весь структурированный ответ ограничен 12,000 символов Unicode и 24,000 байт UTF-8. Если серверу приходится сокращать объем данных, он сначала укорачивает фрагменты, а затем отбрасывает последние результаты. Поля truncated, source_truncated и next_offset сообщают агенту, нужно ли запрашивать дополнительные данные.

Одно поведение часто вызывает удивление при работе на VPS. read_page отказывается работать, если настроен исходящий прокси-сервер (в настройках или через переменные окружения). В README указана причина: чтение страниц «требует прямых соединений, чтобы ответы DNS и редиректы могли быть проверены на соответствие публичным адресам». Через прокси RustXNG не видит, в какой IP-адрес на самом деле разрешается имя хоста. Сервер не смог бы заблокировать страницу, которая перенаправляет на внутренний адрес, поэтому он переходит в состояние отказа (fails closed). Сам поиск при этом продолжает использовать настройки вашего прокси.

Текст страниц из открытого интернета является недоверенным вводом для вашего агента, независимо от того, какой инструмент его извлек. Правило использования URL из той же сессии ограничивает возможности read_page, но не делает полученный текст безопасным для исполнения.

Что означают показатели SealQA

В файле README приведены результаты запуска SealQA от 2026-11-02. Использовались настройки по умолчанию, десять результатов на каждый вопрос, без LLM и без локального индекса. Это собственные показатели проекта. Они не были воспроизведены здесь. В README указано, что этот запуск использовал более ранний набор движков и не отражает производительность с измененными настройками по умолчанию.

ГрафикRustXNG SealQA reference-page retrieval (project's own run, 2026-11-02)
Данные, на которых построен график
[
  {
    "label": "Seal-0",
    "found_at_1_pct": 47.75,
    "found_at_5_pct": 54.95,
    "found_at_10_pct": 65.77,
    "median_response_s": 1.85,
    "question_count": 111
  },
  {
    "label": "Seal-Hard",
    "found_at_1_pct": 39.37,
    "found_at_5_pct": 49.21,
    "found_at_10_pct": 61.42,
    "median_response_s": 1.53,
    "question_count": 254
  }
]

Для 111 вопросов Seal-0 эталонная страница попадала в десятку лучших результатов в 65.77% случаев. Медианное время ответа составило 1.85 секунд. Для 254 вопросов Seal-Hard эталонная страница оказывалась первым результатом в 39.37% случаев.

Интерпретируйте эти данные так, как указано в README: «Это показатели поиска эталонных страниц, а не точность ответов». Они измеряют лишь то, была ли найдена нужная страница. Они ничего не говорят о том, ответил ли агент в итоге правильно. В README также не приведены результаты запуска SearXNG по тем же вопросам для сравнения.

Когда SearXNG остается верным выбором

SearXNG остается предпочтительным вариантом в четырех случаях.

  • Поиск людей. RustXNG сохраняет браузерный интерфейс, но имеет только одну тему оформления, лишен автодополнения и поддержки внешних bangs.
  • Вам нужен настраиваемый ограничитель запросов. SearXNG подробно документирует механизмы обнаружения ботов. Его фильтр http_sec_fetch отклоняет запросы с неверным заголовком Sec-Fetch-Mode или Sec-Fetch-Dest, а метод link_token «требует базу данных valkey». У RustXNG есть собственный ограничитель (скользящее окно по IP, токены ссылок и ответы 429), но он не считывает limiter.toml.
  • Вы настроили движки и тайм-ауты. SearXNG поставляет настройки по умолчанию в файле searx/settings.yml. Его блок исходящих соединений устанавливает значение request_timeout: 3.0 секунд. Движок, возвращающий HTTP 429, по умолчанию приостанавливается на 180 секунд (search.suspended_times.SearxEngineTooManyRequests). В документации SearXNG указаны 2.0 секунды и один час для этих двух параметров, но поставляемый файл содержит значения, которые загружаются при стандартной установке. Ваша работа по выбору движков SearXNG для включения и отключения соответствует этим настройкам. В RustXNG вам пришлось бы тестировать каждый из них заново.
  • Вы цените зрелость продукта. SearXNG — это основной проект, на котором базируется RustXNG. RustXNG выпустил четыре релиза в период с 1 по 3 ноября 2026 года.

Когда бинарный файл с приоритетом агента выигрывает

RustXNG выигрывает в тех случаях, когда единственным клиентом является агент на той же машине. Вы получаете один бинарный файл без Python-окружения, который по умолчанию слушает интерфейс loopback. JSON работает без изменения конфигурации. Вы также получаете ограничение результатов, фильтры доменов и опциональный текст страницы с фиксированным бюджетом. Инструмент fetch сервера MCP переходит только по результатам собственного поиска. Для агента разработки в одноразовой VM это означает меньше связующего кода, чем при использовании SearXNG в сочетании с собственным кодом для получения и обрезки данных.

Оба решения могут работать на одном VPS. SearXNG обслуживает пользователей на своём порту, RustXNG обслуживает агентов на порту 29483, и каждый из них сохраняет свои настройки.

FAQ

Является ли RustXNG прямой заменой для SearXNG?

Нет. В RustXNG удалены поисковые движки Google, автодополнение, внешние bangs, переводчик Google и YouTube, а шаблоны и темы оформления несовместимы. Проект утверждает, что можно использовать старый файл settings.yml без изменений, однако перед запуском из него необходимо удалить записи, относящиеся к удаленным функциям. Ваши правила limiter.toml также не переносятся, так как в RustXNG используется собственный ограничитель запросов.

Почему нет ответа на порту 29483?

Проверьте rustxng --version. В версии v0.27.0 порт по умолчанию был изменен на 29483, при этом в README указано, что в опубликованных бинарных файлах v0.26.0 по-прежнему используется порт 8888. Запустите программу с параметром --bind 127.0.0.1 --port 29483, чтобы обе версии использовали один и тот же порт.

Почему функция read_page не работает на моем VPS, хотя поиск функционирует?

Функция read_page принудительно завершается с ошибкой, если в настройках или переменных окружения задан исходящий прокси-сервер. Для чтения страниц требуется прямое соединение, чтобы RustXNG мог проверять DNS-ответы и редиректы на соответствие публичным адресам. Отключите прокси для процесса MCP или используйте только результаты поиска.

Обеспечивает ли самостоятельный хостинг RustXNG приватность моих поисковых запросов?

Не от поисковых провайдеров. В README указано, что поисковые запросы отправляются выбранным внешним провайдерам, даже если RustXNG запущен в вашей локальной сети. Самостоятельный хостинг скрывает ваши запросы от стороннего оператора метапоиска. Он не скрывает их от поисковых движков, которые на них отвечают, при этом некоторые из этих движков ограничивают автоматизированное использование.

Стоит ли позволять моему AI-агенту устанавливать RustXNG согласно инструкциям из README?

Нет. В README содержится блок инструкций, предназначенный для AI-агентов. Установите бинарный файл релиза самостоятельно и проверьте его контрольную сумму SHA-256 с помощью sha256sum --check. Запустите его на loopback-интерфейсе под управлением systemd, а затем предоставьте агенту адрес конечной точки. Агент, который следует инструкциям из репозитория, с такой же легкостью выполнит и вредоносные команды.

Была ли эта статья полезной?

#searxng#rustxng#self-hosted-search#ai-agents#mcp