從其他 App 匯入

把舊的 App 的設定帶進 HolyArrs，不用再輸入一次。

HolyArrs 只會讀取舊的 App。舊 App 裡的東西不會有任何變動，你的媒體檔案也不會移動。

開始之前

• 以擁有者或管理員登入。
• 準備好每個舊 App 的位址和 API 金鑰。
• 確認 HolyArrs 看得到你的媒體資料夾。請見資料夾與硬連結。

匯入你的設定

1. 開啟 Settings > Import from other apps（設定 > 從其他 App 匯入）。頂端會看到一排共四個步驟。
2. Read your apps（讀取你的 App）：每個舊的 App 都按下 Add an app（新增 App）。每個 App 會列出來，旁邊有一個開關。
3. What to import（要匯入的內容）：開啟你想帶過來的項目群組。
4. Import（匯入）：HolyArrs 會先檢查會新增哪些東西。這一步還不會變更任何東西。回答 Needs a choice（需要選擇）底下的每一列，然後按下 Import 並確認。執行期間你可以離開這個頁面。
5. Done（完成）：你會看到每個群組的結果，以及 Undo this import（復原這次匯入）。

金鑰和密碼不會一起過來。請見匯入之後。

建議的順序

順序	App	為什麼是這個順序
1	Radarr、Sonarr	先有媒體庫資料夾和作品。請見 Sonarr 與 Radarr。
2	Lidarr、Prowlarr、Bazarr	音樂、來源和字幕語言。請見 Lidarr、Bazarr 與 Prowlarr。
3	qBittorrent、SABnzbd	下載器。和上面的 App 在同一次匯入中一起讀取。
4	Seerr、Overseerr	使用者和請求，會對應到已經在這裡的作品。請見請求用的 App。

你可以先讀取所有 App，再一次全部匯入。只有分批匯入時，順序才有影響。

匯入之後

下面每個項目過來時都是暫停或關閉的狀態。輸入它的機密資料、檢查一下，再開啟。

項目	位置	要做什麼
來源	Settings > Sources	輸入金鑰，然後繼續。
下載器	Settings > Downloaders	輸入密碼或金鑰，然後繼續。
通知	Settings > Alerts	輸入連結或 email 密碼，然後開啟。
外部清單	Settings > Outside lists	檢查資料夾和挑選規則，然後開啟。Trakt 清單要先有你的 Trakt 金鑰。
使用者	Settings > Users and roles	寄出邀請。

在舊 App 裡有 tag 的來源、下載器或通知，現在會套用到同類型的每一個作品。開啟之前請先檢查。

來源和下載器過來時，May reach the local network（可連到區域網路）是關閉的。只有位在你家用網路上的才需要開啟。無論如何，link-local 位址和雲端 metadata 位址都會保持封鎖。

要一次輸入很多金鑰，請見從檔案匯入金鑰。

不會帶過來的東西

• 媒體檔案。 匯入絕不會移動、重新命名、複製或刪除任何檔案。
• 金鑰、密碼、token 和 cookie。 「匯入」步驟和報告都會把它們列在 Keys to type again（需要重新輸入的金鑰）底下。
• 這裡沒有對應項目的設定。 每一項都會連同原因列在 not imported（未匯入）清單中。
• 歷史記錄。 舊 App 的歷史記錄不會讀取。不過當初請求作品的人會一併過來。

如果沒有成功

症狀	原因	解決方式
作品顯示找不到	它們的資料夾和這裡的媒體庫資料夾對不上。	在 What to import 的 Advanced（進階）底下新增路徑規則，然後再匯入一次。
匯入說有東西變了	檢查之後有東西變了。	HolyArrs 會自己再檢查一次。看過清單後再匯入。
Import 按鈕是灰色的	有人需要你做選擇，或 HolyArrs 處於安全模式。	讀一下按鈕旁邊的文字。
有些項目失敗	例如中繼資料伺服器當時停擺。	等一下，再匯入一次。你的舊 App 金鑰仍會保留。

給進階使用者

重新匯入、復原、功能區塊與安全模式

重新匯入。 匯入會記住自己新增了什麼。再匯入一次時只會新增新的項目，其餘的標示為 already here（已存在）。同一時間只會執行一次匯入或復原。如果 HolyArrs 在匯入途中停止，下次啟動時這次匯入會標示為失敗；如果它的工作還在佇列中，則會繼續執行。它絕不會擋住下一次匯入。

Earlier imports（先前的匯入）在各個讀取結果下方，列出每一次匯入和它的狀態。Open 會開啟處於第 4 步的匯入；執行中則是第 3 步。

復原。 在第 4 步按下 Undo this import（較舊的匯入要先 Open 開啟）。復原會在背景執行，只移除該次匯入新增的東西，從最新的開始：

• 作品會從媒體庫移除；它們的檔案維持原位，
• 它新增的來源、下載器、通知、字幕網站、使用者、請求和永不加入清單項目都會移除，
• 它新增的外部清單，在仍處於暫停時會移除，
• 命名、預設字幕語言，以及挑選規則上的等待時間，會恢復成原本的樣子。

匯入之後你設定或變更過的東西會保留，復原報告會列出來：你輸入的機密資料、你開啟的使用者或外部清單、你變更的命名、語言或等待時間。放過作品的媒體庫資料夾也會保留，因為被移除的作品仍保有自己的歷史記錄。

功能區塊。 關閉的功能區塊會略過。電影關閉：沒有電影資料夾、電影或外部清單。字幕關閉：沒有字幕設定。請求關閉：沒有請求。

安全模式。 你可以讀取你的 App 並挑選要匯入的內容，但不能匯入或復原。

API

API 金鑰需要 admin 範圍。

路由	功能
POST /api/v1/migrate/plan	針對所選的讀取結果產生計畫，附上數量和建議的路徑規則。
POST /api/v1/migrate/dry-run	試跑報告和它的 plan_hash。不會變更任何東西。需要你做選擇的使用者，其 choose 會設為 same_name、numeric_id 或 merge_gone。
POST /api/v1/migrate/moves	開始匯入。需要試跑的 plan_hash。計畫變更時回應 409。
GET /api/v1/migrate/moves	列出匯入，最新的在前。
GET /api/v1/migrate/moves/{id}	一次匯入、它的報告和進度。
GET /api/v1/migrate/moves/{id}/report	以 Markdown 檔案提供的報告。
POST /api/v1/migrate/moves/{id}/undo	把復原排入佇列（202）。之後用 GET /api/v1/migrate/moves/{id} 追蹤。

plan、dry-run 和 moves 的 body（moves 另外還要帶 "plan_hash"）：

{
  "snapshots": [1, 2],
  "path_rules": [{"from": "/data/media/movies", "to": "/movies"}],
  "skip": ["alerts"],
  "people": {"person:seerr:1": "owner", "person:seerr:3": "admin", "person:seerr:2": "merge"}
}

使用者的選擇可以是 owner（只限舊 App 的擁有者）、admin、merge 或 skip。可以略過的群組：folders、pick_rules、titles、never_add、outside_lists、sources、downloaders、naming、subtitles、people、wishlist、alerts。

本區的頁面

頁面	用途
Sonarr 與 Radarr	帶過來資料夾、影集、電影和它們的規則。請先做這一個。
Lidarr、Bazarr 與 Prowlarr	帶過來音樂、字幕語言和來源。
Seerr 與 Overseerr	帶過來使用者和未完成的請求。
讀取你的舊 App	查看 HolyArrs 讀取和保留了哪些東西。
從檔案匯入金鑰	一次輸入很多金鑰。

相關頁面

• 首次執行
• 詞彙表