Compose를 사용하여 OpenMediaVault에 Plex를 설치하고 설정하는 방법

이전 OpenMediaVault 가이드에 나와 있는 Plex 플러그인은 더 이상 권장되지 않습니다. 해당 프로젝트 저장소는 2024년 2월에 보관 처리되었습니다. 최신 OpenMediaVault 8에서는 OMV-Extras Compose 플러그인과 Plex의 공식 Docker 이미지를 사용하여 Plex Media Server를 컨테이너로 설치하십시오. 이렇게 하면 Plex가 NAS 운영 체제와 분리되어 OMV 웹 인터페이스에서 구성을 관리할 수 있습니다.

절차는 OMV 8을 기준으로 하며, OMV 7에서는 사용 중인 릴리스에 맞는 Compose 플러그인 버전을 선택하십시오.

시작하기 전에

OMV가 설치되어 있고 데이터 드라이브가 마운트되어 있는지 확인하세요. 저장소 > 공유 폴더 에서 해당 드라이브에 작문 파일, Plex 앱 데이터, 미디어 폴더를 만들고 그 안에 Movies, TV, 또는 와 같은 하위 폴더를 생성하세요 Music. 가능하면 Plex 데이터를 시스템 드라이브에 저장하지 마세요. Plex 계정에 미디어 폴더에 대한 읽기 권한을 부여하고 계정의 숫자 사용자 ID(UID)와 그룹 ID(GID)를 기록해 두세요. DHCP 예약을 사용하면 NAS 주소를 안정적으로 유지할 수 있습니다.

OpenMediaVault에 Plex를 설치하세요

1. OMV-Extras가 설치되어 있지 않으면 설치하십시오.

OMV-Extras는 Compose 플러그인용 저장소를 제공합니다. 루트 권한으로 NAS에 SSH로 접속하거나, 명령어를 사용하여 루트 셸로 전환한 sudo -i다음, 현재 설치 프로그램을 실행하십시오.

wget -O - https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install | bash

스크립트 실행이 완료되면 OMV를 다시 로드하십시오. 오류가 발생하면 OMV-Extras 공식 설치 가이드를 참조하십시오 .

2. Docker를 활성화하고 Compose 플러그인을 설치합니다.

시스템 > OMV-Extras를 열고 Docker Repo를 활성화한 다음 저장을 클릭합니다 . 시스템 > 플러그인openmediavault-compose 에서 사용 중인 OMV 버전에 맞는 패키지를 선택 하고 설치를 클릭합니다 . 설치를 확인하고 완료될 때까지 기다립니다.

3. Compose 저장소를 데이터 드라이브에 지정합니다.

서비스 > Compose > 설정 에서 Compose 파일 및 데이터 에 대해 공유 폴더를 선택합니다 . Docker 스토리지를 심볼릭 링크나 mergerfs 풀이 아닌 적절한 로컬 파일 시스템의 절대 경로로 설정합니다. 설정을 저장하고 적용합니다.

4. Plex Compose 파일 생성

서비스 > 컴포즈 > 파일 에서 추가를 클릭하고 프로젝트 이름을 지정한 plex다음 이 컴포즈 정의를 붙여넣으세요. 샘플 경로와 UID/GID는 OMV 시스템의 값으로 바꾸세요.

services:
  plex:
    image: plexinc/pms-docker:latest
    container_name: plex
    network_mode: host
    restart: unless-stopped
    environment:
      - TZ=Etc/UTC
      - PLEX_UID=1000
      - PLEX_GID=100
      # Optional for first setup: replace with a fresh claim token
      # - PLEX_CLAIM=claim-REPLACE-ME
    volumes:
      - /srv/dev-disk-by-uuid-REPLACE-ME/appdata/plex/config:/config
      - /srv/dev-disk-by-uuid-REPLACE-ME/appdata/plex/transcode:/transcode
      - /srv/dev-disk-by-uuid-REPLACE-ME/media:/data:ro

/config이 영역에는 Plex 설정과 라이브러리 데이터베이스가 저장되며, /transcode임시 공간으로 사용됩니다. 읽기 전용 /data마운트를 사용하면 미디어 파일이 노출됩니다. TZ로컬 영역을 사용하려면 이 값을 변경하세요. 선택 사항인 값은 plex.tv/claimPLEX_CLAIM 에서 가져올 수 있습니다 . 처음 실행하기 전에 새 토큰을 추가하고, 서버 소유권이 확보되면 토큰을 제거하세요.

파일을 저장하고, plex파일 목록에서 선택한 다음, [ 위로]를 클릭하여 컨테이너를 시작하세요.

5. Plex 웹 브라우저를 열고 서버를 등록하세요.

동일 네트워크에 연결된 컴퓨터에서 http://<OMV-IP-address>:32400/webNAS 주소를 입력하고 로그인한 후, 안내에 따라 서버 이름을 지정하세요. 초기 설정 화면이 나타나지 않으면 Plex 공식 설치 지침을 참조하여 초기 접속을 진행하세요.

6. 컨테이너 경로를 사용하여 라이브러리를 추가합니다.

Plex 웹에서 라이브러리를 추가하고 컨테이너 내 경로(예: /data/Movies또는 ) 를 선택합니다 /data/TV. 호스트 /srv/dev-disk-by-uuid-...경로는 Plex에 표시되지 않습니다. 각 미디어 유형을 추가하고 Plex가 스캔하도록 합니다.

7. 접근 권한을 확인하고 설정을 유지 관리하기 쉽게 유지하세요.

라이브러리를 열고 홈 네트워크에 연결된 기기에서 재생을 테스트해 보세요. 호스트 네트워킹을 사용하는 경우 Plex는 OMV 주소와 TCP 포트를 사용합니다 . 로컬 재생에는 라우터 포트 포워딩이 필요하지 않습니다. 필요한 경우에만 Plex의 포트 안내에32400 따라 원격 액세스를 설정하세요 .

라이브러리가 비어 있거나 서버에 연결할 수 없는 경우 문제 해결

• Plex 웹이 로드되지 않습니다. Compose 프로젝트가 실행 중인지, 올바른 NAS IP 주소를 사용하고 있는지, TCP 연결이 32400가능한지 확인하십시오.
• 폴더 선택기가 비어 있습니다. 매핑된 호스트 경로를 확인하고 구성된 Plex UID/GID에 미디어 폴더 및 상위 폴더에 대한 읽기 및 탐색 권한을 부여하십시오.
• 재시작 후 설정이 사라집니다. 영구 저장소에 보관하세요 /config. 해당 저장소에는 Plex 서버 데이터가 포함되어 있습니다.

Compose 플러그인을 통해 업데이트하고 Compose 파일과 영구 /config폴더를 백업하세요. 기존 OMV 3 패키지 및 Plexmediaserver-repository 관련 지침은 더 이상 사용되지 않습니다. 고급 옵션은 Plex 컨테이너 문서 및 OMV 8 Docker 가이드를 참조하세요 .