파트와 안전 모드

설정

쓰지 않는 파트는 끄고, 문제가 생기면 안전 모드로 시작하고, 브라우저에서 HolyArrs를 재시작하세요.

파트 켜고 끄기

HolyArrs에는 파트가 5개 있습니다: Movies(영화), TV shows(TV 시리즈), Music(음악), Subtitles(자막), Requests(요청). 처음에는 첫 실행 마법사에서 고릅니다.

Settings > Parts(설정 > 파트)를 여세요.
파트 옆의 Turn on(켜기) 또는 Turn off(끄기)를 클릭하세요. 해당 메뉴 항목이 나타나거나 사라집니다.

삭제되는 것은 없습니다. 파트를 다시 켜면 멈췄던 곳에서 이어집니다.

안전 모드로 시작하기

안전 모드는 기본 기능만 시작합니다. 무언가 때문에 HolyArrs가 시작되지 않거나 제대로 작동하지 않을 때 씁니다. 로그인하고, 라이브러리를 보고, 설정을 바꾸고, 백업을 만들거나 복원할 수 있습니다. 검색, 추가, 새로 고침, 다운로드, 가져오기는 다음 정상 시작까지 기다립니다.

Settings > Danger zone(설정 > 위험 구역)을 여세요.
Restart in safe mode(안전 모드로 재시작)를 클릭하세요. 모든 페이지에 배너가 표시됩니다.
문제를 해결한 뒤 Restart HolyArrs(HolyArrs 재시작)를 클릭하세요. 다음 시작은 정상 시작입니다.

페이지에 접속할 수 없다면 Compose에서 HOLYARRS_SAFE_MODE=1을 설정하거나 -safe-mode로 시작하세요. 해결한 뒤에는 지우세요. 둘 다 남겨 두면 매번 안전 모드로 시작합니다.

선택 사항

파트를 끄면 멈추는 것

파트	멈추는 것	계속되는 것
영화	영화 페이지와 메뉴 항목, 추가, 검색, 새로 고침	이미 다운로더에 있는 다운로드는 계속 추적합니다. 파일은 남습니다.
TV 시리즈	시리즈 페이지, 추가, 검색, 시즌 검색, 새로 고침	영화와 같습니다.
음악	아티스트와 앨범 페이지, 음악 설정, 아티스트 새로 고침, 앨범 검색	영화와 같습니다.
자막	자막 설정, 누락된 자막 페이지, 검색과 확인	동영상 옆의 자막 파일은 남습니다.
요청	요청 페이지와 작품 요청하기	기존 요청은 남아 있다가 다시 켜면 돌아옵니다.

항상 켜져 있는 것: 로그인과 계정, 라이브러리 폴더, 소스, 다운로더와 다운로드, 알림, 기록, 백업, 상태 점검, 설정, API.

자막에는 영화나 TV 시리즈가 필요합니다. 요청에는 영화, TV 시리즈, 음악 중 하나가 필요합니다. HolyArrs는 이 조건을 깨는 변경을 거부하고 무엇을 먼저 바꿔야 하는지 알려 줍니다.
꺼진 파트의 대기 중인 작업은 기다렸다가 파트가 켜지면 실행됩니다.
파트를 꺼도 메모리가 줄지는 않습니다. 모든 것이 한 프로그램 안에서 실행됩니다.

재시작, 일시 중지, 종료

Settings > Danger zone(소유자와 관리자)에는 Restart HolyArrs, Restart in safe mode, Shut down(종료)이 있고, 백업이나 다운로드 동기화 같은 백그라운드 작업마다 Pause(일시 중지), Resume(재개), Restart(재시작)가 있습니다.

무언가를 멈추는 버튼은 60 s 안에 확인하도록 묻습니다.
사용한 버튼은 모두 사용자 이름과 함께 기록에 남습니다.
비밀번호 로그인이 필요합니다. 로컬 네트워크의 비밀번호 없는 로그인은 거부됩니다.

