Trình tải xuống

Kết nối ứng dụng tải xuống của bạn để HolyArrs gửi các bản phát hành cho nó và nhập những gì đã tải xong.

HolyArrs không tự tải xuống. Nó giao từng bản phát hành cho một trình tải xuống, theo dõi bản đó và nhập các tệp.

Loại	Ứng dụng
Torrent	qBittorrent, Transmission 4 trở lên, Deluge, rTorrent (có hoặc không có ruTorrent)
Usenet	SABnzbd, NZBGet

Trước khi bắt đầu

• Bạn là chủ sở hữu hoặc quản trị viên.
• Ứng dụng tải xuống của bạn đang chạy và bạn mở được trang web của nó.

Thêm một trình tải xuống

1. Mở Settings > Downloaders (Cài đặt > Trình tải xuống).

2. Nhấn Add a Downloader (thêm một trình tải xuống).

3. Ở Which app (ứng dụng nào), chọn ứng dụng của bạn.

4. Nhập một Name (tên).

5. Nhập Address (địa chỉ), tức trang web của ứng dụng, như http://192.168.1.10:8090. Với rTorrent, xem Địa chỉ rTorrent.

6. Điền thông tin đăng nhập. Xem Đăng nhập cho từng ứng dụng.

7. Nhấn Save (lưu), rồi nhấn Test (kiểm tra) trên dòng đó.

   Bạn sẽ thấy Working (đang hoạt động) bên cạnh tên.

Chú ý

Nếu HolyArrs và trình tải xuống chạy trong các container riêng và thấy thư mục tải xuống qua các đường dẫn khác nhau, việc nhập sẽ lỗi. Hãy điền cặp đường dẫn ở mục Đường dẫn trước lượt tải xuống đầu tiên.

Đăng nhập cho từng ứng dụng

Ứng dụng	Cần nhập gì	Tìm ở đâu
qBittorrent	API key (qBittorrent 5.2 trở lên) hoặc Username and password	Options > Web UI
Transmission	Tên người dùng và mật khẩu, để trống nếu nó không hỏi	Cài đặt của Transmission
Deluge	Mật khẩu Web UI, không có tên người dùng	Deluge Web UI
rTorrent	Tên người dùng và mật khẩu của máy chủ web đặt trước rTorrent, để trống nếu nó không hỏi	Cài đặt máy chủ web hoặc seedbox của bạn
SABnzbd	Khóa API	Config > General
NZBGet	Tên người dùng và mật khẩu, để trống nếu NZBGet cho HolyArrs vào mà không cần	Cài đặt của NZBGet

HolyArrs lưu khóa và mật khẩu đã mã hóa và không bao giờ hiện lại. Để yên ô đó nếu muốn giữ giá trị đã lưu. Khi bạn đổi địa chỉ sang một máy chủ khác, hãy nhập lại khóa. HolyArrs không bao giờ gửi khóa đã lưu tới một máy chủ mới.

Địa chỉ rTorrent

HolyArrs nói chuyện với rTorrent qua XML-RPC. Address (địa chỉ) là liên kết đó, không phải trang ruTorrent.

Thiết lập	Địa chỉ
crazymax/rtorrent-rutorrent	http://host:8000/RPC2. Cổng 8080 ở đó là trang ruTorrent
Qua ruTorrent	http://host:8080/plugins/httprpc/action.php, hoặc /rutorrent/plugins/httprpc/action.php khi ruTorrent nằm dưới /rutorrent. /plugins/rpc/rpc.php cũng dùng được
Seedbox	Liên kết mà seedbox của bạn cung cấp, như https://host/user/RPC2

Một địa chỉ không có đường dẫn sẽ được thêm /RPC2. Đã thử với rTorrent 0.16.25 và ruTorrent 5.3.18.

HolyArrs tự lấy từng tệp .torrent và gửi nó cho rTorrent, nên rTorrent không bao giờ liên hệ với Nguồn.

rTorrent trên seedbox

Khi rTorrent chạy trên một máy tính khác, HolyArrs không thấy thư mục tải xuống của nó. Hãy thiết lập một bản đồng bộ để sao chép các tệp đã tải xong vào một thư mục mà HolyArrs thấy được. Sau đó thêm một cặp đường dẫn ở mục Đường dẫn: Downloader’s path là thư mục trên seedbox, như /home/user/downloads, còn HolyArrs’ path là thư mục cục bộ mà bản đồng bộ ghi vào.

