NAS, Synology, Unraid

처음이라면

폴더, 소유자, 재시작 설정을 올바르게 잡아 NAS에서 HolyArrs를 실행하세요. 먼저 설치를 읽으세요.

시작하기 전에

/config는 로컬 볼륨이나 풀에 둡니다. 네트워크 공유 폴더에는 절대 두지 마세요.
미디어는 downloads, movies, tv, music이 들어 있는 공유 폴더 하나에 둡니다. 각각 마운트하거나, 하드링크를 쓰려면 상위 폴더를 한 번만 마운트하세요. 폴더를 참고하세요.

NAS 설정하기

::tab[Synology]

File Station에서 docker/holyarrs/config를 만드세요.
downloads, movies, tv, music이 들어 있는 공유 폴더 media를 하나 만드세요.
Container Manager에서 Project > Create(프로젝트 > 생성)를 열고 설치의 Compose 파일을 붙여 넣으세요.
볼륨을 /volume1/docker/holyarrs/config:/config, 그리고 /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music, /volume1/media/downloads:/downloads로 설정하세요.
PUID와 PGID를 사용할 사용자에 맞추세요. 보통 1026과 100입니다. SSH에서 id <user>로 확인하세요.
그 사용자에게 media의 읽기와 쓰기 권한을 주세요: Control Panel > Shared Folder > Edit > Permissions(제어판 > 공유 폴더 > 편집 > 권한).
Enable auto-restart(자동 재시작 활성화)에 체크하세요.
http://your-server:6262를 여세요. 첫 실행 마법사가 표시됩니다. /movies, /tv, /music을 라이브러리 폴더로 추가하세요.

::tab[Unraid]

아직 Community Applications 템플릿이 없으므로 컨테이너를 직접 추가하세요.

Docker 탭에서 HolyArrs 이미지로 컨테이너를 추가하세요.
포트 6262를 매핑하세요.
/config를 /mnt/<pool>/appdata/holyarrs 같은 풀 경로에 매핑하세요. <pool>은 풀 이름입니다. /mnt/user/appdata는 안 됩니다.
미디어 폴더를 디스크 경로나 풀 경로를 써서 /movies, /tv, /music, /downloads에 매핑하세요. 예를 들면 /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music, /mnt/<pool>/media/downloads:/downloads입니다.
PUID=99, PGID=100(Unraid의 nobody:users), UMASK=022로 설정하세요.
컨테이너의 자동 시작을 켜서 스스로 재시작하게 하세요.
http://your-server:6262를 여세요. 첫 실행 마법사가 표시됩니다.

::tab[QNAP]

Container/holyarrs/config를 만들고, downloads, movies, tv, music이 들어 있는 media 공유 폴더를 하나 만드세요.
Container Station에서 Applications > Create(애플리케이션 > 생성)를 열고 Compose 파일을 붙여 넣으세요.
/share/Container/holyarrs/config:/config, 그리고 /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music, /share/media/downloads:/downloads를 사용하세요.
PUID와 PGID를 media 공유 폴더의 소유자에 맞추세요.
재시작 정책을 unless-stopped로 설정하세요.
http://your-server:6262를 여세요. 첫 실행 마법사가 표시됩니다.

::tab[TrueNAS SCALE]

데이터세트를 2개 만드세요: apps/holyarrs-config와 media. media 안에는 downloads, movies, tv, music 폴더를 둡니다.
Apps에서 Compose 파일로 YAML 커스텀 앱을 추가하세요.
/mnt/<pool>/apps/holyarrs-config:/config, 그리고 /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music, /mnt/<pool>/media/downloads:/downloads를 사용하세요.
PUID와 PGID를 데이터세트 소유자에 맞추세요. 보통 568입니다. 데이터세트 ACL에서 그 사용자에게 쓰기 권한을 주세요.
재시작 정책을 unless-stopped로 설정하세요.
http://your-server:6262를 여세요. 첫 실행 마법사가 표시됩니다.

모든 NAS 공통: NAS 권한 화면에서 PUID 사용자에게 미디어 폴더의 읽기와 쓰기 권한을 주세요. 설정 폴더는 HolyArrs가 알아서 처리합니다. 컨테이너의 자동 재시작(Docker의 unless-stopped 정책)을 켜세요.

하드링크는 추가 공간을 쓰지 않고 바로 끝납니다. 하드링크를 쓰려면 네 개 대신 미디어 폴더 하나를 마운트하고, 다운로더에도 같은 마운트를 같은 경로로 주세요. 미디어 폴더를 참고하세요.

선택 사항

따로 마운트하기

