약 11분 2026년 7월 22일

Odysseus AI에서 SearXNG 설정·테스트·문제 해결하기

Docker에 포함된 서비스, 외부 SearXNG, 검색 공급자 테스트, Web Search와 Deep Research 장애를 단계별로 확인합니다.

Odysseus AI Wiki
Odysseus AI Wiki
팬이 운영하는 독립 로컬 AI 가이드
Odysseus AI 공식 화면의 SearXNG 설정
공식 Odysseus 프로젝트 화면입니다. SearXNG는 Web Search와 Deep Research에 자체 호스팅 검색을 제공합니다.

빠른 답변: 기본 Docker Compose에서는 Odysseus 컨테이너가 http://searxng:8080 을 사용해야 합니다. 전체 스택을 시작한 뒤 Settings → Search에서 SearXNG를 선택하고 Test를 실행하세요. 네이티브 설치는 보통 http://localhost:8080 을 사용합니다.

목차

Odysseus AI에서 SearXNG를 설정하려면 두 가지를 따로 확인해야 합니다. SearXNG 서비스가 정상이어야 하고, Odysseus 프로세스가 자신의 네트워크에서 접근 가능한 URL을 사용해야 합니다. Docker 컨테이너 안에서 localhost를 쓰거나 일부 서비스만 시작하거나 검증된 고정 이미지를 무작정 :latest로 바꾸면 검색이 중단될 수 있습니다. 이 문서는 2026년 7월 22일에 확인한 공식 dev 브랜치를 기준으로 합니다. GitHub Releases와 태그가 없었으므로 존재하지 않는 안정 버전 번호를 주장하지 않습니다.

Odysseus AI의 SearXNG 설정 구조

현재 Odysseus 화면에서 SearXNG는 기본 자체 호스팅 검색 공급자입니다. Web Search와 Deep Research가 검색 요청을 보내고, 모델은 반환된 출처와 추출 텍스트를 사용합니다. 모델 자체가 검색 서비스를 대체하지는 않습니다.

호스트의 localhost:8080은 공개된 포트를 가리킵니다. Odysseus 컨테이너 내부의 localhost는 그 컨테이너 자신이므로, 같은 Compose 네트워크에서는 http://searxng:8080 이 올바릅니다.

Odysseus AI 검색 공급자의 공식 SearXNG 로고
SearXNG는 독립 메타검색 엔진이며 Odysseus는 이를 검색 공급자로 연결합니다.
Odysseus 실행 방식 SearXNG URL 사용 상황
공식 Docker Compose http://searxng:8080 두 서비스가 같은 Compose 네트워크 사용
호스트에서 네이티브 실행 http://localhost:8080 같은 PC에서 SearXNG 8080 포트 공개
별도 서버 https://search.example.com Odysseus가 보호된 주소를 해석하고 접근 가능

Docker에 포함된 SearXNG 서비스 시작하기

공식 Compose는 Odysseus, SearXNG, ChromaDB, ntfy를 함께 시작합니다. SearXNG는 호스트의 127.0.0.1:8080에 바인딩되고 내부 서비스 URL이 Odysseus에 전달됩니다. 저장소 루트에서 전체 스택을 시작하세요.

확인 당시 공식 파일은 SearXNG 2026.5.31-7159b8aed 이미지를 고정했습니다. 더 최신 상류 이미지가 상태 검사에 실패한 사례가 주석에 있으므로 이유 없이 :latest로 바꾸지 마세요.

컨테이너 안에서 localhost를 사용하지 마세요

기본 Compose에서 Odysseus 컨테이너는 http://searxng:8080 을 사용합니다. http://localhost:8080 은 호스트나 네이티브 실행용입니다.

  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에서 권한, 볼륨, 포트, 이미지 문제를 찾습니다.

Odysseus와 포함 서비스 시작
docker compose up -d --build
서비스 상태 확인
docker compose ps
최근 SearXNG 로그 확인
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 앱 다시 만들기
docker compose up -d --force-recreate odysseus

Odysseus에서 SearXNG 선택과 검색 확인

