Conheça o caminho da requisição
A sua instância envia consultas aos motores configurados e devolve resultados ao utilizador. As fontes ascendentes podem restringir ou limitar a taxa de pedidos. A auto-hospedagem não garante que todos os motores de busca aceitem o tráfego indefinidamente.
Mantenha a interface controlada
Use HTTPS e decida se a instância é privada, autenticada ou pública. Um endpoint de pesquisa público precisa de controlos contra abusos e de planeamento de capacidade. Proteja as definições e o acesso administrativo separadamente.
Minimizar a retenção de consultas
As consultas de pesquisa podem ser sensíveis. Reveja os registos do reverse proxy, da aplicação e do sistema e evite guardar strings de consulta sem uma necessidade definida. Explique os pedidos externos de resultados e imagens que podem contactar terceiros.
Manter e observar
Acompanhe as versões suportadas, os erros de resposta e as alterações do upstream. Restrinja os pedidos dispendiosos e mantenha um fallback claro para motores indisponíveis. Faça backup da configuração sem expor tokens secretos.
Torne visíveis os limites do contêiner e do proxy
Uma implantação de contêiner com suporte ainda precisa de configuração persistente, segredos privados e exposição de rede intencional. Coloque o aplicativo atrás de um proxy TLS adequado e revise os limites de taxa antes de abri-lo ao público. Consulte as instruções oficiais de implantação atuais em vez de reutilizar indefinidamente um arquivo compose antigo.
Documentação oficial: Instalação do contentor SearXNG
Separar a pesquisa de uma camada de IA
Se adicionar uma ferramenta como o Perplexica ou outra interface assistida por modelo, a consulta e o texto obtido também podem ser enviados a um fornecedor de modelo. Reveja esse novo caminho de dados e o seu custo, autenticação e retenção. Uma instância privada de metapesquisa não torna automaticamente privado o serviço de IA adicionado.
Escolha quem pode utilizar o endpoint de pesquisa
Uma instância privada do SearXNG pode utilizar um túnel ou uma fronteira de acesso autenticada. Uma instância pública necessita de um plano de capacidade e de abuso diferente. Os seus motores de busca a montante continuam a receber pedidos a partir do seu caminho de alojamento e podem devolver limites ou CAPTCHAs; um novo IP não é uma forma garantida de contornar. Utilize as instruções de contentor suportadas, persista as definições e gere um segredo privado da instância. Mantenha a aplicação atrás do proxy TLS pretendido.
- Escolha um pequeno conjunto inicial de motores que tem permissão para consultar.
- Mantenha a configuração/segredos fora do caminho público de ficheiros.
- Verifique se a obtenção opcional de imagens ou ícones externos altera o limite de privacidade.
Documentação oficial: Instalação do contentor SearXNG
Faça o limitador ver o cliente real
A documentação atual do limitador do SearXNG utiliza o Valkey para o estado dinâmico. Configure-o em privado e ative o limitador quando isso fizer parte do design da instância. A confiança no proxy é crítica: se todos os visitantes parecerem ser o proxy, um visitante pode afetar o limite de todos; se forem confiados cabeçalhos encaminhados arbitrários, um visitante pode deturpar um endereço. Defina os intervalos de proxy confiáveis para a implantação real e depois teste o comportamento resultante antes de publicar o endpoint.
Documentação oficial: Limitador e proxies de confiança do SearXNG
Teste o uso do navegador e uma falha do mecanismo
Execute uma pesquisa comum, uma consulta com texto não ASCII, uma pesquisa num motor configurado e num motor intencionalmente indisponível. Verifique se uma falha a montante não torna todo o serviço inutilizável. Adicione a instância testada como fornecedor de pesquisa do navegador através das definições suportadas desse navegador. Para uma camada de IA como o Perplexica, reveja separadamente a autenticação, a partilha de dados com o fornecedor do modelo, os limites de gastos e a atribuição de fontes: o frontend de metapesquisa não controla esses serviços adicionais.
- Verifique os links de resultado e os redirecionamentos a partir de um perfil de navegador novo.
- Verifique se os termos de pesquisa aparecem nos registos de acesso do proxy ou nas análises.
- Teste o limite de acesso privado a partir de uma rede não autorizada.
Corrija falhas a montante sem contornar restrições
Quando apenas um motor falha, inspecione o seu erro e a compatibilidade atual do adaptador antes de alterar toda a implantação. Uma resposta de CAPTCHA ou de limite de taxa é um sinal de política a montante, não permissão para automatizar contornando-a. Respostas HTTP429 repetidas também podem vir da sua própria configuração de limitador/proxy. Mantenha um motor de fallback e um ensaio de atualização, preserve o pequeno backup de configuração e evite registos de consultas permanentes apenas porque a resolução de problemas uma vez os exigiu.