Читання попередніх застосунків

Прочитай налаштування попереднього застосунку, через сам застосунок або з його бекапу, як крок 1 перенесення. Читання нічого не змінює ні в HolyArrs, ні в попередньому застосунку.

Read (прочитане) — це копія налаштувань одного застосунку в HolyArrs. Вона зберігається, доки ти не перенесеш її або не прибереш.

Прочитати застосунок

1. Відкрий Settings > Move from other apps (налаштування > перехід з інших застосунків) і натисни Add an app (додати застосунок).
2. Обери застосунок, потім Through the app (через застосунок) або From a backup (з бекапу).
3. Натисни Check connection (перевірити з’єднання). Ти маєш побачити застосунок і версію за кілька секунд.
4. Запусти читання. Велика бібліотека читається кілька хвилин. Stop reading (зупинити читання) зупиняє його; закриття вікна не зупиняє.
5. Ти маєш побачити прочитане в списку. Додай наступний застосунок так само.

Edit (змінити) у рядку читає цей застосунок знову. Remove (прибрати) викидає прочитане.

Варіанти

Через застосунок

Введи адресу застосунку й API-ключ. Для qBittorrent введи ім’я користувача й пароль або його API-ключ, якщо версія 5.2 чи новіша.

Попередні застосунки зазвичай працюють у твоїй домашній мережі, тож увімкни для читання перемикач локальної мережі. Адреси метаданих хмари залишаються заблокованими, і застосунок не може перенаправити HolyArrs на іншу адресу.

З бекапу

Введи повний шлях на сервері HolyArrs до одного з цього:

• zip-бекап з Radarr, Sonarr, Lidarr, Prowlarr або Bazarr,
• тека конфігурації Seerr, Overseerr, qBittorrent або SABnzbd,
• один файл бази даних або налаштувань.

Читання з бекапу не зберігає жодного ключа.

Що читається

Застосунок	Що читається
Radarr, Sonarr, Lidarr	Кожен фільм, серіал (із сезонами) або виконавець: id, тека, позначка стеження, профіль якості, теги, дата додавання. Також теки бібліотеки, теги, профілі якості, власні формати, правила за словами в релізах, правила очікування, іменування, індексери, клієнти завантаження, списки, сповіщення, записувачі метаданих, винятки, мовні профілі (Sonarr v3), профілі метаданих (Lidarr) і затримка доступності Radarr.
Prowlarr	Індексери, підключення застосунків, профілі синхронізації, проксі індексерів, клієнти завантаження, сповіщення.
Bazarr	Увімкнені мови, мовні профілі, увімкнені сайти субтитрів, типові профілі.
qBittorrent, SABnzbd	Адреса, порт, ім’я користувача, теки завантажень, категорії та (SABnzbd) Usenet-сервери.
Seerr, Overseerr	Люди (ім’я, електронна пошта, роль, права, ліміти запитів), типові ліміти та кожен запит, що очікує або схвалений: хто запросив, коли, що саме. Завершені й відхилені запити лише рахуються. Аватари не читаються.

Читати більше, ніж переноситься, — це навмисно: усе прочитане, але не перенесене, показується в списку not moved (не перенесено) з причиною.

Ключі й паролі

Прочитане ніколи не містить ключа, пароля, токена чи cookie, навіть якщо в бекапі вони лежать відкритим текстом. Кожен перелічено в needs re-entry (потрібно ввести знову), наприклад indexer "Nyaa": apiKey.

Посилання вважаються секретами, бо в них ховаються токени. Посилання сповіщень, адреси стрічок RSS і довільні додаткові параметри залишаються і перелічуються. Адреса індексера зберігає лише хост і шлях API.

Ключ, який ти ввів

Коли власник читає застосунок із введеним ключем, HolyArrs зберігає цю адресу й ключ у своєму зашифрованому сховищі. Наступного разу Edit читає знову з увімкненим Use the saved key (використати збережений ключ), і ключ іде лише на збережену адресу. HolyArrs ніколи його не показує.

Збережений ключ видаляється, коли
ти прибираєш прочитане для цього застосунку
перенесення завершується без помилок (пункт, що не вдався, зберігає ключі, тож можна перенести знову)
ти виконуєш holyarrs import-secrets -forget-move-credentials

Хто може читати

Власник і адміни, які увійшли з паролем. Пропуск входу в локальній мережі не враховується. API-ключу потрібна область admin.

Якщо не працює

Ознака	Причина	Рішення
Check connection не вдається	Адресу перевіряє сервер HolyArrs.	Використай адресу, яку бачить сервер. Для застосунку в домашній мережі увімкни перемикач локальної мережі.
Ключ неправильний	Помилка копіювання, або qBittorrent потребує імені користувача.	Скопіюй ключ знову з налаштувань попереднього застосунку.
Бекап відхилено	Zip змінили, або шлях поза контейнером.	Використай власний zip-бекап застосунку, без змін, за його шляхом усередині контейнера HolyArrs.
Прочитане завелике	Ліміти на одне читання й на сервер.	Прибери старе прочитане, яке тобі більше не потрібне.

Для досвідчених

Обробка бекапів і ліміти

Правило	Значення
Скопійовані файли	Лише потрібні, у приватну тимчасову теку, яку видаляють після читання.
Розмір одного скопійованого файлу	Не більше 1 GB.
config.xml застосунку arr	Ніколи не копіюється; у ньому API-ключ.
База даних	Відкривається лише для читання.
Відхиляється повністю, коли	запис вказує поза zip, містить посилання, або файл розпаковується значно більшим за свій розмір.
Бекапів одночасно	1.
Зберігається на одне читання	16 MB.
Зберігається прочитаного	50 найновіших.

API

Маршрут	Що робить
POST /api/v1/migrate/probe	Каже, який застосунок і яка версія відповідає, або що це за бекап.
POST /api/v1/migrate/read	Читає всі налаштування й зберігає їх.
GET /api/v1/migrate/snapshots	Перелічує прочитане, найновіше першим.
GET /api/v1/migrate/snapshots/{id}	Одне прочитане з усім, що воно містить.
DELETE /api/v1/migrate/snapshots/{id}	Прибирає прочитане та ключ, збережений для цього застосунку.
GET /api/v1/migrate/saved-keys	Застосунки зі збереженим ключем та їхні адреси, але ніколи не сам ключ. Лише власник.
DELETE /api/v1/migrate/saved-keys	Видаляє всі збережені ключі або один через ?kind=. Лише власник.

Тіло probe і read називає застосунок: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent або sabnzbd. Додай url з key (або username і password), або path. Додай allow_local_network, щоб дістатися до домашньої мережі, і use_saved_key, щоб використати збережений ключ.

Пов’язане

• Перехід з інших застосунків
• Імпорт ключів із файлу