跳到內容

外部位址

進階

這一頁列出 HolyArrs 自己會連到的每一個外部位址。如果你的防火牆預設會擋下對外流量,可以用它來設定。

你自己的服務不在清單裡:來源、下載器、媒體伺服器、通知 App、字幕網站、single sign-on 提供者,以及你匯入來源的舊 App。HolyArrs 只會連到你設定的位址。

下面每個位址都使用 port 443 上的 HTTPS。HolyArrs 也需要 DNS。

位址 api.holyarrs.com
用途 作品、影集和音樂的查詢、排行榜、預告片清單、評分、Wikipedia 詳細資料、動畫集數對照、額外的美術圖片,以及 TMDB 查詢(除非你設定了自己的 TMDB 金鑰)
時機 第一次啟動時(取得安裝 token),之後只要有頁面或工作要查詢就會連
關閉方式 無法關閉。沒有它,搜尋和新的詳細資料會停止;你的媒體庫和下載仍會繼續運作
改指向別處 HOLYARRS_METADATA_URL。變更後請重新啟動

holyarrs-api.coderluii.dev 是這個伺服器的舊位址。HolyArrs 仍會載入存在這個位址下的圖片,但只限 HOLYARRS_METADATA_URL 未設定時。它會一直回應到第 2 版。

安裝會送出什麼,列在 Metadata。如果不想讓你的安裝計入安裝數,到 Settings > This app(設定 > 此 App)關閉 Count this install(計入此安裝)。

位址 用途 時機 關閉或變更方式
image.tmdb.org 海報和背景圖 第一次儲存圖片時,以及讓已儲存的圖片保持最新 一律開啟。如果連不上,圖片會改經由 metadata 伺服器取得
api.themoviedb.org 電影、影集、人物和探索的查詢,以及 TMDB 清單 只有設定了 HOLYARRS_TMDB_KEY 時 取消設定金鑰,就會改用 metadata 伺服器
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 都經由 metadata 伺服器。你的安裝不會自己連到它們。完全不會連到 TheTVDB;TVDB id 來自 TMDB 和 TVmaze。

你自己的 TMDB 金鑰和 metadata 伺服器

連結到「你自己的 TMDB 金鑰和 metadata 伺服器」

把 HOLYARRS_TMDB_KEY 設成你自己的 TMDB 讀取存取 token。log 接著會顯示 metadata: TMDB directly with the key from the environment。

直接送到 TMDB 仍然經由 metadata 伺服器
電影和影集的詳細資料、搜尋、人物和探索清單 TVmaze 的影集詳細資料和播出時間
你追蹤的 TMDB 清單 所有音樂查詢、排行榜和藝人圖片
預告片清單、評分、Wikipedia 詳細資料、動畫對照和額外的美術圖片
連不上 image.tmdb.org 時的 TMDB 圖片

所以設定了 TMDB 金鑰後,安裝仍然會向 metadata 伺服器註冊,也仍然需要它。兩者之間沒有備援:設定了金鑰,TMDB 查詢就絕不會送到伺服器;沒有設定,就絕不會送到 TMDB。

HOLYARRS_METADATA_URL 會把右欄的所有項目移到另一個伺服器。另一個伺服器必須用和 api.holyarrs.com 相同的方式回應。在你區域網路上的伺服器,還需要 HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL=true。

HOLYARRS_METADATA_SERVICE_TOKEN_FILE 會從檔案讀取安裝 token,而不是從保管庫讀取。

載入 image.tmdb.org、i.ytimg.com、upload.wikimedia.org 和 static.tvmaze.com 的圖片和影片、從 *.googlevideo.com 播放預告片,以及從 www.youtube-nocookie.com 顯示隱私強化播放器的,可能是你的瀏覽器,而不是 HolyArrs 伺服器。伺服器前面的防火牆不會影響這些。

HolyArrs 是免費的。如果它幫你省下了時間,歡迎在 GitHub 上給顆星、贊助專案,或請我喝杯咖啡。