What is SearXNG and how does it work?

SearXNG is a privacy-focused metasearch engine that queries multiple sources and aggregates the results, without tracking users. You can use a public instance or self-host for full control over engines, filters, and privacy settings.

How do I self-host SearXNG with Docker?

Create a Docker Compose service using the official image, set a strong secret key, and expose it behind a reverse proxy with HTTPS. Edit `settings.yml` to enable engines, configure categories, and adjust privacy options.

Can I use SearXNG for programmatic searches via API?

Yes. Call `/search` with parameters like `q`, `categories`, and `format=json` to receive JSON results for automations and apps. This is ideal for research pipelines and internal tools.

How do I choose a safe public SearXNG instance?

Look for active, reputable instances with clear privacy statements, good uptime, and minimal captchas. You can also switch instances or self-host if you encounter rate limits or reliability issues.

Which search operators work in SearXNG?

Common operators like quotes, `site:`, `filetype:`, `inurl:`, and `intitle:` generally work and are passed to underlying engines. You can also use bang shortcuts (e.g., `!g`, `!ddg`, `!yt`) if the instance supports them.

Как использовать SearXNG: от первого поиска до мастерства самостоятельного хостинга

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

Чтобы руководство было практически применимым, мы будем использовать практический и ориентированный на решения подход с практическими шагами, настройками, которые вы можете скопировать, и распространенными ошибками, которых следует избегать.

Что такое SearXNG и зачем его использовать?

SearXNG — это метапоисковая система с открытым исходным кодом. Вместо того, чтобы самостоятельно сканировать веб-страницы, она запрашивает другие поисковые системы и представляет результаты в едином интерфейсе. Особенность: он отключает отслеживание, удаляет рекламу (в большинстве случаев) и дает вам точный контроль над тем, какие поисковые системы включать, какие категории искать (веб, изображения, видео, файлы, IT, новости, наука) и как представлять результаты.

Отсутствие отслеживания или профилирования по умолчанию

Настраиваемые поисковые системы и категории

Возможность самостоятельного хостинга для полного контроля

API-интерфейс для разработчиков и автоматизации.

Быстрый старт: использование общедоступного экземпляра SearXNG

Вы можете начать с общедоступного экземпляра (сервер SearXNG, управляемый волонтерами). Типичный процесс:

Откройте надежный общедоступный экземпляр (найдите в поиске «список экземпляров SearXNG» или темы сообщества, чтобы найти активные и авторитетные серверы). Оцените время безотказной работы, ограничения скорости и заявления о конфиденциальности.

Введите свой запрос и выберите категории (например, Веб, Изображения, Новости) через верхние вкладки.

Используйте «Настройки» (значок шестеренки) для установки:

Язык интерфейса

Уровень SafeSearch

Категории по умолчанию

Тема пользовательского интерфейса и бесконечная прокрутка

Используйте «восклицательные знаки» и операторы:

!g ваш запрос принудительно использует поисковую систему Google (если она включена в этом экземпляре)

!ddg, !bing, !yt, !wp и т. д., в зависимости от конфигурации экземпляра

Стандартные операторы, такие как кавычки, site:, filetype:pdf, inurl:, intitle:, работают во многих поисковых системах

Добавьте в закладки свой любимый экземпляр и экспортируйте/импортируйте настройки в виде JSON-объекта, если это поддерживается пользовательским интерфейсом.

Совет профессионала: общедоступные экземпляры могут ограничивать скорость для анонимных пользователей, чтобы защитить себя от злоупотреблений. Если вы видите капчи или замедления, попробуйте другой экземпляр или запустите свой собственный.

Действия продвинутого пользователя в интерфейсе

Переключайте поисковые системы на лету: в разделе «Настройки» → «Поисковые системы» переключайте конкретные источники для каждой категории.

Настройте результаты: скрыть дубликаты, изменить временной диапазон (например, за последний год), отсортировать по релевантности или дате.

Переключатели конфиденциальности: отключите любую поисковую систему, которую вы не хотите запрашивать. Для некоторых поисковых систем требуются ключи API; если они отсутствуют, они просто не будут использоваться.

Сочетания клавиш: многие темы SearXNG поддерживают / для фокусировки на поле поиска и клавиши со стрелками для навигации по результатам.

Как самостоятельно разместить SearXNG (способ Docker)

Самостоятельный хостинг обеспечивает надежность, скорость и контроль над тем, какие поисковые системы использовать. Путь Docker — самый простой.

Требования

Linux VPS или домашний сервер (2 vCPU/2 ГБ ОЗУ достаточно для легкого использования)

Установлены Docker и Docker Compose

Домен/поддомен и дополнительный обратный прокси (Caddy/Traefik/Nginx) для HTTPS

Шаги

Клонируйте репозиторий развертывания SearXNG (или используйте минимальный файл Compose):

version: "3.8"
services:
searxng:
image: searxng/searxng:latest
container_name: searxng
environment:
- BASE_URL=
- SEARXNG_SECRET_KEY=change_me_to_a_long_random_value
volumes:
- ./searxng:/etc/searxng
ports:
- "8080:8080"
restart: unless-stopped

Сгенерируйте надежный SEARXNG_SECRET_KEY (например, openssl rand -hex 32).

Запустите службу:

docker compose up -d

Настройте обратный прокси с HTTPS (пример Caddy):

search.example.com {
reverse_proxy 127.0.0.1:8080
}

Caddy автоматически предоставит TLS через Let’s Encrypt.

