Odysseus AIでSearXNGを設定・テスト・修復する完全ガイド

Odysseus AIでSearXNGを設定する仕組み

現在のOdysseusでは、SearXNGが標準のセルフホスト検索プロバイダーです。Web SearchとDeep Researchが検索先へ問い合わせ、取得した出典や本文をモデルへ渡します。モデルだけでは最新Web検索は実行できません。

接続URLは実行場所で変わります。ホスト側のlocalhost:8080は公開ポートを指しますが、Odysseusコンテナ内のlocalhostはそのコンテナ自身です。同じComposeネットワークでは http://searxng:8080 を使います。

Dockerに同梱されたSearXNGを起動する

公式ComposeはOdysseus、SearXNG、ChromaDB、ntfyをまとめて起動し、SearXNGをホストの127.0.0.1:8080へバインドします。アプリ単体ではなく、リポジトリ直下からスタック全体を起動してください。

確認日時点の公式ファイルはSearXNG 2026.5.31-7159b8aedを固定しています。上流の新しいイメージでヘルスチェックが失敗した経緯がコメントされているため、理由なく:latestへ置き換えないでください。

1. 環境ファイルを作る

   .env.exampleを.envへコピーします。固定シークレットが不要ならSEARXNG_SECRETは空のままで構いません。

2. スタック全体を起動する

   Odysseusディレクトリで docker compose up -d --build を実行します。

3. ヘルスチェックを待つ

   docker compose psでodysseusとsearxngの状態を確認します。

4. 再構築前にログを見る

   docker compose logs searxng --tail=100で権限、ボリューム、ポート、イメージ取得の問題を確認します。

docker compose up -d --build

docker compose ps

docker compose logs searxng --tail=100

外部SearXNGインスタンスへ接続する

SearXNGがComposeネットワーク外にある場合は、.envのSEARXNG_INSTANCEへOdysseusプロセスから到達できる最終URLを設定し、Odysseusを再起動します。

デスクトップのブラウザーで開けても、コンテナのDNS、TLS証明書、ファイアウォール、プロキシ認証が原因で失敗することがあります。公開共有インスタンスは制限や仕様変更があるため、管理下のセルフホスト環境が安定します。

SEARXNG_INSTANCE=http://localhost:8080

SEARXNG_INSTANCE=https://search.example.com

docker compose up -d --force-recreate odysseus

OdysseusでSearXNGを選択して検索を確認する

SettingsのSearchパネルを開き、ProviderにSearXNGを選んでTestを実行します。Deep ResearchもWeb Searchと同じプロバイダーを使うか、SearXNGを明示的に選べます。

テスト成功後、Web検索を有効にしたチャットで小さな質問を実行し、現在の出典リンクが返ることを確認します。Deep Researchは狭いテーマから始め、成功後にトークン数や並列数を増やします。

• SearchのProvider Testが成功する。
• チャット回答に現在の出典リンクが含まれる。
• Deep Researchが少なくとも1ページを取得・抽出できる。
• SearXNGポートを意図せずLANやインターネットへ公開していない。

Odysseus AIのSearXNGエラーを切り分ける

一度に複数設定を変えず、コンテナの状態、ネットワーク到達性、Provider Test、検索結果品質の順で確認します。

バージョン確認とセキュリティ

2026年7月22日に正規のodysseus-dev/odysseusを確認しました。Releasesとタグがなかったため、本稿は安定版番号を作らず、公式devブランチのsetupとComposeに従います。

SearXNG、モデルAPI、ChromaDBなどの生ポートは非公開にしてください。別ホストへ移す場合は、有効なTLS、認証または信頼できるプライベートネットワーク、明示的なファイアウォールを使います。