Settings의 Search 패널에서 Provider를 SearXNG로 선택하고 Test를 누릅니다. Deep Research도 웹 검색과 같은 공급자를 사용하거나 SearXNG를 명시적으로 선택할 수 있습니다.

테스트가 성공하면 웹 검색을 켠 채 짧은 질문을 실행하고 최신 출처 링크가 반환되는지 확인합니다. Deep Research는 작은 주제로 시작한 뒤 토큰과 동시성을 늘리세요.

SearXNG를 테스트하는 Odysseus AI 공식 화면
모델 품질을 확인하기 전에 Settings → Search의 공급자 테스트부터 통과시키세요.
  • 검색 공급자 Test가 성공합니다.
  • 채팅 응답에 최신 출처 링크가 포함됩니다.
  • Deep Research가 최소 한 페이지를 가져오고 추출합니다.
  • SearXNG 포트는 의도적으로 보호해 공개하지 않는 한 비공개로 유지됩니다.

Odysseus AI SearXNG 오류 해결

컨테이너 상태, 네트워크 접근, 공급자 테스트, 결과 품질 순서로 한 단계씩 확인하세요.

증상 가능한 원인 다음 확인
Connection refused 잘못된 호스트명, 중지된 서비스, 포트 충돌 docker compose ps와 Compose 내부 searxng:8080 확인
Odysseus가 대기하거나 unhealthy SearXNG 상태 검사 실패 로그 확인 후 공식 고정 이미지 유지
브라우저는 열리지만 Test 실패 호스트 URL을 컨테이너에서 접근 불가 컨테이너 DNS/TLS 확인 후 localhost 교체
결과가 비거나 차단됨 엔진, 제한, SafeSearch, 응답 형식 SearXNG 직접 검색과 settings.yml 확인
Deep Research 시간 초과 검색, DNS, 추출 대상이 느림 먼저 Test를 통과시키고 범위와 동시성 축소
재시작 후 설정이 사라짐 컨테이너 미재생성 또는 볼륨 문제 .env, override, volume 확인

버전 확인과 보안

2026년 7월 22일에 정식 odysseus-dev/odysseus 저장소를 확인했습니다. Releases와 태그가 없어 안정 버전을 만들지 않고 공식 dev 브랜치의 setup과 Compose 파일을 따릅니다.

SearXNG, 모델 서버, ChromaDB 및 내부 서비스 포트는 비공개로 유지하세요. 별도 호스트에서는 유효한 TLS, 인증 또는 신뢰할 수 있는 사설망과 명시적 방화벽 규칙을 사용합니다.

최신성 확인

2026년 7월 22일 정식 GitHub와 공식 setup/Compose를 확인했습니다. 안정 태그는 없으며 SearXNG 이미지는 공식 고정값을 따릅니다.

Odysseus AI와 SearXNG FAQ

공식 Docker Compose에는 SearXNG 서비스가 포함됩니다. 네이티브 설치는 접근 가능한 인스턴스나 다른 지원 공급자가 필요합니다.

컨테이너 내부 localhost는 그 컨테이너 자신입니다. 포함된 Compose 서비스에는 http://searxng:8080 을 사용하세요.

Settings → Search에서 SearXNG를 선택하고 Test를 누른 뒤 작은 웹 검색을 실행합니다.

자동으로 바꾸지 마세요. 공식 Compose는 검증된 이미지를 고정하므로 변경 전 최신 공식 파일을 확인해야 합니다.

가능할 수 있지만 요청 제한, 형식 비활성화, 중단 위험이 있습니다. 관리하는 인스턴스가 더 안정적입니다.

공식 자료

  1. Odysseus 정식 GitHub 저장소 - 현재 소스와 README
  2. Odysseus 공식 설정 가이드 - 환경, 네트워크, 포트, 보안
  3. Odysseus Docker Compose - SearXNG 서비스, 상태 검사, 고정 이미지
  4. SearXNG 공식 문서 - 상류 설치와 구성

관련 가이드

최종 업데이트: 2026년 7월 22일

홈으로 돌아가기