11 min de lectura 22 de julio de 2026

Cómo configurar SearXNG en Odysseus AI y corregir la búsqueda web

Guía práctica para el servicio incluido en Docker, una instancia externa, la prueba del proveedor y los fallos que bloquean Web Search o Deep Research.

Odysseus AI Wiki

Guías independientes de IA local creadas por fans

Configuración de SearXNG en la interfaz oficial de Odysseus AI — Interfaz del proyecto oficial Odysseus. SearXNG aporta el buscador autohospedado para Web Search y Deep Research.

Respuesta rápida: En la instalación Docker estándar, Odysseus debe usar http://searxng:8080 dentro de la red de Compose. Inicia todos los servicios, abre Settings → Search, selecciona SearXNG y pulsa Test. Una instalación nativa suele usar http://localhost:8080.

Configurar SearXNG en Odysseus AI exige comprobar dos capas: el servicio SearXNG debe estar sano y el proceso de Odysseus debe usar una URL accesible desde su propia red. El Compose oficial automatiza gran parte del trabajo, pero usar localhost dentro del contenedor, iniciar solo una parte del stack o cambiar la imagen fijada puede romper la búsqueda. Esta guía sigue la rama dev oficial comprobada el 22 de julio de 2026; no afirma que exista una versión estable porque el repositorio no publicaba Releases ni tags.

Cómo configurar SearXNG en Odysseus AI

SearXNG es el proveedor autohospedado predeterminado en la interfaz actual. Web Search y Deep Research envían consultas al proveedor, y el modelo recibe las fuentes y el texto extraído. El modelo no sustituye al motor de búsqueda.

La URL depende del lugar donde se ejecuta Odysseus. En el host, localhost:8080 apunta al puerto publicado. Dentro del contenedor, localhost apunta al propio contenedor de Odysseus, por lo que debe usarse http://searxng:8080.

Logotipo oficial de SearXNG como proveedor de búsqueda de Odysseus AI — SearXNG es un metabuscador independiente al que Odysseus se conecta como proveedor.

Ejecución de Odysseus	URL de SearXNG	Cuándo usarla
Docker Compose oficial	http://searxng:8080	Ambos servicios comparten la red de Compose
Odysseus nativo en el host	http://localhost:8080	SearXNG publica el puerto 8080 en el mismo equipo
Servidor separado	https://search.example.com	Odysseus puede resolver y alcanzar el endpoint protegido

Usar el servicio SearXNG incluido en Docker

El Compose oficial inicia Odysseus, SearXNG, ChromaDB y ntfy. SearXNG se publica en 127.0.0.1:8080 y Odysseus recibe la URL interna. Ejecuta el stack completo desde la raíz del repositorio.

El archivo oficial fijaba la imagen SearXNG 2026.5.31-7159b8aed en la fecha de revisión. No la cambies automáticamente por :latest: los comentarios del proyecto explican que una imagen posterior falló en el health check.

No uses localhost dentro del contenedor

En Compose, el contenedor de Odysseus debe usar http://searxng:8080. http://localhost:8080 corresponde al host o a una instalación nativa.

Crear el archivo de entorno
Copia .env.example a .env. Deja SEARXNG_SECRET vacío salvo que necesites un secreto fijo; Docker puede generarlo en el primer arranque.
Iniciar todo el stack
Ejecuta docker compose up -d --build desde el directorio del repositorio.
Esperar los health checks
Usa docker compose ps y confirma que odysseus y searxng están en ejecución.
Leer los logs antes de reconstruir
docker compose logs searxng --tail=100 suele mostrar problemas de permisos, volumen, imagen o puerto.

Iniciar Odysseus y sus servicios

docker compose up -d --build

Comprobar el estado

docker compose ps

Ver logs recientes

docker compose logs searxng --tail=100

Conectar Odysseus AI a una instancia SearXNG externa

Si SearXNG está fuera de la red oficial, define SEARXNG_INSTANCE en .env con la URL base final y reinicia Odysseus. La URL debe ser accesible desde el proceso, no solo desde el navegador de escritorio.

Comprueba DNS, certificados TLS, firewall, proxy y autenticación desde el mismo contexto de red. Las instancias públicas pueden limitar peticiones, desactivar JSON o desaparecer; una instancia controlada es más predecible.

