다른 이미지를 가져오기 전에 실패한 Plex 컨테이너와 자동 업데이트를 중지하세요. 먼저 현재 로그와 실제 Plex 설정 경로를 보존하세요. 문제가 있는 컨테이너가 계속 스스로 교체되거나 애플리케이션 상태에 기록하지 못하게 하면 복구가 훨씬 안전해집니다.
홈 NAS에서 컨테이너 업데이트는 여러 계층에서 실패할 수 있습니다. 새 이미지가 시작되지 않을 수도 있고, 컨테이너를 다시 만들면서 서비스의 볼륨이나 네트워크 설정이 사라질 수도 있으며, 새 Plex 빌드가 기존 애플리케이션 데이터를 다르게 열 수도 있습니다. 특히 `/config` 아래의 데이터베이스와 메타데이터 등 Plex의 영구 설정이 중요한 경계입니다. 이 절차에서는 각각을 변경하기 전에 이미지, 컨테이너 정의, 마운트, 데이터베이스를 분리해 확인한 다음, 문제가 발생한 최소 계층만 복원하고 기존 서버 ID, 라이브러리, 재생을 확인합니다. 로그에서 데이터베이스 손상이나 되돌릴 수 없는 마이그레이션이 확인되면, 해당 상태의 유일한 사본에 구버전 이미지를 강제로 적용하기 전에 중단하세요.
업데이트 루프를 중지하고 실패 상태를 저장하세요
Plex 자동 업데이트를 비활성화하고 잦은 재시작 루프를 중지하세요. Plex가 함께 중지해야 하는 데이터베이스를 공유하는 경우가 아니라면 다른 정상 서비스는 계속 실행해 두세요. 목표는 전체 앱 스택을 재시작해 문제 발생 경위를 지우는 것이 아니라, 실패 상태를 그대로 유지해 점검하는 것입니다.
실패한 컨테이너의 정확한 이미지 태그, 이미지 ID, 가능하다면 다이제스트도 기록하세요. 적용된 마운트, 환경 변수, 게시된 포트, 네트워크 모드, 네트워크 별칭, 장치 매핑, 추가된 그룹, 재시작 정책, 상태 확인 결과를 저장하세요. `latest` 같은 태그만으로는 확실한 롤백 기록이 되지 않습니다. 시간이 지나면 다른 이미지 콘텐츠를 가리킬 수 있기 때문입니다.
다시 시작을 시도하기 전에 최근 로그를 내보내고, 최종 종료 코드뿐 아니라 처음 나타난 치명적 메시지도 기록하세요. 파일 누락, 권한 거부, 데이터베이스 오류, 지원되지 않는 명령어 또는 주소 충돌은 각각 복구 경로가 다릅니다. 업데이트가 실행된 시점과 컨테이너를 다시 만들었는지도 기록하세요. 이미지만 가져오면 기존 컨테이너는 바뀌지 않지만, 컨테이너를 다시 만들면 실제 설정이 달라질 수 있습니다.
실패가 재현되고 어떤 이미지가 실행됐는지, 어떤 영구 경로를 사용했는지, 어떤 런타임 설정을 받았는지, 어떤 오류가 가장 먼저 나타났는지라는 네 가지 질문에 답할 수 있으면 계속 진행해도 됩니다. 이 사실들이 아직 확인되지 않았다면 이미지를 다시 가져오거나 재시작해도 복구가 더 안전해지지 않고 혼란만 더해집니다.
컨테이너를 다시 만들기 전에 Plex 환경설정 보호하기
컨테이너는 교체 가능한 것으로, Plex 환경설정은 영구 데이터로 취급하세요. 중요한 상태 데이터는 일반적으로 `/config`에 마운트된 호스트 경로 또는 명명된 볼륨에 저장됩니다. 미디어 라이브러리는 별도의 마운트로 유지해야 합니다. 서비스를 다시 만드는 작업은 빈 디렉터리가 아니라 동일한 영구 상태에 다시 연결하는 경우에만 위험이 낮습니다.
호스트에서, 그리고 플랫폼이 지원한다면 임시 읽기 전용 환경에서도 마운트를 검사하세요. 예상된 데이터베이스, 환경설정, 메타데이터, 플러그인 데이터 및 로그가 있는지 확인하세요. 마운트 소스, 파일 시스템, 소유권, 권한, 사용 가능한 공간, 읽기 전용 상태로 바뀌었는지 여부를 기록하세요. 예상 경로의 디렉터리가 비어 있다면 작업을 중단해야 합니다. Plex가 그곳에 새 서버를 생성하도록 해도 된다는 뜻이 아닙니다.
롤백을 테스트하기 전에 예정된 전체 환경설정 경로를 백업한 다음, 백업을 나열할 수 있거나 별도의 위치에 복원할 수 있는지 확인하세요. 파일 시스템에서 스냅샷을 지원한다면 복구 시간을 단축할 수 있지만, 동일한 저장 장치에 문제가 생길 가능성이 있을 때 스냅샷을 유일한 복사본으로 삼아서는 안 됩니다. 서버가 정상임을 확인할 때까지 실패한 상태와 마지막으로 정상 작동한 백업을 모두 보관하세요.
이전 이미지가 시작되도록 환경설정 파일, 데이터베이스 파일 또는 메타데이터를 삭제하지 마세요. 환경설정을 일관된 상태로 읽을 수 없거나, 소유자가 불분명하거나, 복사본을 검증할 수 없다면 바로 스토리지 또는 데이터베이스 복구로 넘어가세요. 컨테이너를 다시 만들어도 신뢰할 수 없는 상태 원본은 복구되지 않습니다.
이미지, 정의, 마운트 또는 데이터베이스 중 무엇이 실패했는지 판단하기
수정 방법을 선택하기 전에 캡처한 컨테이너를 마지막으로 작동한 배포와 비교하세요. 먼저 치명적인 로그의 첫 줄과 실제 적용된 정의를 확인한 다음, 문제를 다음 네 가지 중 하나로 분류하세요. 새 이미지가 실행되지 않는 경우, 컨테이너 정의가 변경된 경우, 영구 경로를 사용할 수 없는 경우 또는 Plex가 기존 애플리케이션 상태를 사용하지 못하는 경우입니다.
이미지 또는 런타임 오류는 보통 Plex가 `/config`를 열기 전에 나타납니다. 아키텍처 오류, 지원되지 않는 CPU 명령, 누락된 런타임 라이브러리 또는 컨테이너 정의가 바뀌지 않았는데도 프로세스가 즉시 종료되는 경우가 이에 해당합니다. 버전에 따른 재생 오류가 서버를 이전 Plex 이미지로 되돌린 뒤 사라졌습니다. 따라서 같은 정의가 이전에는 작동했고 마운트나 권한이 변경되지 않았다면 롤백을 유용한 판별 방법으로 사용할 수 있습니다.
다시 만든 후 Plex가 미디어 누락, 빈 서버, 파일 액세스 거부, 웹 엔드포인트 없음 또는 하드웨어 액세스 손실 상태로 시작되면 정의 또는 마운트 오류가 발생한 것입니다. 저장된 볼륨 소스와 실제 적용된 볼륨 소스, UID/GID, 그룹, 포트, 네트워크 모드, 장치 및 환경 변수를 비교하세요. 한 번에 모든 항목을 바꾸지 말고, 처음 확인된 불일치부터 수정하세요.
데이터베이스 및 마이그레이션 메시지는 별도로 처리해야 합니다. 새 빌드에서 스키마 변경이 시작되었다면 이전 이미지는 변경된 상태를 읽지 못할 수 있습니다. 현재 구성을 다시 백업하고 로그를 보존하며, 여러 버전에서 반복적으로 강제 시작하지 마세요. 이 경우 호환되는 이미지, 업데이트 전 백업이 검증된 경우의 해당 백업 또는 데이터베이스를 고려한 복구가 필요합니다.
| 관찰된 결과 | 주요 분기 | 첫 번째 복구 단계 |
|---|---|---|
| `/config`를 읽기 전에 프로세스가 종료됨 | 이미지 또는 런타임 | 변경하지 않은 정의로 보존된 정상 이미지 시작 |
| Plex가 신규 또는 비어 있는 서버로 시작됨 | 잘못된 `/config` 매핑 | 중지하고 원래 마운트 소스를 복원하세요 |
| 구성 또는 미디어에 권한 오류가 표시됨 | 마운트 소유권 또는 읽기 전용 상태 | 검증된 UID/GID, 그룹 또는 스토리지 액세스를 복원하세요 |
| 로그에 마이그레이션 또는 데이터베이스 오류가 표시됨 | 애플리케이션 상태 | 상태를 보존하고 호환되는 이미지 또는 검증된 백업 사용 |
마지막으로 정상 작동이 확인된 Plex 이미지로 롤백하기
마지막으로 정상 실행된 정확한 이미지를 선택하세요. 변경될 수 있는 태그보다 보존된 이미지 다이제스트, 변경 불가능한 버전 참조 또는 로컬 이미지 ID를 우선 사용하세요. 업데이트 프로그램이 시작 직후 롤백 이미지를 교체하지 못하도록 자동 업데이트를 비활성화하세요.
저장된 정의를 사용해 Plex 서비스만 다시 만드세요. 네트워크에 영향을 미치는 경우 동일한 프로젝트 또는 컨테이너 ID를 유지하고, 동일한 `/config` 및 미디어 소스, 포트, 네트워크 모드, 환경 변수, UID/GID, 그룹 및 장치를 그대로 사용하세요. 볼륨을 제거하지 말고, 이전 이미지 테스트를 마치기 전에 시스템 전체 정리를 실행하지 마세요.
첫 구동 과정을 실시간으로 확인하세요. 이미지 롤백에 성공하면 원래 구성이 열리고, 동일한 서버 ID가 유지되며, 기존 라이브러리가 표시되고, 이전의 치명적인 오류가 더 이상 발생하지 않아야 합니다. 기본 로그인과 미디어 액세스가 작동할 때까지 선택적 하드웨어 트랜스코딩과 백그라운드 검사는 미뤄 두세요.
이전 이미지에서 데이터베이스가 더 최신 버전이거나 호환되지 않거나 마이그레이션 중이라는 메시지가 표시되면 중단하세요. 버전을 반복해서 전환하면 복구 지점을 파악하기 어려워질 수 있습니다. 안전하지 않은 다운그레이드를 강행하는 대신, 검증된 업데이트 전 구성 사본을 격리된 경로에 복원하거나 호환되는 Plex 이미지로 전환하세요.
롤백만으로 해결되지 않을 때 기존 컨테이너 정의 복원하기
정상 작동이 확인된 이미지에서도 문제가 계속되면 정의 비교 단계로 돌아가세요. 누락된 설정을 한 번에 하나씩 복원하고, 각 변경 후 Plex만 다시 시작하세요. 이렇게 하면 확인해야 할 증거가 명확해집니다. 서버가 복구되면 어떤 런타임 종속성이 원인이었는지 알 수 있습니다.
`/config`와 미디어 마운트부터 확인하세요. 컨테이너가 의도한 경로를 인식하고 구성된 사용자로 읽을 수 있는지 확인하세요. 업데이트 후 Plex가 다른 UID 또는 GID, 보조 그룹 또는 보안 컨텍스트로 다시 생성됐다면 마지막으로 작동했던 ID를 복원하거나 스토리지 소유권을 신중하게 바로잡으세요. 편법으로 전체 앱 데이터 디렉터리를 모든 사용자가 쓸 수 있게 만들지 마세요.
그런 다음 웹 경로와 선택적 기기를 확인하세요. 방화벽 규칙을 변경하기 전에 이전 호스트 네트워크 또는 공개 포트, 네트워크 별칭, 리버스 프록시 연결을 복원하세요. 먼저 직접 서버 경로에서 웹 인터페이스에 접속되는지 확인하세요. Plex가 시작되고 라이브러리를 불러오며 기본적인 소프트웨어 호환 스트림을 제공할 수 있게 된 후에만 GPU 기기와 렌더 그룹 접근 권한을 추가하세요.
정의 복구가 제대로 완료되면 상태가 명확해야 합니다. 컨테이너가 의도한 구성과 미디어를 인식하고, Plex 엔드포인트에 연결할 수 있으며, 로그에 선택한 종속성 오류가 더 이상 표시되지 않아야 합니다. 이러한 점검 후에도 같은 데이터베이스 오류가 계속되면 컨테이너를 다시 만들지 말고 보호된 애플리케이션 상태 복구 단계로 돌아가세요.
업데이트를 다시 활성화하기 전에 Plex 데이터베이스, 라이브러리, 재생 확인하기
실행 중인 프로세스는 복구 점검의 첫 단계일 뿐입니다. 직접 Plex 엔드포인트에 로그인해, 빈 구성 디렉터리에서 새로 생성된 서버가 아니라 기존에 클레임한 서버인지 확인하세요. 시작 로그에서 데이터베이스 손상, 반복되는 마이그레이션 시도, 예상치 못한 라이브러리 초기화를 살펴보세요.
기존 라이브러리 항목 몇 개를 열어 포스터, 메타데이터, 시청 상태 및 파일 경로가 있는지 확인하세요. 업데이트 전에 사용하던 것과 동일한 스토리지에서 정상 작동이 확인된 작은 미디어 파일 하나에 액세스해 보세요. 메타데이터는 있지만 미디어에 액세스할 수 없다면 데이터베이스는 정상이고 미디어 마운트나 권한만 복구가 필요할 수 있습니다.
문제없이 재생되는 것으로 확인된 파일을 로컬 클라이언트 하나에서 재생한 다음, 해당되는 경우 문제가 드러난 클라이언트에서도 재생하세요. 재생 모드를 기록하고 탐색 기능이 작동하는지 확인하세요. 기본 재생에 성공했다면 GPU 가속 누락, 원격 액세스 또는 자막 동작은 별도의 후속 점검 항목으로 다루세요. 복구된 서버를 보존하는 데 방해가 되어서는 안 됩니다.
마지막으로 업데이트 프로그램을 비활성화한 상태에서 Plex 서비스를 한 번 제어된 방식으로 재시작하세요. 재시작 후에도 동일한 서버 식별 정보, 데이터베이스, 라이브러리, 메타데이터, 미디어 액세스 및 기본 재생이 복구되어야 복구에 성공한 것입니다. 이 전체 결과를 반복해서 확인할 수 있을 때까지 수집한 오류 로그와 백업을 보관하세요.
중단해야 할 시점과 다음 Plex 업데이트를 복구 가능하게 만드는 방법 파악하기
로그에 데이터베이스 손상이 반복적으로 보고되거나, 구성 파일 시스템에서 I/O 오류가 발생하거나, 상태 사본 하나만 부분적으로 마이그레이션되었거나, 호환되는 이미지가 상태를 열 수 없다면 로컬 컨테이너 복구를 중단하세요. 이미지 식별 정보, 유효한 정의, 로그 및 구성 백업을 보존하세요. 이 단계에서는 컨테이너를 계속 교체하는 것보다 데이터베이스를 고려한 복원이나 스토리지 복구가 더 안전합니다.
Plex가 안정화되면 복구된 이미지 다이제스트, 컨테이너 정의, 영구 경로, 런타임 ID, 네트워크 모드, 장치 및 검증 결과를 문서화하세요. Plex가 공유 데이터베이스, 프록시 네트워크 또는 다른 스택 서비스에도 의존하는 경우 더 폭넓은 단일 서비스 복구 절차가 유용하지만, Plex에 문제가 생겼다는 이유만으로 정상 작동 중인 종속 서비스를 복원해서는 안 됩니다.
다음 업데이트에서는 새 `/config` 백업을 만들고 검증한 뒤, 현재 이미지를 보존하고 자동 정리를 비활성화한 상태로 Plex를 수동 업데이트하세요. 자동화를 다시 활성화하기 전에 서버 식별 정보, 라이브러리, 재생, 재시작 검사를 반복하세요. 테스트된 롤백 대상과 정상 작동하는 새 버전을 모두 보존해야 업데이트가 완료된 것입니다.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



