외부 주소

이 페이지는 HolyArrs가 스스로 접속하는 모든 외부 주소를 나열합니다. 나가는 트래픽을 기본으로 막는 방화벽을 설정할 때 쓰세요.

직접 운영하는 서비스는 나열하지 않습니다. 소스, 다운로더, 미디어 서버, 알림 앱, 자막 사이트, 통합 로그인 공급자, 가져오는 기존 앱이 그렇습니다. HolyArrs는 이런 곳에 사용자가 지정한 주소로만 접속합니다.

아래의 모든 주소는 443 포트의 HTTPS를 씁니다. HolyArrs에는 DNS도 필요합니다.

메타데이터 서버

주소	api.holyarrs.com
용도	작품, 시리즈, 음악 조회, 차트, 예고편 목록, 평점, Wikipedia 정보, 애니메이션 에피소드 지도, 추가 이미지, 그리고 직접 발급받은 TMDB 키를 설정하지 않았을 때의 TMDB 조회
시점	처음 시작할 때(설치 토큰을 받기 위해), 그 뒤로는 페이지나 작업이 무언가를 조회할 때마다
끄기	불가능합니다. 이 서버가 없으면 검색과 새 정보 가져오기가 멈추지만, 라이브러리와 다운로드는 계속 작동합니다
다른 곳으로 돌리기	HOLYARRS_METADATA_URL. 바꾼 뒤 재시작하세요

holyarrs-api.coderluii.dev는 이 서버의 옛 주소입니다. HolyArrs는 그 주소로 저장된 이미지를 계속 불러오지만, HOLYARRS_METADATA_URL을 설정하지 않았을 때만 그렇습니다. 이 주소는 2 버전까지 응답합니다.

설치가 보내는 내용은 메타데이터에 나와 있습니다. 설치 수 집계에서 빠지려면 Settings > This app(설정 > 이 앱)에서 Count this install(이 설치를 집계에 포함)을 끄세요.

그 밖의 주소

주소	용도	시점	끄기 또는 변경
image.tmdb.org	포스터와 배경 이미지	이미지를 처음 저장할 때, 그리고 저장된 이미지를 최신으로 유지할 때	항상 켜져 있습니다. 접속할 수 없으면 이미지는 메타데이터 서버를 거쳐 옵니다
api.themoviedb.org	영화, 시리즈, 인물, 둘러보기 조회와 TMDB 목록	HOLYARRS_TMDB_KEY를 설정했을 때만	키를 지우면 메타데이터 서버를 대신 씁니다
www.youtube.com	예고편의 영상 주소를 읽습니다. 아무것도 다운로드하지 않고 로그인하지도 않습니다	예고편 조회 주기, 5분마다	Settings > Appearance(설정 > 모양)에서 Play trailers by themselves(예고편 자동 재생)를 끄세요
*.googlevideo.com	예고편 스트림을 저장하지 않고 브라우저로 전달합니다	브라우저가 스트림을 직접 재생할 수 없거나 소리 때문에 필요할 때만	위와 같은 스위치
api.github.com	업데이트 확인: 가장 새로운 HolyArrs 릴리스	기본값은 하루에 한 번	Settings > Health checks(설정 > 상태 점검)에서 Check for a newer HolyArrs(새 HolyArrs 확인)를 끄거나 직접 Release feed(릴리스 피드)를 지정하세요. 업데이트를 참고하세요
api.github.com, raw.githubusercontent.com	TRaSH Guides 프로필	TRaSH Guides 프로필을 고르거나 동기화할 때만	TRaSH Guides 점수를 쓰지 마세요
plex.tv, app.plex.tv	Plex로 로그인	누군가 Plex로 로그인할 때만	Plex 로그인을 쓰지 마세요
discover.provider.plex.tv	Plex 워치리스트	Plex 워치리스트를 켰을 때만	Plex 워치리스트를 끄세요
api.trakt.tv	Trakt 목록과 Trakt 리뷰	trakt_lists 스위치를 켜고 Trakt 키를 저장했을 때만	스위치를 꺼 두세요. 보류된 기능을 참고하세요

음악 조회(MusicBrainz, Deezer, Wikipedia)와 TVmaze는 메타데이터 서버를 거칩니다. 설치가 이들에 직접 접속하지는 않습니다. TheTVDB에는 전혀 접속하지 않으며, TVDB ID는 TMDB와 TVmaze에서 가져옵니다.

직접 발급받은 TMDB 키와 메타데이터 서버

HOLYARRS_TMDB_KEY를 직접 발급받은 TMDB 읽기 액세스 토큰으로 설정하세요. 그러면 로그에 metadata: TMDB directly with the key from the environment가 표시됩니다.

TMDB로 바로 가는 것	여전히 메타데이터 서버를 거치는 것
영화와 시리즈 정보, 검색, 인물과 둘러보기 목록	TVmaze 시리즈 정보와 방영 시간
팔로우하는 TMDB 목록	모든 음악 조회, 차트, 아티스트 이미지
	예고편 목록, 평점, Wikipedia 정보, 애니메이션 지도, 추가 이미지
	image.tmdb.org에 접속할 수 없을 때의 TMDB 이미지

따라서 TMDB 키를 설정해도 설치는 여전히 메타데이터 서버에 등록하고 그 서버가 필요합니다. 둘 사이에는 대체 경로가 없습니다. 키를 설정하면 TMDB 조회는 서버로 가지 않고, 설정하지 않으면 TMDB로 가지 않습니다.

HOLYARRS_METADATA_URL은 오른쪽 열의 모든 것을 다른 서버로 옮깁니다. 그 서버는 api.holyarrs.com과 같은 방식으로 응답해야 합니다. 로컬 네트워크의 서버에는 HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL=true도 필요합니다.

HOLYARRS_METADATA_SERVICE_TOKEN_FILE은 설치 토큰을 금고 대신 파일에서 읽습니다.

브라우저의 이미지

HolyArrs 서버가 아니라 사용자의 브라우저가 image.tmdb.org, i.ytimg.com, upload.wikimedia.org, static.tvmaze.com에서 이미지와 영상을 불러오고, *.googlevideo.com에서 예고편을 재생하고, www.youtube-nocookie.com의 개인정보 보호 강화 플레이어를 표시할 수 있습니다. 서버 앞의 방화벽은 이 요청에 영향을 주지 않습니다.

관련 문서

• 메타데이터
• 환경 변수
• 업데이트
• 예고편