Ejemplo nativo en el mismo host

SEARXNG_INSTANCE=http://localhost:8080

Ejemplo de instancia separada

SEARXNG_INSTANCE=https://search.example.com

Recargar la aplicación Docker

docker compose up -d --force-recreate odysseus

Seleccionar SearXNG y verificar la búsqueda

Abre Settings, entra en Search, elige SearXNG y pulsa Test. Deep Research puede reutilizar el proveedor de búsqueda web o seleccionar SearXNG de forma explícita. Esta prueba valida la configuración real de Odysseus, no solo que el puerto esté abierto.

Después, ejecuta una consulta corta con búsqueda web activada y confirma que aparecen fuentes actuales. En Deep Research empieza con un tema pequeño antes de aumentar tokens o concurrencia.

Interfaz oficial de Odysseus AI para probar SearXNG — Comprueba primero el proveedor en Settings → Search antes de diagnosticar la calidad del modelo.

La prueba del proveedor termina correctamente.
El chat devuelve enlaces a fuentes y no solo memoria del modelo.
Deep Research puede obtener y extraer al menos una página.
El puerto de SearXNG permanece privado salvo que lo protejas y expongas de forma intencional.

Resolver errores de SearXNG en Odysseus AI

Diagnostica una capa cada vez: salud del contenedor, conectividad, prueba del proveedor y, por último, calidad de resultados.

Síntoma	Causa probable	Siguiente comprobación
Connection refused	Hostname incorrecto, contenedor parado o conflicto de puerto	Revisa docker compose ps y usa searxng:8080 dentro de Compose
Odysseus espera o queda unhealthy	Falló el health check de SearXNG	Lee los logs y conserva la imagen fijada oficialmente
El navegador abre SearXNG pero Test falla	La URL del host no es accesible desde Docker	Prueba DNS/TLS desde el contenedor y sustituye localhost
Resultados vacíos o bloqueados	Motores, límites, SafeSearch o formato	Haz una consulta directa y revisa settings.yml
Deep Research agota el tiempo	Búsqueda, DNS o extracción lentos	Haz pasar primero Test y reduce alcance o concurrencia
La configuración se pierde	No se recreó el contenedor o falta persistencia	Revisa .env, overrides y volúmenes

Notas de versión y seguridad

El 22 de julio de 2026 se comprobó el repositorio canónico odysseus-dev/odysseus. No había Releases ni tags, por lo que esta guía no inventa una versión estable y sigue los archivos oficiales de setup y Compose de la rama dev.

Mantén privados SearXNG, los servidores de modelos, ChromaDB y otros puertos internos. Si separas SearXNG, usa TLS válido, autenticación o una red privada y reglas explícitas de firewall.

Comprobación de frescura

Fuente verificada el 22 de julio de 2026: repositorio canónico y archivos oficiales de setup/Compose. Sin release estable; la imagen de SearXNG se mantiene según el pin oficial.

Preguntas frecuentes sobre Odysseus AI y SearXNG

El Docker Compose oficial incluye un servicio SearXNG. Una instalación nativa necesita una instancia accesible u otro proveedor compatible.

Dentro del contenedor, localhost es el propio contenedor. Usa http://searxng:8080 para el servicio de Compose.

Abre Settings → Search, selecciona SearXNG y pulsa Test; después realiza una búsqueda pequeña en el chat.

No automáticamente. El Compose oficial fija una imagen probada porque una versión posterior falló. Revisa siempre el archivo oficial actual.

Puede funcionar, pero puede limitar peticiones, desactivar formatos o desaparecer. Una instancia propia es más fiable.

Referencias oficiales

Repositorio canónico de Odysseus - Código, README y estado actual
Guía oficial de instalación - Entorno, red, puertos y seguridad
Docker Compose de Odysseus - Servicio SearXNG, health check e imagen fijada
Documentación de SearXNG - Instalación y configuración upstream

Guías relacionadas

Configurar Odysseus AI con Docker - Inicia el stack completo y revisa la red de contenedores.
Cómo usar Odysseus AI - Pasa de la instalación a un flujo de trabajo seguro.
Configurar Ollama con Odysseus AI - Conecta el modelo local de forma separada a la búsqueda web.

Última actualización: 22 de julio de 2026

Volver al inicio