Đọc các ứng dụng cũ

Đọc thiết lập của một ứng dụng cũ, qua chính ứng dụng hoặc từ bản sao lưu của nó, làm bước 1 của một lần nhập. Việc đọc không thay đổi gì trong HolyArrs hay trong ứng dụng cũ.

Một read (lần đọc) là bản sao thiết lập của một ứng dụng do HolyArrs giữ. Nó được giữ cho đến khi bạn nhập hoặc gỡ nó.

Đọc một ứng dụng

1. Mở Settings > Import from other apps (Cài đặt > Nhập từ các ứng dụng khác) và nhấn Add an app (thêm một ứng dụng).
2. Chọn ứng dụng, rồi chọn Through the app (qua ứng dụng) hoặc From a backup (từ bản sao lưu).
3. Nhấn Check connection (kiểm tra kết nối). Bạn sẽ thấy ứng dụng và phiên bản trong vài giây.
4. Bắt đầu đọc. Thư viện lớn mất vài phút. Stop reading (dừng đọc) sẽ dừng việc đọc; đóng bảng thì không.
5. Bạn sẽ thấy lần đọc trong danh sách. Thêm ứng dụng tiếp theo theo cách tương tự.

Edit (sửa) trên một dòng sẽ đọc lại ứng dụng đó. Remove (gỡ) bỏ lần đọc đi.

Lựa chọn

Qua ứng dụng

Nhập địa chỉ và khóa API của ứng dụng. Với qBittorrent, nhập tên người dùng và mật khẩu, hoặc khóa API của nó từ phiên bản 5.2 trở lên.

Các ứng dụng cũ thường nằm trong mạng ở nhà của bạn, nên hãy bật công tắc mạng nội bộ cho lần đọc. Địa chỉ metadata của đám mây vẫn bị chặn, và ứng dụng không được chuyển hướng HolyArrs sang địa chỉ khác.

Từ bản sao lưu

Nhập đường dẫn đầy đủ, trên máy chủ HolyArrs, của một trong các thứ sau:

• tệp zip sao lưu từ Radarr, Sonarr, Lidarr, Prowlarr hoặc Bazarr,
• thư mục cấu hình của Seerr, Overseerr, qBittorrent hoặc SABnzbd,
• một tệp cơ sở dữ liệu hoặc tệp cài đặt.

Đọc từ bản sao lưu không lưu khóa nào.

Những gì được đọc

Ứng dụng	Những gì được đọc
Radarr, Sonarr, Lidarr	Mọi phim lẻ, phim bộ (kèm các mùa) hoặc nghệ sĩ: id, thư mục, cờ theo dõi, hồ sơ chất lượng, thẻ, ngày thêm. Cùng với thư mục Thư viện, thẻ, hồ sơ chất lượng, custom format, quy tắc từ khóa của bản phát hành, quy tắc thời gian chờ, cách đặt tên, indexer, download client, danh sách, thông báo, trình ghi metadata, loại trừ, hồ sơ ngôn ngữ (Sonarr v3), hồ sơ metadata (Lidarr) và độ trễ khả dụng của Radarr.
Prowlarr	Indexer, liên kết ứng dụng, hồ sơ đồng bộ, proxy indexer, download client, thông báo.
Bazarr	Các ngôn ngữ đã bật, hồ sơ ngôn ngữ, các trang phụ đề đã bật, hồ sơ mặc định.
qBittorrent, SABnzbd	Địa chỉ, cổng, tên người dùng, thư mục tải xuống, danh mục và (SABnzbd) các máy chủ usenet.
Seerr, Overseerr	Người dùng (tên, email, vai trò, quyền, giới hạn yêu cầu), giới hạn mặc định, và mọi yêu cầu đang chờ hoặc đã duyệt: ai yêu cầu, khi nào, cho mục nào. Các yêu cầu đã xong và đã bị từ chối chỉ được đếm. Ảnh đại diện không được đọc.

Đọc nhiều hơn mức được nhập là có chủ ý: mọi thứ đã đọc nhưng không nhập sẽ hiện trong danh sách not imported (không nhập) kèm lý do.

Khóa và mật khẩu

Một lần đọc không bao giờ giữ khóa, mật khẩu, token hay cookie, kể cả khi bản sao lưu chứa chúng dưới dạng văn bản thường. Mỗi mục được liệt kê dưới needs re-entry (cần nhập lại), ví dụ indexer "Nyaa": apiKey.

