11 min de lecture 22 juillet 2026

Configurer SearXNG dans Odysseus AI et réparer la recherche web

Guide pratique du service Docker inclus, des instances externes, du test du fournisseur et des pannes qui bloquent Web Search ou Deep Research.

Odysseus AI Wiki
Odysseus AI Wiki
Guides indépendants sur l’IA locale créés par des fans
Configuration SearXNG dans l’interface officielle Odysseus AI
Interface du projet officiel Odysseus. SearXNG fournit le moteur de recherche auto-hébergé de Web Search et Deep Research.

Réponse rapide: Avec Docker Compose, Odysseus doit joindre SearXNG via http://searxng:8080. Démarrez toute la pile, ouvrez Settings → Search, choisissez SearXNG et lancez Test. Une installation native utilise généralement http://localhost:8080.

Sommaire

Configurer SearXNG dans Odysseus AI demande de vérifier deux éléments distincts : le service SearXNG doit être sain et le processus Odysseus doit utiliser une URL accessible depuis son propre réseau. Dans Docker, localhost ne désigne pas l’hôte. Le démarrage d’un seul conteneur ou le remplacement du tag épinglé peut également casser la recherche. Ce guide suit la branche dev officielle vérifiée le 22 juillet 2026. Aucun numéro de version stable n’est annoncé, car le dépôt ne publiait ni Release ni tag.

Comment configurer SearXNG dans Odysseus AI

SearXNG est le fournisseur auto-hébergé par défaut de l’interface actuelle. Web Search et Deep Research lui envoient les requêtes, puis le modèle reçoit les sources et le texte extrait. Le modèle seul ne remplace pas le service de recherche.

Sur l’hôte, localhost:8080 pointe vers le port publié. Dans le conteneur Odysseus, localhost désigne ce même conteneur ; l’adresse correcte du service Compose est donc http://searxng:8080.

Logo officiel SearXNG comme fournisseur de recherche Odysseus AI
SearXNG est un métamoteur indépendant auquel Odysseus se connecte comme fournisseur.
Exécution d’Odysseus URL SearXNG Cas d’usage
Docker Compose officiel http://searxng:8080 Les deux services partagent le réseau Compose
Odysseus natif sur l’hôte http://localhost:8080 SearXNG publie le port 8080 sur la même machine
Serveur séparé https://search.example.com Odysseus peut résoudre et joindre l’URL protégée

Utiliser le service SearXNG inclus dans Docker

Le Compose officiel démarre Odysseus, SearXNG, ChromaDB et ntfy. Il publie SearXNG sur 127.0.0.1:8080 et transmet l’adresse interne à Odysseus. Lancez toute la pile depuis la racine du dépôt.

Au moment de la vérification, le fichier officiel épinglait SearXNG sur 2026.5.31-7159b8aed. Ne remplacez pas ce tag par :latest sans validation : les commentaires du projet signalent qu’une image plus récente a échoué au health check.

N’utilisez pas localhost dans le conteneur

Avec Compose, le conteneur Odysseus doit utiliser http://searxng:8080. http://localhost:8080 concerne l’hôte ou une installation native.

  1. Créer le fichier d’environnement

    Copiez .env.example vers .env. Laissez SEARXNG_SECRET vide sauf besoin précis ; Docker peut le générer au premier démarrage.

  2. Démarrer toute la pile

    Exécutez docker compose up -d --build dans le dossier Odysseus.

  3. Attendre les contrôles de santé

    Utilisez docker compose ps et vérifiez les services odysseus et searxng.

  4. Lire les journaux avant de reconstruire

    docker compose logs searxng --tail=100 révèle souvent un problème de droit, volume, port ou image.

Démarrer Odysseus et ses services
docker compose up -d --build
Vérifier l’état
docker compose ps
Lire les derniers journaux
docker compose logs searxng --tail=100

Connecter une instance SearXNG externe

Si SearXNG est hors du réseau Compose, définissez SEARXNG_INSTANCE dans .env avec l’URL finale joignable depuis Odysseus, puis redémarrez l’application.