Lựa chọn

Với qBittorrent, các tùy chọn này nằm dưới More options (thêm tùy chọn).

Danh mục

HolyArrs xếp các lượt tải xuống của nó vào danh mục này và chỉ theo dõi danh mục đó.

Ứng dụng	Danh mục hoạt động thế nào
qBittorrent	Được tạo giúp bạn nếu chưa có
SABnzbd	Phải có sẵn, trong Config > Categories
Transmission, Deluge	Được lưu dưới dạng nhãn
rTorrent	Được lưu làm nhãn trong d.custom1, hiện ở cột Label của ruTorrent
NZBGet	Được gửi làm danh mục tải xuống

Mức ưu tiên và thẻ

Priority (mức ưu tiên) chạy từ 1 đến 50. Số nhỏ nhất được dùng trước, và các số bằng nhau thì lần lượt thay phiên. Với Tags (thẻ), chỉ những mục có chung một thẻ mới dùng trình tải xuống này. Các mục không có thẻ dùng các trình tải xuống không có thẻ.

Đường dẫn

Chỉ điền Downloader’s path (đường dẫn của trình tải xuống) và HolyArrs’ path (đường dẫn của HolyArrs) dưới Different folder names (tên thư mục khác nhau) khi hai ứng dụng thấy thư mục tải xuống dưới những tên khác nhau. Ví dụ: trình tải xuống lưu vào /data/torrents còn HolyArrs thấy nó là /downloads. Add a path pair (thêm một cặp đường dẫn) thêm một dòng nữa.

Cách khắc phục tốt hơn là một thư mục cha dùng chung, được mount ở cùng một đường dẫn trong cả hai container. Xem Thư mục.

Truy cập mạng nội bộ

Bật theo mặc định, vì trình tải xuống thường chạy ở nhà. Tắt nó với một trình tải xuống nằm trên internet.

HolyArrs có thể thay đổi trình tải xuống này

Tắt nghĩa là các lượt tải xuống mới vẫn được gửi tới đó, nhưng HolyArrs không bao giờ tạm dừng, thay đổi hay xóa bất cứ thứ gì đã có trong đó. Dùng nó cho một trình tải xuống bạn dùng chung với các ứng dụng khác.

Theo dõi một lượt tải xuống

Trang của một mục hiện từng lượt tải xuống: đang chờ đến lượt, đang tải xuống với tốc độ và thời gian còn lại, bị đứng, hoặc lỗi kèm lý do.

Nhấn Mark failed (đánh dấu lỗi) để kết thúc một lượt tải xuống bạn không muốn. HolyArrs sẽ:

1. Thêm bản phát hành đó vào danh sách Turned down (đã loại) của mục để nó không bị chọn lại.
2. Xóa nó khỏi trình tải xuống, cùng các tệp của nó.
3. Tìm lại và gửi bản phát hành tốt nhất kế tiếp.

rTorrent không thể xóa tệp qua XML-RPC, nên HolyArrs tự xóa chúng ở nơi thư mục lưu hoặc các cặp đường dẫn của nó với tới được. Nếu không, các tệp vẫn ở lại trên máy tính chạy rTorrent.

Nếu không còn bản nào khác đạt các quy tắc của bạn, mục sẽ hiện Needs a decision (cần quyết định).

Trạng thái của dòng

Trạng thái	Ý nghĩa
Working	Đã trả lời ở lần kiểm tra cuối
Paused (đã tạm dừng)	Bạn đã tạm dừng nó. Không gửi gì mới; các lượt tải xuống hiện có vẫn được theo dõi
Resting (đang nghỉ)	Nó không trả lời, nên HolyArrs chờ đến thời điểm được hiện trên dòng
Not answering (không phản hồi)	Lần kiểm tra cuối không có câu trả lời
Sign-in refused (từ chối đăng nhập)	Khóa hoặc thông tin đăng nhập bị từ chối

Pause (tạm dừng) và Resume (tiếp tục) trên dòng sẽ dừng và bắt đầu việc gửi. Một trình tải xuống ngừng trả lời sẽ bị bỏ qua tối đa 30 phút.

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