Liên kết được tính là bí mật, vì token có thể nằm trong đó. Liên kết thông báo, địa chỉ RSS feed và các tham số bổ sung tự do bị bỏ lại và được liệt kê. Địa chỉ indexer chỉ giữ lại host và đường dẫn API.

Khóa bạn đã nhập

Khi chủ sở hữu đọc một ứng dụng bằng khóa đã nhập, HolyArrs giữ địa chỉ và khóa đó trong kho được mã hóa của nó. Lần sau, Edit đọc lại với Use the saved key (dùng khóa đã lưu) đang bật, và khóa chỉ được gửi tới địa chỉ đã lưu. HolyArrs không bao giờ hiển thị nó.

Khóa đã lưu bị xóa khi
bạn gỡ lần đọc của ứng dụng đó
một lần nhập kết thúc mà không có gì bị lỗi (một mục bị lỗi sẽ giữ lại các khóa, để bạn nhập lại được)
bạn chạy holyarrs import-secrets -forget-move-credentials

Ai được đọc

Chủ sở hữu và quản trị viên, đăng nhập bằng mật khẩu của họ. Việc bỏ qua đăng nhập trong mạng nội bộ không được tính. Khóa API cần phạm vi admin.

Nếu không hoạt động

Triệu chứng	Nguyên nhân	Cách khắc phục
Check connection bị lỗi	Địa chỉ được kiểm tra từ máy chủ HolyArrs.	Dùng địa chỉ mà máy chủ truy cập được. Bật công tắc mạng nội bộ cho ứng dụng trong mạng ở nhà.
Khóa sai	Sao chép lỗi, hoặc qBittorrent cần tên người dùng.	Sao chép lại khóa từ phần tùy chọn của ứng dụng cũ.
Bản sao lưu bị từ chối	Tệp zip đã bị sửa, hoặc đường dẫn nằm ngoài container.	Dùng đúng tệp zip sao lưu của ứng dụng, không sửa, tại đường dẫn của nó bên trong container HolyArrs.
Lần đọc quá lớn	Có giới hạn cho mỗi lần đọc và cho mỗi máy chủ.	Gỡ các lần đọc cũ bạn không cần nữa.

Dành cho người dùng nâng cao

Xử lý bản sao lưu và giới hạn

Quy tắc	Giá trị
Tệp được sao chép	Chỉ các tệp cần thiết, vào một thư mục tạm riêng, được xóa sau khi đọc.
Kích thước mỗi tệp được sao chép	Tối đa 1 GB.
config.xml của một ứng dụng arr	Không bao giờ được sao chép; nó chứa khóa API.
Cơ sở dữ liệu	Mở ở chế độ chỉ đọc.
Bị từ chối toàn bộ khi	một mục trỏ ra ngoài tệp zip, nó chứa một liên kết, hoặc một tệp giải nén ra lớn hơn nhiều so với kích thước của nó.
Số bản sao lưu cùng lúc	1.
Dung lượng giữ cho mỗi lần đọc	16 MB.
Số lần đọc được giữ	50 lần mới nhất.

API

Route	Chức năng
POST /api/v1/migrate/probe	Cho biết ứng dụng và phiên bản nào đang phản hồi, hoặc đây là bản sao lưu của ứng dụng nào.
POST /api/v1/migrate/read	Đọc toàn bộ thiết lập và giữ lại.
GET /api/v1/migrate/snapshots	Liệt kê các lần đọc, mới nhất trước.
GET /api/v1/migrate/snapshots/{id}	Một lần đọc cùng mọi thứ nó chứa.
DELETE /api/v1/migrate/snapshots/{id}	Gỡ một lần đọc và khóa đã lưu cho ứng dụng đó.
GET /api/v1/migrate/saved-keys	Các ứng dụng có khóa đã lưu và địa chỉ của chúng, không bao giờ kèm khóa. Chỉ chủ sở hữu.
DELETE /api/v1/migrate/saved-keys	Xóa mọi khóa đã lưu, hoặc một khóa với ?kind=. Chỉ chủ sở hữu.

Body của probe và read nêu tên ứng dụng: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent hoặc sabnzbd. Thêm url cùng key (hoặc username và password), hoặc path. Thêm allow_local_network để truy cập mạng ở nhà của bạn và use_saved_key để dùng khóa đã lưu.

Liên quan

• Nhập từ các ứng dụng khác
• Nhập khóa từ một tệp