재시작은 HolyArrs를 깔끔하게 중지하고 Docker가 다시 시작하게 맡깁니다. 그러니 restart: unless-stopped를 설정하세요.

재시작 정책	재시작	종료
`unless-stopped` 또는 `always`	다시 올라옵니다	역시 다시 올라옵니다
`on-failure`	다시 올라옵니다	꺼진 채로 있습니다
`no`	꺼진 채로 있습니다	꺼진 채로 있습니다

문제가 생기면

증상	원인	해결
HolyArrs가 파트를 끄지 못합니다	다른 파트가 그 파트를 필요로 합니다	메시지에 나온 대로 그 파트를 먼저 끄세요.
재시작했더니 HolyArrs가 완전히 꺼졌습니다	재시작 정책이 `no`입니다	컨테이너를 시작하고 `restart: unless-stopped`를 설정하세요.
버튼이 거부됩니다	비밀번호 없는 로컬 로그인이거나 키에 `control`이 없습니다	비밀번호로 로그인하세요.
작업이 계속 실패 상태입니다	직접 조치가 필요합니다	`/health`에서 이유를 읽고 해결한 뒤 해당 작업의 Restart를 클릭하세요.

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

전문가용

상태

/health, Settings > Parts, GET /api/v1/health/states는 각 백그라운드 작업, 파트, 연동된 앱을 상태와 이유와 함께 보여 줍니다.

상태	의미
off	꺼졌거나, 일시 중지됐거나, 안전 모드라서 시작되지 않았습니다.
starting	시작하는 중이거나 아직 점검되지 않았습니다.
running	작동합니다.
retrying	실패했습니다. HolyArrs가 매번 더 오래 기다리면서 다시 시도합니다.
failed	중단됐거나, 멈춰 있거나, 직접 조치가 필요합니다. 이유에 할 일이 나옵니다.

중단된 작업은 failed, 그다음 retrying으로 표시되고 다시 시작됩니다. 그동안에도 로그인, 라이브러리, 백업은 계속 작동합니다. 멈춰 있는 작업은 완전히 재시작하면 풀립니다.

메모리와 저메모리 모드

HolyArrs는 384 MiB 아래로 유지하는 것을 목표로 하며, 이는 500 MB 컨테이너 제한에 들어맞습니다. 목표를 직접 정하려면 GOMEMLIMIT을 컨테이너 메모리의 약 80퍼센트로 설정하세요.

저메모리 모드는 메모리에 덜 올려 두고 데이터베이스에서 더 많이 읽습니다. 일부 페이지는 조금 더 걸리고, 음악 카탈로그 복사 같은 백그라운드 작업은 덜 자주 실행됩니다.

설정	효과
(기본값, Linux)	메모리가 약 2.5 GiB 이하이면 저절로 켜집니다.
`HOLYARRS_LOW_MEMORY=1`	항상 켜짐.
`HOLYARRS_LOW_MEMORY=0`	항상 꺼짐.

로그 첫 줄에 켜져 있는지와 그 이유가 나옵니다.

API 키 범위

Settings > API > API keys(설정 > API > API 키)에서 키를 만들고 X-Api-Key 헤더에 넣어 보내세요.

범위	접근 대상
`read`	라이브러리, 작업, 다운로드, 기록, 상태, 설정. 비밀 값은 가려집니다.
`health_read`	상태만. 모니터링 도구용입니다.
`write`	관리자 경로와 조작 버튼을 뺀 모든 변경.
`admin`	사람, 초대, 요청 한도, API 키, 비밀번호와 2단계 인증, 로그인 설정, 백업.
`control`	이 페이지의 조작 버튼. 소유자와 관리자만 부여할 수 있습니다.
`all`	`read`, `write`, `admin`. `control`은 아닙니다.

키는 만든 사람이 할 수 있는 것 이상을 할 수 없습니다. 범위는 나중에 바꿀 수 없으니 새 키를 만드세요. 모든 경로와 그 범위: /api/v1/openapi.json.