Triệu chứng: Kiểm tra SABnzbd lỗi khi Address dùng hostname. Nguyên nhân: SABnzbd từ chối các hostname mà nó không biết. Cách khắc phục: Dùng địa chỉ IP của nó, hoặc thêm hostname của HolyArrs vào host_whitelist trong SABnzbd, ở Config > Special.

Triệu chứng: SABnzbd báo thiếu danh mục. Cách khắc phục: Tạo danh mục trong SABnzbd ở Config > Categories, rồi nhấn Test.

Triệu chứng: Deluge không hoạt động. Cách khắc phục: Trong Deluge Web UI, tự kết nối tới daemon của bạn và bật plugin Label. HolyArrs không tự chọn daemon.

Triệu chứng: Kiểm tra rTorrent báo 404 hoặc not found. Nguyên nhân: Cổng hoặc đường dẫn sai. Với crazymax/rtorrent-rutorrent, 8000 là XML-RPC còn 8080 là trang ruTorrent. Cách khắc phục: Dùng http://host:8000/RPC2, hoặc một đường dẫn ruTorrent trong Địa chỉ rTorrent.

Triệu chứng: rTorrent báo not allowed for untrusted connections. Nguyên nhân: ruTorrent chặn một lệnh mà HolyArrs cần. Cách khắc phục: Cập nhật ruTorrent, hoặc trỏ Address tới /RPC2 của rTorrent.

Triệu chứng: rTorrent từ chối một bản phát hành với lỗi về giới hạn kích thước. Cách khắc phục: Tăng network.xmlrpc.size_limit trong cấu hình của rTorrent. Với crazymax/rtorrent-rutorrent, đặt XMLRPC_SIZE_LIMIT.

Triệu chứng: Một tệp .torrent hoặc .nzb từ một Nguồn dùng proxy bị từ chối. Nguyên nhân: Transmission, Deluge, rTorrent và NZBGet chưa nhận được các tệp đó qua một Nguồn có proxy. Liên kết magnet vẫn dùng được.

Triệu chứng: Một dòng hiện Check whether this download arrived (kiểm tra xem lượt tải xuống này đã tới chưa). Nguyên nhân: Kết nối bị ngắt khi Transmission, Deluge, rTorrent hoặc NZBGet đang nhận một bản phát hành. HolyArrs không tự gửi lại. Cách khắc phục:

1. Tìm lượt tải xuống đó trong ứng dụng trình tải xuống.
2. Trong HolyArrs, nhấn Give up on it (bỏ qua). Lượt tải xuống vẫn ở trong trình tải xuống. Chọn một bản phát hành khác dưới Needs a decision nếu bạn muốn.

Triệu chứng: Sign-in refused. Cách khắc phục: Sao chép khóa hoặc mật khẩu từ trình tải xuống, nhập lại, rồi nhấn Test.

Xem thêm trong Khắc phục sự cố.

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

Cách HolyArrs chọn một trình tải xuống

• Các bản phát hành torrent đi tới các trình tải xuống torrent, các bản phát hành Usenet đi tới Usenet.
• Số ưu tiên thấp nhất đi trước. Các số bằng nhau thì lần lượt thay phiên.
• Các trình tải xuống đang tạm dừng và đang nghỉ bị bỏ qua.
• Nếu một trình tải xuống từ chối một bản phát hành, trình tải xuống kế tiếp cùng loại sẽ được thử (Try the next Downloader, thử trình tải xuống kế tiếp).
• Các lần gửi tới một trình tải xuống cách nhau 2 giây theo mặc định.
• Thẻ phải khớp. Các mục không có thẻ đi tới các trình tải xuống không có thẻ.

Khi tải xuống gặp sự cố: điều gì được tính, và các tùy chọn

HolyArrs xử lý các trường hợp sau như Mark failed:

• Trình tải xuống bỏ cuộc (thiếu phần, sửa lỗi thất bại). Lý do của nó được hiện ra.
• Lượt tải xuống chứa chương trình như .exe, .bat, .scr hoặc .lnk, kể cả movie.mkv.exe.
• Lượt tải xuống trông giả: một ghi chú mật khẩu, chỉ có tệp nén mà không có video hay âm thanh, hoặc một lối tắt web mà không có media bên cạnh. Danh sách tệp của torrent được đọc ngay khi tới, nên bản giả bị loại trước khi tải xuống.
• Các tệp không khớp với tên bản phát hành. Việc nhập bị từ chối và lượt tải xuống bị xóa.
• Không có tiến triển trong khoảng thời gian bỏ cuộc. Đang chờ đến lượt, bị tạm dừng trong trình tải xuống, và đang sửa lỗi hoặc giải nén ở mức 100% thì không tính.
• Lượt tải xuống bị xóa từ bên ngoài HolyArrs. Nó được thay bằng bản phát hành kế tiếp.

Các tùy chọn này nằm dưới When downloads go wrong (khi tải xuống gặp sự cố) trong Settings > Downloaders. Nhấn Save ở thanh xuất hiện sau khi bạn thay đổi.

Tùy chọn	Mặc định	Đổi khi
Remove failed downloads from the Downloader	bật	Bạn muốn kiểm tra các lượt lỗi (tắt). Bật thì cũng xóa các tệp của chúng
Add matched titles to your Library	tắt	Bạn muốn một mục khớp chắc chắn đã có trong trình tải xuống được thêm mà không cần tìm kiếm
When you remove a download: Delete its files (xóa các tệp của nó)	bật	Bạn muốn giữ lại các tệp
When you remove a download: Turn down its Release (loại bản phát hành đó)	tắt	Bạn không bao giờ muốn bản phát hành đó được chọn lại cho mục
When you remove a download: Search again (tìm lại)	bật	Tắt nếu bạn tự chọn bản phát hành kế tiếp. Cần Turn down its Release
Stalled after (hours)	6	Các lượt tải xuống của bạn vốn chậm. Phạm vi 1 đến 168
Try the next Release after (hours)	24	Bạn thích chờ hơn là thay thế. Tính từ lần có tiến triển cuối. Phạm vi: từ thời gian bị đứng đến 720
Fail downloads that hold programs or fakes	bật	Hiếm khi. Tắt sẽ để chúng đi tới bước nhập
Replace downloads removed outside HolyArrs	bật	Bạn cố ý xóa các lượt tải xuống. Tắt thì mục sẽ chờ bạn
Try the next Downloader	bật	Bạn chỉ muốn dùng một trình tải xuống
Seconds between sends to one Downloader	2	Trình tải xuống bị nghẹn khi gửi dồn. 0 là tắt khoảng cách. Phạm vi 0 đến 60

Khóa một trình tải xuống ở chế độ chỉ đọc từ máy chủ

Đặt HOLYARRS_READONLY_DOWNLOADERS thành một danh sách phân cách bằng dấu phẩy gồm id hoặc địa chỉ của các trình tải xuống:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Một trình tải xuống trong danh sách luôn ở chế độ chỉ đọc bất kể công tắc của nó ra sao, kể cả sau khi xóa rồi thêm lại. Công tắc hiện ở trạng thái bị khóa, và trang Tải xuống ẩn các nút điều khiển trên các dòng của nó.

Xóa, việc xóa với NZBGet, API

• Remove (xóa) bị từ chối khi trình tải xuống còn các lượt tải xuống đang chạy. Hãy tạm dừng nó, để chúng xong, rồi xóa.
• NZBGet xóa các tệp mỗi khi một lượt tải xuống hoặc mục lịch sử của nó bị xóa, nên HolyArrs từ chối các yêu cầu xóa mà muốn giữ lại tệp.
• rTorrent không thể xóa dữ liệu qua XML-RPC. Khi một yêu cầu xóa muốn xóa tệp, HolyArrs tự xóa chúng ở nơi thư mục lưu hoặc các cặp đường dẫn của nó với tới được. Nếu không, các tệp vẫn ở lại trên máy tính chạy rTorrent và HolyArrs ghi lại lý do vào nhật ký.
• Trên Downloads (tải xuống), một dòng rTorrent có Pause và Resume, nhưng không có các nút điều khiển khác của qBittorrent.
• Mọi route của trình tải xuống đều có trong http://your-server:6262/api/v1/openapi.json.

Liên quan

• Nguồn
• Lịch sử
• Thư mục