/movies, /tv, /music, /downloads를 하나씩 마운트해도 작동하지만, 가져올 때마다 전체 복사가 됩니다. 컨테이너 안에서는 마운트마다 별개의 파일 시스템이고, 하드링크는 파일 시스템을 넘을 수 없습니다. 한 상위 폴더 아래에 있더라도 공유 폴더나 데이터세트가 따로면 역시 복사됩니다. HolyArrs가 복사해야 할 때는 Settings > Library folders(설정 > 라이브러리 폴더)에 경고가 나옵니다.

디스크를 쉬게 두기

다음 작업은 미디어 디스크를 깨웁니다. 실행 주기는 Schedules(일정) 페이지에서 바꾸세요.

작업	읽는 것
Rescan the Library(라이브러리 다시 스캔)	모든 라이브러리 폴더. 디스크를 가장 많이 깨웁니다.
Check Library folders(라이브러리 폴더 점검)	각 폴더의 세부 정보와 여유 공간. 쓰기와 하드링크 테스트는 시작할 때, Run now(지금 실행)를 누를 때, 폴더가 바뀔 때만 실행됩니다.
Look for missing subtitles(누락된 자막 찾기), Look for better subtitles(더 좋은 자막 찾기)	각 동영상 옆의 폴더.

/config와 다운로드 폴더는 SSD나 캐시 풀에 두세요.
/config가 있는 디스크에 1 GB의 여유 공간을 유지하세요. 그 아래로 내려가면 상태 경고가 나옵니다.
Unraid에서는 Cache Directories 플러그인이 폴더 목록을 메모리에 올려 두므로 스캔할 때 디스크를 건드리지 않습니다.
가져오기, 추가, 삭제는 실행되는 시점에 작업 대상 디스크를 건드립니다.
다시 스캔을 7일마다로 하거나 끄세요. 그러면 직접 넣은 파일은 Rescan the Library의 Run now를 눌러야만 찾습니다.
시딩 중인 토렌트는 자기 파일을 읽습니다. 그 파일이 라이브러리에 하드링크되어 있으면 시딩이 끝날 때까지 그 디스크는 깨어 있습니다.

문제가 생기면

증상	원인	해결
시작되지 않고 FUSE 경로, 네트워크 공유 폴더, Unraid 사용자 공유를 언급합니다	`/config`가 로컬 디스크에 있지 않습니다(Unraid에서는 `/mnt/user`를 가리킵니다)	`/config`를 로컬 디스크나 `/mnt/<pool>/appdata/holyarrs` 같은 풀 경로로 옮기세요.
재시작이나 복원 뒤에 중지된 채로 있습니다	자동 재시작이 꺼져 있습니다	자동 재시작을 켜고 컨테이너를 시작하세요.
가져오기가 권한 오류로 실패합니다	`PUID` 사용자가 미디어에 쓸 수 없습니다	NAS 권한 화면에서 읽기와 쓰기 권한을 주세요(Synology: Control Panel > Shared Folder > Edit > Permissions).
가져오기가 하드링크가 아니라 복사로 됩니다	다운로드와 라이브러리가 서로 다른 마운트나 디스크에 있습니다	HolyArrs와 다운로더에서 공유 폴더 하나를 한 번만 마운트하세요.

더 많은 해결 방법: 문제 해결.

전문가용

HolyArrs가 일부 설정 경로를 거부하는 이유

HolyArrs는 데이터베이스를 /config에 둡니다. 네트워크 공유 폴더와 FUSE 경로는 데이터베이스를 손상시킬 수 있어서, HolyArrs는 그런 경로에서는 시작을 거부하고 이유를 알려 줍니다.

Unraid에서 /mnt/user는 FUSE 경로입니다. 풀 경로를 쓰거나 appdata를 Exclusive로 만드세요. Settings > Global Share Settings(설정 > 전역 공유 설정)에서 Permit exclusive shares(단독 공유 허용)를 켠 다음, Shares > appdata(공유 > appdata)에서 기본 저장소를 풀 하나로, 보조 저장소를 없음으로 설정하세요.

존재하지 않는 풀의 /config 경로는 메모리에 만들어져 재부팅하면 사라집니다. HolyArrs는 이것도 거부합니다. 미디어에도 /mnt/user는 피하세요. 이 경로를 거치는 하드링크는 실패할 수 있습니다.

자동 재시작이 중요한 이유

앱에서 하는 재시작, 안전 모드, 백업 복원은 모두 HolyArrs를 중지하고 Docker가 다시 시작해 주기를 기대합니다. 자동 재시작이 없으면 중지된 채로 있습니다. 파트와 안전 모드를 참고하세요.

포트와 업데이트

포트 6262는 홈 네트워크에만 매핑하세요. 외부에 열기 전에 보안 기본 사항을 읽으세요.
업데이트하려면 새 이미지를 받고 컨테이너를 다시 만드세요. 데이터는 /config에 그대로 있습니다. 업데이트를 참고하세요.