11 min di lettura 22 luglio 2026

Come configurare SearXNG in Odysseus AI e correggere la ricerca web

Guida pratica al servizio incluso in Docker, alle istanze esterne, al test del provider e ai problemi di Web Search o Deep Research.

Odysseus AI Wiki

Guide indipendenti sull’IA locale create dai fan

Configurazione SearXNG nell’interfaccia ufficiale di Odysseus AI — Interfaccia del progetto ufficiale Odysseus. SearXNG fornisce la ricerca self-hosted per Web Search e Deep Research.

Risposta rapida: Con Docker Compose, il container Odysseus deve usare http://searxng:8080. Avvia l’intero stack, apri Settings → Search, seleziona SearXNG ed esegui Test. Un’installazione nativa usa normalmente http://localhost:8080.

Configurare SearXNG in Odysseus AI richiede due verifiche separate: il servizio SearXNG deve essere sano e il processo Odysseus deve usare un URL raggiungibile dalla propria rete. Dentro Docker, localhost non indica l’host. Anche avviare solo parte dello stack o sostituire l’immagine fissata con :latest può interrompere la ricerca. Questa guida segue il branch dev ufficiale controllato il 22 luglio 2026. Poiché il repository non pubblicava Releases o tag, non viene inventato un numero di versione stabile.

Come configurare SearXNG in Odysseus AI

SearXNG è il provider self-hosted predefinito nell’interfaccia attuale. Web Search e Deep Research inviano le query al servizio; il modello riceve poi le fonti e il testo estratto. Il modello da solo non sostituisce il motore di ricerca.

Sull’host, localhost:8080 punta alla porta pubblicata. Nel container Odysseus, localhost punta al container stesso; nella rete Compose l’indirizzo corretto è quindi http://searxng:8080.

SearXNG è un metamotore indipendente al quale Odysseus si collega come provider.

Esecuzione di Odysseus	URL SearXNG	Quando usarlo
Docker Compose ufficiale	http://searxng:8080	I servizi condividono la rete Compose
Odysseus nativo sull’host	http://localhost:8080	SearXNG pubblica la porta 8080 sullo stesso computer
Server separato	https://search.example.com	Odysseus può risolvere e raggiungere l’endpoint protetto

Usare il servizio SearXNG incluso in Docker

Il Compose ufficiale avvia Odysseus, SearXNG, ChromaDB e ntfy. Pubblica SearXNG su 127.0.0.1:8080 e passa l’indirizzo interno a Odysseus. Avvia l’intero stack dalla radice del repository.

Alla data del controllo, il file ufficiale fissava SearXNG 2026.5.31-7159b8aed. Non sostituirlo automaticamente con :latest: i commenti del progetto descrivono un’immagine successiva che non superava l’health check.

Non usare localhost nel container

Nel Compose standard il container Odysseus deve usare http://searxng:8080. http://localhost:8080 è destinato all’host o a un’installazione nativa.

Creare il file di ambiente
Copia .env.example in .env. Lascia SEARXNG_SECRET vuoto se non serve un segreto fisso.
Avviare tutto lo stack
Esegui docker compose up -d --build nella directory Odysseus.
Attendere gli health check
Usa docker compose ps e verifica i servizi odysseus e searxng.
Leggere i log prima di ricostruire
docker compose logs searxng --tail=100 mostra spesso errori di permessi, volumi, porte o immagini.

Avviare Odysseus e i servizi

docker compose up -d --build

Verificare lo stato

docker compose ps

Leggere i log recenti

docker compose logs searxng --tail=100

Collegare un’istanza SearXNG esterna

Se SearXNG è fuori dalla rete Compose, imposta SEARXNG_INSTANCE in .env sull’URL base finale raggiungibile dal processo Odysseus e riavvia l’applicazione.

Verifica DNS, TLS, firewall, proxy e autenticazione dallo stesso contesto di rete. Un URL aperto nel browser desktop può non funzionare nel container. Le istanze pubbliche possono limitare le richieste o modificare i formati.

Esempio nativo sullo stesso host

