媒體伺服器

設定

讓新的電影、影集和音樂在匯入後立刻出現在 Plex、Jellyfin 或 Emby 中。

HolyArrs 在那個資料夾匯入、重新命名或刪除檔案之後，會通知伺服器重新查看該資料夾。

開始之前

你可以從執行 HolyArrs 的電腦開啟伺服器的位址。
你有 Plex token，或是 Jellyfin 或 Emby 的 API 金鑰（在伺服器的 Dashboard、API keys 中建立）。
你知道伺服器在哪裡看到你的媒體資料夾。在 Docker 中，那就是伺服器 container 內的路徑。

新增媒體伺服器

開啟 Settings > Media servers（設定 > 媒體伺服器）。
按下 Add a media server（新增媒體伺服器）。
輸入 Name（名稱）。每個伺服器都要有自己的名稱，最多 80 個字元。
選擇 Kind（類型）：Plex、Jellyfin 或 Emby。之後無法變更。
輸入 Address（位址），要有 http 或 https，例如 Plex 用 http://192.168.1.10:32400，Jellyfin 和 Emby 用 http://192.168.1.10:8096。
貼上 Plex token，Jellyfin 和 Emby 則貼上 API key。
按下 Save（儲存），再在新的卡片上按下 Test（測試）。你應該會看到媒體庫名稱（Plex），或是伺服器名稱和版本（Jellyfin、Emby）。

選項

更新的時機（Update it after）

選擇伺服器會收到哪些變更的通知：An import（匯入）、A rename（重新命名）、A delete（刪除）。新的伺服器預設全部 3 項都開啟。只有檔案真的離開磁碟時，才算刪除。

路徑（Paths）

只有在 HolyArrs 和伺服器看到檔案的路徑不同時，才需要填寫 HolyArrs path（HolyArrs 的路徑）和 Same folder on the server（伺服器上的同一個資料夾）。如果 HolyArrs 看到的是 /movies，而伺服器看到的是 /media/movies，第一欄填 /movies，第二欄填 /media/movies。兩欄都填，或兩欄都不填。

連到區域網路（Reach the local network）

預設為開啟，因為媒體伺服器幾乎都在家裡。如果伺服器在網際網路上，請把它關閉。不論這個設定如何，HolyArrs 都絕不會呼叫 link-local 或雲端 metadata 位址。

傳送更新（Send updates）

關閉它，就能暫停某個伺服器而不必移除它。卡片會顯示 Off（關閉）。

token 或金鑰會加密儲存，而且絕不會顯示。把欄位留空就會保留原本的。變更位址之後，請再貼上一次，這樣它就絕不會被送到另一個伺服器。

確認它能運作

卡片會顯示上一次檢查或上一次的錯誤。每次更新也會記錄在歷史記錄中，顯示為 Told the media server about it（已通知媒體伺服器）或 Could not reach the media server（無法連線到媒體伺服器），並附上原因。健康檢查會列出每個伺服器及其狀態。

如果沒有成功

訊息或症狀	解決方式
“the server turned down the token”	按下 Change（變更），貼上新的 token 或金鑰
“the server did not answer”	檢查位址和 port，並確認 HolyArrs 連得到那台電腦
“the server is on the local network, which it may not reach”	開啟 Reach the local network
“the server has no movie, TV or music library”	在 Plex 中新增一個媒體庫，然後再測試一次
“type the token again when the server address changes”	再貼上一次 token 並儲存
“give both sides of the path map, or neither”	兩個路徑欄位都填，或兩個都清空
伺服器有掃描，但沒有出現新東西	路徑不同。請設定路徑對應

給進階使用者

更新如何送出

HolyArrs 會先等 10 秒，並在送出之前收集所有變更過的資料夾，所以重新命名整部影集只會送出一次更新。

伺服器	HolyArrs 送出的內容
Plex	找出包含該資料夾的電影、電視或音樂媒體庫，並且只掃描那個資料夾。如果沒有任何媒體庫包含它，就掃描該類型的每一個媒體庫
Jellyfin	已建立、已變更或已刪除的資料夾清單，然後做一次媒體庫重新整理
Emby	已建立、已變更或已刪除的資料夾清單

對伺服器的呼叫在 20 秒後逾時，Test 則在 30 秒後逾時。