스택을 다시 만들면 Plex가 지속 데이터에 대한 액세스 권한을 잃는 이유는 무엇인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

기존 영구 데이터가 실제로 사라졌다고 확인하기 전까지는 스택을 재생성한 뒤 나타난 새 Plex 인스턴스를 마운트 또는 권한 문제로 간주하세요.

Docker 또는 Compose 스택을 재생성하면 컨테이너가 교체될 뿐 아니라 `/config`를 지원하는 호스트 경로, 명명된 볼륨, 사용자 ID 또는 스토리지 풀도 바뀔 수 있습니다. 그러면 Plex가 비어 있거나 읽을 수 없는 디렉터리를 대상으로 실행되어 새로 설치된 것처럼 보일 수 있습니다. 새 인스턴스를 중지하고 이전 앱 데이터를 찾은 다음 실제 마운트와 숫자형 소유권을 비교하세요. 해당 상태가 실제로 사라진 경우에만 백업에서 복원하세요.

Plex가 새 서버처럼 보이면 중지하세요

스택을 재생성한 뒤 설정 마법사가 다시 표시된다면 이는 영구 저장에 문제가 있다는 경고이지, 라이브러리를 다시 만들라는 뜻이 아닙니다. 컨테이너를 중지하고 Plex가 상태를 더 기록하기 전에 데이터 매핑을 확인하세요. 가장 흔한 문제는 새 컨테이너가 이전 애플리케이션 데이터 디렉터리 대신 비어 있는 호스트 경로를 읽는 것입니다.

스택을 재생성한 뒤 영구 설정 매핑이 더 이상 원래 앱 데이터를 가리키지 않으면 컨테이너가 새 설정 화면을 표시할 수 있습니다. 가장 먼저 확인할 것은 이전 상태가 호스트에 여전히 남아 있는지입니다.

이전 Plex 데이터 디렉터리를 찾아 수정 시간, 데이터베이스 파일, 메타데이터 폴더를 확인하세요. 해당 항목이 있다면 삭제하거나 새 서버를 초기화하지 마세요. 복구 대상은 미디어 라이브러리가 아니라 마운트 경로와 권한입니다.

이전 /config 매핑과 새 매핑을 정확히 비교하세요

스택을 재생성하면 컨테이너 경로가 그대로 보여도 상대 경로 바인드 마운트, 명명된 볼륨, 환경 변수 치환, 스토리지 풀 또는 Compose 작업 디렉터리가 바뀔 수 있습니다. Plex에서 계속 `/config`로 보이더라도, 이제는 다른 호스트 위치를 가리킬 수 있습니다.

Plex 컨테이너를 설정할 때는 컨테이너 외부에 설정 파일을 저장하는 것이 가장 안전합니다. 겉보기에 비슷한 Compose 파일을 그대로 믿지 말고, 이전 배포 기록이나 백업의 실제 마운트와 새로 만든 스택의 마운트를 비교하세요.

기존 앱 데이터가 확실히 있는지 확인하려면 이를 임시 진단용 컨테이너에 읽기 전용으로 마운트하거나 호스트에서 직접 살펴보세요. 예상한 데이터베이스와 환경설정 파일이 있다면 운영 환경의 매핑을 바로잡고 Plex를 한 번 재시작하세요. 디렉터리가 실제로 없다면 백업 복구로 넘어가세요.

데이터베이스를 탓하기 전에 소유권 확인하기

올바른 호스트 경로를 사용하더라도 재생성된 컨테이너가 다른 UID, GID, 사용자 네임스페이스 또는 보안 컨텍스트로 실행되면 사용할 수 없을 수 있습니다. 데이터가 올바른 위치에 마운트되어 있어도 Plex에서 환경설정을 저장하거나 데이터베이스 파일을 열거나 디렉터리를 만들지 못하는 것처럼 보일 수 있습니다.

Plex가 앱 데이터를 만들거나 업데이트하지 못할 때는 `777`을 무작정 하위 항목 전체에 적용해 “해결”하지 말고 구성 디렉터리 권한을 숫자로 확인해야 합니다.

컨테이너 내부에서 ID를 확인하고 호스트의 숫자 소유자 및 모드와 비교하세요. 의도한 서비스 계정에 액세스 권한을 부여하는 데 필요한 최소한의 소유권 또는 ACL 수정만 적용하세요. 그런 다음 Plex를 시작하고 새 설정이 아니라 기존 서버가 열리는지 확인하세요.

숫자 소유자가 일치하는데도 액세스에 실패하면 데이터베이스를 변경하기 전에 ACL, 컨테이너 보안 레이블, 사용자 네임스페이스 동작을 확인하세요. 올바른 UID/GID라도 별도의 액세스 제어 계층을 우회하지는 못합니다.

애플리케이션 상태가 복원된 후에만 미디어 마운트를 확인하세요

기존 서버 ID와 라이브러리가 다시 표시된 후에도 미디어 마운트가 `/config`와 별도로 변경되었기 때문에 일부 라이브러리를 사용할 수 없는 것처럼 보일 수 있습니다. 이는 별도의 영구 데이터 역할입니다. 라이브러리를 다시 만들거나 미디어를 애플리케이션 데이터 디렉터리에 복사하지 말고 미디어 경로를 수정하세요.

애플리케이션 상태와 미디어 마운트를 별도의 영구 데이터 역할로 유지하세요. 이렇게 분리하면 먼저 Plex ID를 복원하고, 원래 라이브러리가 다시 표시된 뒤에 누락된 미디어 경로를 해결할 수 있습니다.

Plex 컨테이너 내부에서 알려진 미디어 경로 몇 개를 여세요. 기존 데이터베이스는 `/media/movies`를 가리키는데 새로 만든 스택은 `/movies`를 노출한다면, 예상되는 내부 경로를 복원하거나 라이브러리 경로를 통제된 방식으로 이전할 계획을 세우세요. 마운트가 안정화되기 전에는 다시 스캔하지 마세요.

원래 상태가 완전히 사라진 경우에만 백업에서 복원하세요

기존 호스트 디렉터리가 비어 있거나 삭제되었거나 복구할 수 없을 정도로 손상된 경우, 가장 최근의 정상 작동이 확인된 Plex 앱 데이터 백업을 올바르게 매핑된 깨끗한 경로에 복원하세요. 실패한 상태는 별도로 보존해 두세요. 유일한 증거를 덮어쓰지 않고도 무슨 일이 있었는지 확인할 수 있습니다.

안정적인 컨테이너 복구 워크플로는 영구 `/config`를 보호하고, 교체 가능한 애플리케이션 계층만 바꾸며, Plex가 다시 쓰기를 시작하기 전에 마운트를 검증합니다.

복원 후 서버 ID, 라이브러리 수, 시청 상태, 로컬 재생, 트랜스코딩을 사용한다면 트랜스코딩, 재시작 1회를 확인하세요. 그런 다음 실제 적용된 스택 구성을 기록하고 백업 위치를 확인하세요. 수동으로 추측할 필요 없이 다시 생성했을 때도 동일한 영구 데이터가 연결되는 것이 확인되어야 사고가 종결됩니다.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.