SEARXNG_INSTANCE=http://localhost:8080

Esempio su server separato

SEARXNG_INSTANCE=https://search.example.com

Ricreare l’app Docker

docker compose up -d --force-recreate odysseus

Selezionare SearXNG e verificare la ricerca

Apri Settings, vai in Search, scegli SearXNG e fai clic su Test. Deep Research può usare lo stesso provider della ricerca web oppure selezionare SearXNG esplicitamente.

Dopo un test riuscito, esegui una query breve con la ricerca web attiva e controlla la presenza di fonti aggiornate. Inizia Deep Research con un argomento ristretto prima di aumentare token o concorrenza.

Interfaccia ufficiale Odysseus AI per testare SearXNG — Verifica prima il provider in Settings → Search, poi valuta la qualità del modello.

Il test del provider riesce.
La chat restituisce link a fonti aggiornate.
Deep Research recupera ed estrae almeno una pagina.
La porta SearXNG resta privata, salvo esposizione intenzionale e protetta.

Risolvere gli errori SearXNG in Odysseus AI

Controlla nell’ordine lo stato dei container, la raggiungibilità di rete, il test del provider e infine la qualità dei risultati.

Sintomo	Causa probabile	Controllo successivo
Connection refused	Hostname errato, servizio fermo o conflitto di porta	Controllare docker compose ps e usare searxng:8080 in Compose
Odysseus attende o è unhealthy	Health check SearXNG fallito	Leggere i log e mantenere l’immagine fissata ufficialmente
Il browser funziona ma Test fallisce	L’URL host non è raggiungibile dal container	Testare DNS/TLS nel container e sostituire localhost
Risultati vuoti o bloccati	Motori, limiti, SafeSearch o formato	Provare direttamente SearXNG e controllare settings.yml
Deep Research va in timeout	Ricerca, DNS o estrazione lenti	Far passare Test e ridurre ambito e concorrenza
Impostazioni perse al riavvio	Container non ricreato o volume mancante	Controllare .env, override e volumi

Aggiornamento e sicurezza

Il repository canonico odysseus-dev/odysseus è stato verificato il 22 luglio 2026. Senza Releases o tag, questa pagina non dichiara una versione stabile e segue i file ufficiali setup e Compose del branch dev.

Mantieni privati SearXNG, server dei modelli, ChromaDB e porte tecniche. Su un host separato usa TLS valido, autenticazione o una rete privata affidabile e regole firewall esplicite.

Controllo di freschezza

Fonti ufficiali verificate il 22 luglio 2026: repository canonico e file setup/Compose. Nessun tag stabile; immagine SearXNG conforme al pin ufficiale.

FAQ su Odysseus AI e SearXNG

Il Docker Compose ufficiale include un servizio SearXNG. Un’installazione nativa richiede un’istanza raggiungibile o un altro provider supportato.

Nel container, localhost indica il container stesso. Usa http://searxng:8080 per il servizio Compose.

Apri Settings → Search, seleziona SearXNG e fai clic su Test, poi esegui una piccola ricerca nella chat.

Non automaticamente. Il Compose ufficiale fissa un’immagine testata; controlla sempre il file ufficiale corrente prima di cambiare tag.

Può funzionare, ma può imporre limiti, disattivare formati o sparire. Un’istanza controllata è più affidabile.

Riferimenti ufficiali

Repository GitHub canonico di Odysseus - Codice, README e stato attuale
Guida ufficiale di setup - Ambiente, rete, porte e sicurezza
Docker Compose di Odysseus - Servizio SearXNG, health check e immagine fissata
Documentazione SearXNG - Installazione e configurazione upstream

Guide correlate

Configurare Odysseus AI con Docker - Avvia l’intero stack e controlla la rete dei container.
Come usare Odysseus AI - Passa dall’installazione a un flusso di lavoro sicuro.
Configurare Ollama con Odysseus AI - Collega il modello locale separatamente dalla ricerca web.

Ultimo aggiornamento: 22 luglio 2026

Torna alla homepage