커뮤니티 솔루션

ZimaOS 파일 검색 누락: 검색 색인 복원 및 문제 진단

A ZimaBoard 834 user lost the Files search box after an update; turning Search Index back on in Developer Mode restored it.

ZimaOS Files에서 Search 상자가 완전히 사라지면 무엇이든 재설치하기 전에 Search Index 토글을 확인하세요. Settings → General → Developer Mode → Search Index로 이동해 활성화한 다음 Files를 새로고침하세요. 검증된 1.5.4 사례에서는 이렇게 하자 사라졌던 검색 인터페이스가 즉시 복구되었습니다.

이 문제는 ZimaOS AI Search와 별개로 다뤄야 합니다. 기본 파일 검색은 인덱싱에 의존하고, 선택 사항인 AI 모듈은 미디어를 위한 더욱 정교한 로컬 검색 기능을 추가합니다. Search 상자가 사라졌다고 해서 반드시 하드웨어에 GPU가 없거나 AI 모듈이 고장 난 것은 아닙니다.

사라진 검색 UI의 모습

일반적인 검색 필드가 완전히 사라진 ZimaOS Files 사이드바
문제가 발생한 시스템에는 Shared 섹션 위에 Search 필드가 없었습니다. 출처: IceWhale 커뮤니티 포럼.
Shared 위에 예상된 Search 필드가 표시된 ZimaOS Files 사이드바
비교 시스템에서는 Files 사이드바에 예상대로 Search 필드가 표시되었습니다. 출처: IceWhale 커뮤니티 포럼.

중요한 단서는 검색 결과가 0개인 것이 아니라 Search 필드 전체가 보이지 않는다는 점입니다. 원래 사례에서는 Search Index가 비활성화된 상태로 유지되어 브라우저 새로고침, 로그아웃, 재부팅, ZimaOS 업데이트로도 문제가 해결되지 않았습니다.

1단계: Search Index 다시 활성화하기

  1. Settings를 여세요.
  2. General로 이동하세요.
  3. 꺼져 있다면 Developer Mode를 활성화하세요.
  4. 아래로 스크롤하여 Search Index 옵션을 찾으세요.
  5. 켜세요.
  6. Files 앱을 새로고침하거나 다시 여세요.

원래 사용자는 이 방법으로 검색 기능이 복구되었다고 확인했습니다. 따라서 이는 단순히 추측에 기반한 포럼의 해결책이 아니라, 이 증상에 대해 검증된 해결 방법입니다.

2단계: 인덱스가 다시 구축될 때까지 기다리기

검색 기능이 돌아왔는데 새로 추가한 파일이 바로 표시되지 않는다면 인덱싱이 아직 진행 중일 수 있습니다. 대용량 라이브러리는 메타데이터를 스캔하는 동안 일시적으로 CPU 및 디스크 사용량이 늘어날 수 있습니다.

그동안 인덱스를 반복해서 전환하지 마세요. 안정화되도록 기다린 다음, 존재하는 것을 알고 있는 파일 이름으로 테스트하세요.

3단계: AI 검색 전에 기본 검색 테스트하기

먼저 정확한 파일 이름이나 폴더 이름을 검색해 보세요. 검색이 되면 핵심 파일 인덱스가 작동 중인 것입니다. 그런 다음에야 선택 사항인 AI 강화 검색 기능의 문제를 해결하세요.

최신 ZimaOS AI Search 가이드에서 별도의 ZimaOS-AI 모듈과 요구 사항을 설명합니다.

재부팅만으로 검색창이 사라진 문제가 해결되지 않을 수 있는 이유

비활성화된 기능 플래그나 서비스 설정은 구성된 상태 그대로 재부팅 후에도 유지될 수 있습니다. 서버를 다시 시작해도 동일한 설정이 반복될 뿐입니다. 따라서 UI 요소가 완전히 보이지 않을 때는 반복해서 재부팅하기보다 Search Index 토글을 확인하는 것이 더 유용합니다.

Search Index 토글이 이미 켜져 있다면 어떻게 하나요?

깔끔한 브라우저 세션에서 시도하세요.

업데이트 후 오래된 프런트엔드 에셋이 원인인지 확인하려면 강력 새로고침을 하거나 비공개 창을 사용하세요.

필드가 사라진 것인지, 검색 결과가 없는 것인지 확인하세요.

필드는 있지만 검색 결과가 불완전하다면 인덱싱 상태를 확인하세요. 필드 자체가 사라졌다면 기능/UI 상태를 확인하세요.

정확한 ZimaOS 버전을 기록하세요.

문제가 해결된 사례는 1.5.4 버전에서 발생했습니다. 최신 버전에서도 같은 증상이 발생한다면 모든 내부 작동 방식이 동일하다고 가정하지 말고 새로운 회귀 문제로 보고하세요.

AI Search는 상황을 어떻게 바꾸나요?

ZimaOS AI Search는 로컬 모델을 사용해 이미지, 오디오 및 비디오 파일의 특징을 추출할 수 있습니다. 이는 선택적 향상 기능입니다. 기본 검색 필드를 복원하기 위해 AI 하드웨어 문제까지 진단할 필요는 없습니다.

기본 검색은 작동하지만 AI 스타일의 미디어 검색 기능이 작동하지 않는다면, 현재 문서에 설명된 AI 모듈, 모델, GPU/리소스 및 인덱싱 요구 사항을 확인하세요.

Search Index를 다시 활성화한 후의 성능

대용량 NAS에서 인덱싱을 진행하면 리소스 사용량이 잠시 증가할 수 있습니다. 인덱스 생성이 완료된 지 한참 지난 뒤에도 CPU나 저장 장치가 비정상적으로 바쁘다면 특정 디렉터리가 계속 변경되고 있는지, 또는 다른 애플리케이션이 같은 라이브러리를 스캔하고 있는지 확인하세요.

지속적인 성능 문제에는 NAS 성능 체크리스트가 유용합니다.

먼저 하지 말아야 할 일

  • Search Index 설정을 확인하기 전에 ZimaOS를 재설치하지 마세요.
  • 기본 검색창을 복원하려고 AI 모듈을 설치하지 마세요.
  • GPU가 없어서 기본 UI 필드가 사라졌다고 단정하지 마세요.
  • 비활성화된 상태인지 먼저 확인하지 않고 인덱스를 반복해서 다시 생성하지 마세요.

FAQ

ZimaOS에서 Search Index 설정은 어디에 있나요?

설정 → 일반을 열고 개발자 모드를 활성화한 다음, 해당 섹션에서 Search Index 토글을 찾으세요.

기본 ZimaOS 파일 검색에 GPU가 필요한가요?

아니요. 검색 필드가 사라진 사례는 Search Index를 다시 활성화해 해결했습니다. GPU 요구 사항은 선택적 AI 강화 검색 기능과 관련이 있으며, 기본 필드의 표시 여부와는 관계가 없습니다.

업데이트 후 검색이 사라진 이유는 무엇인가요?

사례에서는 이전 업데이트 후 인덱스 설정이 비활성화된 상태였지만, 설정이 바뀐 이유는 확인되지 않았습니다. 검증된 해결 방법과 입증되지 않은 원인은 별도로 다루세요.

인덱스를 활성화했는데도 검색이 계속 나타나지 않으면 어떻게 하나요?

깔끔한 브라우저 세션에서 시도하고, 인덱스가 다시 생성될 시간을 준 다음, 현재 ZimaOS 버전을 확인하세요. 그래도 필드가 나타나지 않으면 로그를 수집하거나 새 문제를 보고하세요.