11 min de leitura 22 de julho de 2026

Como configurar SearXNG no Odysseus AI e corrigir a busca web

Guia prático para o serviço incluído no Docker, instâncias externas, teste do provedor e falhas no Web Search ou Deep Research.

Odysseus AI Wiki

Guias independentes de IA local feitos por fãs

Configuração do SearXNG na interface oficial do Odysseus AI — Interface do projeto oficial Odysseus. O SearXNG fornece a busca auto-hospedada usada pelo Web Search e Deep Research.

Resposta rápida: No Docker Compose padrão, o contêiner Odysseus deve usar http://searxng:8080. Inicie toda a stack, abra Settings → Search, selecione SearXNG e execute Test. Uma instalação nativa normalmente usa http://localhost:8080.

Configurar SearXNG no Odysseus AI envolve duas camadas: o serviço SearXNG precisa estar saudável e o processo Odysseus deve usar uma URL acessível a partir da própria rede. Dentro do Docker, localhost não aponta para o host. Iniciar apenas parte da stack ou trocar a imagem fixada por :latest também pode interromper a busca. Este guia segue a branch dev oficial verificada em 22 de julho de 2026. Como o repositório não publicava Releases nem tags, não inventamos uma versão estável.

Como configurar SearXNG no Odysseus AI

O SearXNG é o provedor auto-hospedado padrão na interface atual. Web Search e Deep Research enviam consultas ao serviço, e o modelo recebe as fontes e o texto extraído. O modelo sozinho não substitui o mecanismo de busca.

No host, localhost:8080 aponta para a porta publicada. No contêiner Odysseus, localhost aponta para o próprio contêiner; por isso a URL correta na rede Compose é http://searxng:8080.

O SearXNG é um metabuscador independente ao qual o Odysseus se conecta como provedor.

Execução do Odysseus	URL do SearXNG	Quando usar
Docker Compose oficial	http://searxng:8080	Os serviços compartilham a rede Compose
Odysseus nativo no host	http://localhost:8080	SearXNG publica a porta 8080 no mesmo computador
Servidor separado	https://search.example.com	Odysseus resolve e alcança o endpoint protegido

Usar o serviço SearXNG incluído no Docker

O Compose oficial inicia Odysseus, SearXNG, ChromaDB e ntfy. Ele publica o SearXNG em 127.0.0.1:8080 e entrega a URL interna ao Odysseus. Inicie a stack completa na raiz do repositório.

Na data da verificação, o arquivo oficial fixava SearXNG 2026.5.31-7159b8aed. Não substitua automaticamente por :latest; os comentários do projeto registram uma imagem mais nova que falhou no health check.

Não use localhost dentro do contêiner

No Compose, o contêiner Odysseus deve usar http://searxng:8080. http://localhost:8080 é para o host ou uma instalação nativa.

Criar o arquivo de ambiente
Copie .env.example para .env. Deixe SEARXNG_SECRET vazio, a menos que precise de um segredo fixo.
Iniciar toda a stack
Execute docker compose up -d --build no diretório do Odysseus.
Aguardar os health checks
Use docker compose ps e confirme os serviços odysseus e searxng.
Ler logs antes de reconstruir
docker compose logs searxng --tail=100 costuma revelar problemas de permissão, volume, porta ou imagem.

Iniciar Odysseus e serviços

docker compose up -d --build

Verificar o estado

docker compose ps

Ler logs recentes

docker compose logs searxng --tail=100

Conectar uma instância SearXNG externa

Se o SearXNG estiver fora da rede Compose, defina SEARXNG_INSTANCE no .env com a URL final acessível pelo processo Odysseus e reinicie a aplicação.

Teste DNS, TLS, firewall, proxy e autenticação no mesmo contexto de rede. Uma URL que abre no navegador pode falhar no contêiner. Instâncias públicas podem limitar requisições ou alterar formatos.

Exemplo nativo no mesmo host

SEARXNG_INSTANCE=http://localhost:8080

