ZimaOS 1.7.0 이후 Plex가 열리지 않거나 앱 편집기에 “저장하기 전에 YAML 자리 표시자를 해결하세요”라고 표시되면 앱을 제거하기 전에 ZimaOS 1.7.1 이상으로 업데이트하세요. 1.7.1에서는 YAML 저장 호환성이 개선되었고 앱을 제거할 때 해당 앱의 구성 폴더가 삭제될 수 있는 문제가 수정되었습니다.
원문의 사용자는 Plex를 다시 설치해 복구했지만, IceWhale은 ZimaOS 1.7.0에서 Plex를 제거하면 기본적으로 AppData가 삭제된다고 즉시 경고했습니다. 따라서 Plex 구성이 이미 백업되어 있지 않다면 재설치는 우선적으로 선택하기에 적절하지 않습니다.
YAML을 직접 편집하기 전에 ZimaOS 업데이트
공식 ZimaOS 1.7.1 릴리스 노트에는 개선된 YAML 저장 호환성과 앱 제거 시 구성 폴더가 삭제되는 문제에 대한 수정 사항이 나와 있습니다.
자리 표시자 경고의 원인
IceWhale 지원팀은 사용자에게 이전 Plex YAML의 <br>를 tips 텍스트에서 제거하라고 안내했습니다. 이는 Plex 데이터베이스 장애가 아니라 패키징 및 파서 호환성 문제였습니다.
Plex가 실제로 실행 중인지 확인
docker ps | grep -i plex
docker logs --tail 200 plex정상적인 LinuxServer Plex 컨테이너는 내부 웹 서비스가 포트 32400에서 실행되는 상태에 도달해야 합니다.
재설치 전에 Plex AppData 백업
Plex 메타데이터에는 라이브러리 데이터베이스, 시청 상태, 포스터, 서버 ID가 포함됩니다. 컨테이너를 삭제하거나 다시 만들기 전에 Plex 구성에 매핑된 디렉터리를 확인하고 백업하세요.
현재 앱 스토어 패키지 사용
현재 ZimaOS Plex 앱 스토어 페이지에는 유지 관리되는 1.43.2 릴리스 계열이 표시되어 있습니다.
미디어 볼륨 매핑 확인
Plex는 시작되지만 라이브러리가 비어 있다면 앱 설정을 열고 호스트 미디어 경로가 Plex에서 사용하는 컨테이너 경로에 여전히 매핑되어 있는지 확인하세요. 현재 Plex 설정 가이드에서 지원되는 저장소 구성 절차를 확인할 수 있습니다.
GPU 장치는 별도로 확인
원문의 로그에서는 /dev/dri/renderD128 및 /dev/dri/card0 권한이 정상으로 나타났습니다. 재생은 되지만 트랜스코딩이 실패한다면 YAML 오류와 별개로 GPU 매핑을 진단하세요.
Plex 하드웨어 가이드에서 해당 문제를 확인하는 데 도움을 받을 수 있습니다.
Plex 클레임 상태 확인
원문의 로그에서는 한 번은 이미 클레임된 상태로, 다른 한 번은 클레임되지 않은 상태로 표시되었습니다. Plex는 열리지만 잘못된 서버 또는 계정 상태가 표시된다면 영구 구성 볼륨이 유지되었는지 확인하고, 클레임 토큰을 다시 생성하기 전에 의도한 Plex 계정으로 로그인했는지 확인하세요.
ZimaOS 업데이트 후 컨테이너 이미지 확인
docker inspect plex --format '{{.Config.Image}}'실행 중인 이미지를 현재 앱 스토어 패키지와 비교하세요. ZimaOS가 정상적으로 업데이트되었다고 해서 수동으로 고정한 이전 Plex 이미지까지 자동으로 변경되는 것은 아닙니다.
라이브러리를 다시 만들기 전에 AppData 복원
제거하기 전에 AppData를 백업했다면 라이브러리 메타데이터가 손실되었다고 판단하기 전에 구성 디렉터리를 복원하세요. 새 Plex 데이터베이스에 테라바이트 단위의 미디어를 다시 추가하면 긴 재검색과 메타데이터 다운로드가 발생할 수 있지만, 원래 데이터베이스가 온전하다면 이를 피할 수 있습니다.
FAQ
1.7.0 오류를 해결하려면 Plex를 제거해야 하나요?
AppData를 백업하기 전에는 제거하지 마세요. 1.7.0에서는 제거 시 구성 폴더가 삭제될 수 있다고 IceWhale이 경고했습니다.
br 자리 표시자 오류는 무엇을 의미하나요?
앱 편집기가 YAML의 팁 필드에 있는 텍스트를 잘못 해석했다는 뜻입니다. 지원팀은 <br> 항목을 제거하라고 안내했습니다.
1.7.1에서 이러한 유형의 문제가 해결되었나요?
예. 변경 로그에는 YAML 저장 호환성 개선과 앱 구성 삭제 문제 수정이 포함되어 있습니다.
Plex는 실행 중인데 미디어가 표시되지 않는 이유는 무엇인가요?
호스트와 컨테이너 간 미디어 볼륨 매핑을 확인하고 Plex 라이브러리를 다시 검색하세요.