Посетите ` и подтвердите, что он загружается.

Основная конфигурация: `settings.yml`

После первого запуска у вас будет конфигурация в смонтированном томе (например, ./searxng/settings.yml). Ключевые разделы:

general: имя, режим отладки, количество результатов

server: секретный ключ, адрес привязки, ограничения скорости

engines: включение/отключение поисковых систем, категории, тайм-ауты

ui: тема, бесконечная прокрутка, автозаполнение

search: настройки безопасного поиска по умолчанию, язык, локаль

Пример фрагмента:

general:
instance_name: "My Private SearXNG"
server:
secret_key: "<same as env or longer>"
image_proxy: true
rate_limit: "60/minute"
search:
safe_search: 1 # 0 off, 1 moderate, 2 strict
autocomplete: "duckduckgo"
ui:
default_theme: "simple"
infinite_scroll: true
engines:
- name: duckduckgo
engine: duckduckgo
categories: .
### Quick Example
- Endpoint: `/search`
- Methods: GET or POST
- Parameters: `q` (query), `categories`, `language`, `format=json`, `time_range`, `safesearch`
```bash
curl "

Ответ включает органические результаты, используемые поисковые системы и время. Отлично подходит для создания автоматизации исследований, локальных панелей управления и пользовательских интерфейсов.

Настройка поисковых систем и категорий

Предпочитайте быстрые и конфиденциальные источники (например, Wikipedia, Stack Exchange, MDN, DuckDuckGo, Brave, если разрешено, официальные API для YouTube/Reddit/Mastodon).

Отключите поисковые системы с частыми капчами или высокой задержкой в вашей сети.

Используйте настройки по умолчанию для каждой категории; например, включите GitHub, Stack Overflow и PyPI в разделе «IT», включите arXiv/Crossref в разделе «Наука» и установите time_range на «недавние» для «Новостей».

Контрольный список по устранению неполадок

Видите капчи или пустые результаты? Уменьшите или чередуйте поисковые системы, вызывающие блокировки; немного увеличьте тайм-ауты; включите кэширование.

Не удаются запросы API? Проверьте заголовки обратного прокси и CORS; подтвердите format=json.

Медленный пользовательский интерфейс? Уменьшите количество результатов на странице; отключите тяжелые поисковые системы; включите кэш Redis.

Цикл перезапуска Docker? Проверьте синтаксис settings.yml и переменные среды.

Дополнительно: подключите SearXNG к другим инструментам

Используйте JSON API в своих исследовательских блокнотах или рабочих процессах чата.

Направляйте веб-поиск на основе приложений через свой частный экземпляр для обеспечения конфиденциальности.

Некоторые AI/веб-интерфейсы могут подключаться к SearXNG для просмотра через вашу собственную конечную точку (соответственно настройте базовый URL-адрес и параметры API).

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

Безопасность и этика

Соблюдайте условия использования поисковых систем, которые вы включаете.

Не подвергайте свой экземпляр публичным злоупотреблениям; ограничьте скорость и, при необходимости, ограничьте доступ.

Проинформируйте членов команды об ожиданиях конфиденциальности; журналы можно настроить так, чтобы избежать хранения IP-адресов или запросов.

Первая 15-минутная настройка: мини-контрольный список

Запустите Docker и создайте файл Compose

Установите SEARXNG_SECRET_KEY

Запустите контейнер и подтвердите, что :8080 работает

Поместите его за HTTPS с помощью прокси

Отредактируйте settings.yml, чтобы включить поисковые системы, которым вы доверяете

Установите категории по умолчанию и SafeSearch

Проверьте API с помощью запроса curl

Добавьте в закладки свой экземпляр и поделитесь им со своей командой

Ключевые выводы

SearXNG дает вам конфиденциальность, контроль и гибкость без написания краулера.

Начните с общедоступного экземпляра, а затем самостоятельно разместите его для надежности и настройки.

Настройте поисковые системы и категории для скорости и релевантности.

JSON API делает SearXNG идеальным для исследований и автоматизации.

Укрепите свое развертывание с помощью HTTPS, ограничений скорости и минимального ведения журнала.

Ссылки и дополнительная литература

Официальный обзор Search API для параметров и форматов.

Пошаговые руководства по самостоятельному хостингу и учебные пособия сообщества могут быть полезны для установок Docker и Windows.

Интеграция SearXNG в рабочие процессы и инструменты приложений часто соответствует той же схеме API, которая использовалась выше.

FAQ

Q1: Что такое SearXNG и как он работает? SearXNG — это метапоисковая система, ориентированная на конфиденциальность, которая запрашивает несколько источников и агрегирует результаты, не отслеживая пользователей. Вы можете использовать общедоступный экземпляр или самостоятельно разместить его для полного контроля над поисковыми системами, фильтрами и настройками конфиденциальности.

Q2: Как самостоятельно разместить SearXNG с помощью Docker? Создайте службу Docker Compose, используя официальный образ, установите надежный секретный ключ и предоставьте его за обратным прокси с HTTPS. Отредактируйте settings.yml, чтобы включить поисковые системы, настроить категории и настроить параметры конфиденциальности.

Q3: Могу ли я использовать SearXNG для программного поиска через API? Да. Вызовите /search с параметрами, такими как q, categories и format=json, чтобы получить результаты JSON для автоматизации и приложений. Это идеально подходит для исследовательских конвейеров и внутренних инструментов.

Q4: Как выбрать безопасный общедоступный экземпляр SearXNG? Ищите активные, авторитетные экземпляры с четкими заявлениями о конфиденциальности, хорошим временем безотказной работы и минимальным количеством капч. Вы также можете переключать экземпляры или самостоятельно размещать их, если столкнетесь с ограничениями скорости или проблемами с надежностью.

Q5: Какие поисковые операторы работают в SearXNG? Обычно работают общие операторы, такие как кавычки, site:, filetype:, inurl: и intitle:, которые передаются базовым поисковым системам. Вы также можете использовать ярлыки с восклицательными знаками (например, !g, !ddg, !yt), если экземпляр их поддерживает.