Como Usar o SearXNG: Da Primeira Pesquisa ao Domínio da Auto-Hospedagem
Se você sempre quis resultados semelhantes aos do Google, mas sem rastreamento, o SearXNG é seu mecanismo de metapesquisa com prioridade na privacidade. Ele agrega resultados de dezenas de fontes — sem criar um perfil seu — e oferece controle total sobre filtros, mecanismos e até mesmo hospedagem. Neste guia, vamos percorrer três caminhos: usar uma instância pública, personalizar sua experiência de pesquisa e implantar seu próprio SearXNG privado para máximo controle.
Para manter isso prático, adotaremos uma abordagem prática e orientada para soluções, com etapas práticas, configurações que você pode copiar e armadilhas comuns a serem evitadas.
O Que é SearXNG e Por Que Usá-lo?
O SearXNG é um mecanismo de metapesquisa de código aberto. Em vez de rastrear a web em si, ele consulta outros mecanismos de pesquisa e apresenta os resultados em uma interface unificada. O diferencial: ele elimina o rastreamento, remove anúncios (na maioria das instâncias) e oferece controle preciso sobre quais mecanismos incluir, quais categorias pesquisar (web, imagens, vídeos, arquivos, TI, notícias, ciência) e como os resultados são apresentados.
- Sem rastreamento ou criação de perfil por padrão
- Mecanismos e categorias configuráveis
- Auto-hospedável para controle total
- Compatível com API para desenvolvedores e automações.
Início Rápido: Usando uma Instância Pública do SearXNG
Você pode começar com uma instância pública (um servidor SearXNG executado por voluntários). Fluxo típico:
- Abra uma instância pública confiável (pesquise “lista de instâncias SearXNG” ou threads da comunidade para encontrar servidores ativos e respeitáveis). Avalie o tempo de atividade, os limites de taxa e as declarações de privacidade.
- Digite sua consulta e escolha as categorias (por exemplo, Web, Imagens, Notícias) por meio das guias superiores.
- Use as Preferências (ícone de engrenagem) para definir:
- Tema da interface do usuário e rolagem infinita
- Use “bangs” e operadores:
!g sua consulta força o mecanismo do Google (se habilitado nessa instância)
!ddg, !bing, !yt, !wp etc., dependendo da configuração da instância
- Operadores padrão como aspas,
site:, filetype:pdf, inurl:, intitle: funcionam em muitos mecanismos
- Marque sua instância favorita e exporte/importe as Preferências como um blob JSON, se compatível com a interface do usuário.
Dica profissional: as instâncias públicas podem limitar a taxa de usuários anônimos para se proteger contra abusos. Se você vir captchas ou lentidão, tente outra instância ou auto-hospede.
Movimentos de Usuário Avançado na Interface
- Mude os mecanismos rapidamente: em Preferências → Mecanismos, alterne fontes específicas por categoria.
- Ajuste os resultados: oculte duplicatas, altere o período de tempo (por exemplo, último ano), classifique por relevância ou data.
- Alternâncias de privacidade: desative qualquer mecanismo que você não deseja que seja consultado. Alguns mecanismos exigem chaves de API; se ausentes, eles simplesmente não serão usados.
- Atalhos de teclado: muitos temas do SearXNG suportam
/ para focar na caixa de pesquisa e teclas de seta para navegar pelos resultados.
Como Auto-Hospedar o SearXNG (Modo Docker)
A auto-hospedagem oferece confiabilidade, velocidade e controle sobre quais mecanismos usar. O caminho do Docker é o mais simples.
Requisitos
- Um VPS Linux ou um servidor doméstico (2 vCPU/2 GB de RAM é confortável para uso leve)
- Docker e Docker Compose instalados
- Um domínio/subdomínio e proxy reverso opcional (Caddy/Traefik/Nginx) para HTTPS
Passos
- Clone o repositório de implantação do SearXNG (ou use um arquivo Compose mínimo):
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
- Gere uma
SEARXNG_SECRET_KEY forte (por exemplo, openssl rand -hex 32).
- Configure o proxy reverso com HTTPS (exemplo do Caddy):
search.example.com {
reverse_proxy 127.0.0.1:8080
}
O Caddy provisionará automaticamente o TLS via Let’s Encrypt.
- Visite ` e confirme se ele carrega.
Configuração Principal: settings.yml
Após a primeira execução, você terá a configuração sob seu volume montado (por exemplo, ./searxng/settings.yml). Seções principais:
general: nome, modo de depuração, contagem de resultados
server: chave secreta, endereço de ligação, limites de taxa
engines: ativar/desativar mecanismos, categorias, tempos limite
ui: tema, rolagem infinita, preenchimento automático
search: padrões de pesquisa segura, idioma, localidade
Snippet de exemplo:
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 "
A resposta inclui resultados orgânicos, mecanismos usados e tempos. Ótimo para criar automações de pesquisa, painéis locais e interfaces de usuário personalizadas.
Ajustando Mecanismos e Categorias
- Prefira fontes rápidas e amigáveis à privacidade (por exemplo, Wikipedia, Stack Exchange, MDN, DuckDuckGo, Brave, se permitido, APIs oficiais para YouTube/Reddit/Mastodon).
- Desative os mecanismos com captchas frequentes ou alta latência em sua rede.
- Use padrões por categoria; por exemplo, ative GitHub, Stack Overflow e PyPI em “TI”, ative arXiv/Crossref em “Ciência” e defina
time_range para recente em “Notícias”.
Lista de Verificação de Solução de Problemas
- Vendo captchas ou resultados vazios? Reduza ou gire os mecanismos que causam bloqueios; aumente ligeiramente os tempos limite; ative o cache.
- Solicitações de API falhando? Verifique os cabeçalhos do proxy reverso e o CORS; confirme
format=json.
- IU lenta? Diminua o número de resultados por página; desative os mecanismos pesados; ative o cache Redis.
- Loop de reinicialização do Docker? Valide a sintaxe de
settings.yml e suas variáveis de ambiente.
Práticas Recomendadas para Equipes e Usuários Avançados
- Exporte e controle a versão do seu
settings.yml (sem segredos) para rastrear as alterações.
- Use gerenciadores de segredos ou arquivos
.env para chaves de API.
- Agende atualizações semanais do contêiner para se manter atualizado com as alterações do mecanismo.
- Monitore os logs para erros de mecanismo ou hits de limite de taxa.
- Se você incorporar o SearXNG em aplicativos, recue nas novas tentativas e randomize os atrasos para evitar banimentos.
Opcional: Conecte o SearXNG a Outras Ferramentas
- Use a API JSON em seus notebooks de pesquisa ou fluxos de trabalho de bate-papo.
- Encaminhe a pesquisa na web baseada em aplicativos por meio de sua instância privada para manter a privacidade.
- Algumas IUs de IA/web podem se conectar ao SearXNG para navegar por meio de seu próprio endpoint (configure o URL base e os parâmetros da API de acordo).
Vale a pena notar: Se você está criando fluxos de trabalho de pesquisa ou resumindo resultados em escala, uma ferramenta como Sider.AI pode otimizar a etapa de leitura e resumo em várias guias ou consultas. Você pode direcionar sua navegação para um endpoint SearXNG privado e, em seguida, usar o Sider.AI para capturar insights, elaborar briefs ou compilar citações automaticamente, o que economiza tempo quando você está executando muitas pesquisas em sequência. Segurança e Ética
- Respeite os termos dos mecanismos que você ativa.
- Não exponha sua instância ao abuso público; limite a taxa e, se necessário, restrinja o acesso.
- Informe os membros da equipe sobre as expectativas de privacidade; os logs podem ser configurados para evitar o armazenamento de IPs ou consultas.
Sua Primeira Configuração de 15 Minutos: Uma Mini Lista de Verificação
- Inicie o Docker e crie um arquivo Compose
- Defina
SEARXNG_SECRET_KEY
- Inicie o contêiner e confirme se
:8080 funciona
- Coloque-o atrás de HTTPS com um proxy
- Edite
settings.yml para ativar os mecanismos em que você confia
- Defina categorias padrão e SafeSearch
- Teste a API com uma solicitação
curl
- Marque sua instância e compartilhe-a com sua equipe
Principais Conclusões
- O SearXNG oferece privacidade, controle e flexibilidade sem escrever um rastreador.
- Comece em uma instância pública e, em seguida, auto-hospede para confiabilidade e personalização.
- Ajuste os mecanismos e categorias para velocidade e relevância.
- A API JSON torna o SearXNG ideal para pesquisa e automação.
- Proteja sua implantação com HTTPS, limites de taxa e registro mínimo.
Referências e Leitura Adicional
- Visão geral oficial da API de pesquisa para parâmetros e formatos.
- Passo a passo, instruções de auto-hospedagem e tutoriais da comunidade podem ser úteis para configurações de Docker e Windows.
- A integração do SearXNG em fluxos de trabalho e ferramentas de aplicativos geralmente segue o mesmo padrão de API usado acima.
FAQ
Q1: O que é SearXNG e como funciona?
SearXNG é um mecanismo de metapesquisa com foco na privacidade que consulta várias fontes e agrega os resultados, sem rastrear os usuários. Você pode usar uma instância pública ou auto-hospedar para controle total sobre os mecanismos, filtros e configurações de privacidade.
Q2: Como faço para auto-hospedar o SearXNG com o Docker?
Crie um serviço Docker Compose usando a imagem oficial, defina uma chave secreta forte e exponha-o atrás de um proxy reverso com HTTPS. Edite settings.yml para ativar os mecanismos, configurar as categorias e ajustar as opções de privacidade.
Q3: Posso usar o SearXNG para pesquisas programáticas via API?
Sim. Chame /search com parâmetros como q, categories e format=json para receber resultados JSON para automações e aplicativos. Isso é ideal para pipelines de pesquisa e ferramentas internas.
Q4: Como escolho uma instância pública segura do SearXNG?
Procure instâncias ativas e respeitáveis com declarações de privacidade claras, bom tempo de atividade e captchas mínimos. Você também pode mudar de instância ou auto-hospedar se encontrar limites de taxa ou problemas de confiabilidade.
Q5: Quais operadores de pesquisa funcionam no SearXNG?
Operadores comuns como aspas, site:, filetype:, inurl: e intitle: geralmente funcionam e são passados para os mecanismos subjacentes. Você também pode usar atalhos bang (por exemplo, !g, !ddg, !yt) se a instância os suportar.