Testez DNS, TLS, pare-feu, proxy et authentification depuis le même contexte réseau. Une URL visible dans le navigateur peut rester inaccessible au conteneur. Les instances publiques peuvent limiter les requêtes ou modifier leurs formats.

Exemple natif sur le même hôte
SEARXNG_INSTANCE=http://localhost:8080
Exemple sur serveur séparé
SEARXNG_INSTANCE=https://search.example.com
Recréer l’application Docker
docker compose up -d --force-recreate odysseus

Sélectionner SearXNG et vérifier la recherche

Ouvrez Settings, puis Search, choisissez SearXNG et cliquez sur Test. Deep Research peut reprendre le même fournisseur ou sélectionner SearXNG explicitement. Ce test valide la configuration réellement utilisée par Odysseus.

Après réussite, lancez une requête courte avec la recherche web activée et vérifiez la présence de sources actuelles. Commencez Deep Research sur un sujet étroit avant d’augmenter les jetons ou la concurrence.

Interface officielle Odysseus AI utilisée pour tester SearXNG
Validez le fournisseur dans Settings → Search avant de diagnostiquer le modèle.
  • Le test du fournisseur réussit.
  • Le chat retourne des liens de sources actuelles.
  • Deep Research récupère et extrait au moins une page.
  • Le port SearXNG reste privé sauf exposition volontaire et protégée.

Dépanner les erreurs SearXNG d’Odysseus AI

Vérifiez dans l’ordre la santé des conteneurs, la connectivité, le test du fournisseur puis la qualité des résultats.

Symptôme Cause probable Contrôle suivant
Connection refused Mauvais hôte, conteneur arrêté ou port occupé Vérifier docker compose ps et searxng:8080 dans Compose
Odysseus attend ou devient unhealthy Health check SearXNG en échec Lire les logs et conserver l’image épinglée
Le navigateur fonctionne mais Test échoue L’URL de l’hôte est inaccessible au conteneur Tester DNS/TLS depuis Docker et remplacer localhost
Résultats vides ou bloqués Moteurs, limites, SafeSearch ou format Tester directement SearXNG et settings.yml
Deep Research expire Recherche, DNS ou extraction lente Faire réussir Test puis réduire la portée et la concurrence
Réglages perdus au redémarrage Conteneur non recréé ou volume absent Vérifier .env, overrides et volumes

Fraîcheur des versions et sécurité

Le dépôt canonique odysseus-dev/odysseus a été vérifié le 22 juillet 2026. Sans Release ni tag, cette page ne fabrique pas de version stable et suit les fichiers setup et Compose de la branche dev.

Gardez privés SearXNG, les serveurs de modèles, ChromaDB et les ports techniques. Pour un hôte séparé, utilisez TLS valide, authentification ou réseau privé et des règles de pare-feu explicites.

Contrôle de fraîcheur

Sources officielles vérifiées le 22 juillet 2026 : dépôt canonique et fichiers setup/Compose. Aucun tag stable ; image SearXNG conforme au pin officiel.

FAQ Odysseus AI et SearXNG

Le Docker Compose officiel inclut un service SearXNG. Une installation native nécessite une instance joignable ou un autre fournisseur pris en charge.

Dans le conteneur, localhost désigne ce conteneur. Utilisez http://searxng:8080 pour le service Compose.

Ouvrez Settings → Search, choisissez SearXNG et cliquez sur Test, puis lancez une petite recherche dans le chat.

Pas automatiquement. Le Compose officiel épingle une image testée ; vérifiez toujours le fichier officiel actuel avant de changer le tag.

C’est possible, mais elle peut limiter les requêtes, désactiver des formats ou disparaître. Une instance contrôlée est plus fiable.

Références officielles

  1. Dépôt GitHub canonique d’Odysseus - Source, README et état actuel
  2. Guide d’installation Odysseus - Environnement, réseau, ports et sécurité
  3. Docker Compose Odysseus - Service SearXNG, health check et image épinglée
  4. Documentation SearXNG - Installation et configuration en amont

Guides associés

Dernière mise à jour : 22 juillet 2026

Retour à l’accueil