Exemplo em servidor separado

SEARXNG_INSTANCE=https://search.example.com

Recriar a aplicação Docker

docker compose up -d --force-recreate odysseus

Selecionar SearXNG e validar a busca

Abra Settings, acesse Search, selecione SearXNG e clique em Test. O Deep Research pode reutilizar o mesmo provedor ou escolher SearXNG explicitamente. Esse teste verifica a configuração real usada pelo Odysseus.

Depois, faça uma consulta curta no chat com busca web ativada e confirme fontes atuais. Comece o Deep Research com um tema pequeno antes de aumentar tokens ou concorrência.

Interface oficial do Odysseus AI para testar o SearXNG — Valide primeiro o provedor em Settings → Search antes de investigar a qualidade do modelo.

O teste do provedor é concluído com sucesso.
O chat retorna links de fontes atuais.
O Deep Research consegue buscar e extrair pelo menos uma página.
A porta do SearXNG permanece privada, salvo exposição intencional e protegida.

Corrigir erros do SearXNG no Odysseus AI

Verifique, nesta ordem, a saúde dos contêineres, a conectividade, o teste do provedor e só depois a qualidade dos resultados.

Sintoma	Causa provável	Próxima verificação
Connection refused	Hostname errado, serviço parado ou conflito de porta	Revisar docker compose ps e usar searxng:8080 no Compose
Odysseus aguardando ou unhealthy	Health check do SearXNG falhou	Ler logs e manter a imagem fixada oficialmente
Navegador abre, mas Test falha	URL do host não é acessível pelo contêiner	Testar DNS/TLS no Docker e substituir localhost
Resultados vazios ou bloqueados	Motores, limites, SafeSearch ou formato	Consultar diretamente o SearXNG e revisar settings.yml
Deep Research expira	Busca, DNS ou extração lenta	Fazer Test passar e reduzir escopo e concorrência
Configuração desaparece	Contêiner não recriado ou volume ausente	Revisar .env, overrides e volumes

Versão verificada e segurança

O repositório canônico odysseus-dev/odysseus foi verificado em 22 de julho de 2026. Sem Releases ou tags, esta página não declara uma versão estável e segue os arquivos oficiais de setup e Compose da branch dev.

Mantenha SearXNG, servidores de modelos, ChromaDB e portas técnicas privados. Em um host separado, use TLS válido, autenticação ou rede privada e regras explícitas de firewall.

Verificação de atualização

Fontes oficiais verificadas em 22 de julho de 2026: repositório canônico e arquivos setup/Compose. Sem tag estável; imagem SearXNG conforme o pin oficial.

FAQ sobre Odysseus AI e SearXNG

O Docker Compose oficial inclui um serviço SearXNG. Uma instalação nativa precisa de uma instância acessível ou outro provedor compatível.

Dentro do contêiner, localhost aponta para o próprio contêiner. Use http://searxng:8080 para o serviço Compose.

Abra Settings → Search, selecione SearXNG e clique em Test. Depois, execute uma busca pequena no chat.

Não automaticamente. O Compose oficial fixa uma imagem testada; confira o arquivo oficial atual antes de alterar a tag.

Pode funcionar, mas há risco de limites, formatos desativados ou indisponibilidade. Uma instância controlada é mais confiável.

Referências oficiais

Repositório canônico do Odysseus - Código, README e estado atual
Guia oficial de setup - Ambiente, rede, portas e segurança
Docker Compose do Odysseus - Serviço SearXNG, health check e imagem fixada
Documentação do SearXNG - Instalação e configuração upstream

Guias relacionados

Configurar Odysseus AI com Docker - Inicie toda a stack e verifique a rede dos contêineres.
Como usar o Odysseus AI - Passe da instalação para um fluxo diário seguro.
Configurar Ollama no Odysseus AI - Conecte o modelo local separadamente da busca web.

Última atualização: 22 de julho de 2026

Voltar ao início