Khắc phục sự cố

Tìm triệu chứng của bạn, đọc nguyên nhân, làm theo cách khắc phục. Các ví dụ dùng tên container holyarrs; nếu của bạn khác thì dùng tên của bạn.

3 bước kiểm tra đầu tiên

1. Xem nhật ký (log): docker logs -f holyarrs. Các thông tin bí mật đã được che. Nhấn Ctrl+C để ngừng theo dõi; container vẫn tiếp tục chạy.
2. Chạy doctor: docker exec holyarrs /holyarrs doctor. Mỗi dòng ghi OK, WARN hoặc FAIL, và mỗi WARN hay FAIL đều nói cách sửa.
3. Vẫn bị kẹt? Tải một gói hỗ trợ xuống và nhờ giúp. Xem Nhận hỗ trợ.

Không vào được trang web

Triệu chứng: trình duyệt không kết nối được tới http://your-server:6262.

Nguyên nhân: container đã dừng, cổng chưa được ánh xạ, hoặc có một proxy chắn đường.

Cách khắc phục:

1. Chạy docker ps. Bạn sẽ thấy holyarrs với 0.0.0.0:6262->6262.
2. Nếu nó cứ khởi động lại, đọc docker logs holyarrs để biết lý do.
3. Nếu bạn dùng một đường dẫn như /holyarrs, xem Reverse proxy và URL base.

Permission denied

Triệu chứng: doctor báo một thư mục không ghi được, hoặc việc nhập bị lỗi quyền.

Nguyên nhân: chủ sở hữu của thư mục trên máy chủ không khớp với PUID và PGID.

Cách khắc phục: chạy lệnh chown mà doctor gợi ý, hoặc đặt PUID và PGID theo chủ sở hữu của thư mục. Trên NAS, hãy cấp cho người dùng đó quyền đọc và ghi trong màn hình phân quyền. Xem NAS, Synology và Unraid.

Không có gì được tải xuống

Triệu chứng: các mục cứ ở trạng thái còn thiếu và không có gì đến được trình tải xuống của bạn.

Nguyên nhân: không có nguồn nào trả lời, trình tải xuống chưa được kết nối, hoặc không có bản phát hành nào đạt quy tắc chọn của bạn.

Cách khắc phục:

1. Mở Settings > Downloaders (cài đặt > trình tải xuống) và nhấn Test (kiểm tra) trên trình tải xuống của bạn. Nó phải đạt.
2. Mở Settings > Sources và nhấn Test trên từng nguồn.
3. Trên trang của mục, mở Choose a release (chọn một bản phát hành) để xem mọi kết quả và lý do chúng không được chọn.

Xem Trình tải xuống và Nguồn.

Đã tải xuống nhưng chưa được nhập

Triệu chứng: lượt tải xuống đã xong trong trình tải xuống của bạn, nhưng mục chưa có trong Thư viện.

Nguyên nhân: HolyArrs không thấy tệp ở cùng đường dẫn, không ghi được vào thư mục Thư viện, hoặc lượt nhập cần một quyết định.

Cách khắc phục:

1. Cho HolyArrs và trình tải xuống cùng một thư mục tải xuống ở cùng đường dẫn, như /downloads, hoặc đặt Downloader’s path (đường dẫn của trình tải xuống) và HolyArrs’ path (đường dẫn của HolyArrs) trên trình tải xuống.
2. Chạy doctor và sửa mọi FAIL ở thư mục tải xuống hoặc thư mục Thư viện.
3. Xem trong danh sách tải xuống các mục được đánh dấu Needs a decision (cần quyết định), rồi duyệt hoặc bỏ kế hoạch.

Việc nhập tạo ra bản sao, không phải hardlink

Triệu chứng: doctor báo hardlink không hoạt động, hoặc dung lượng ổ đĩa tăng gấp đôi sau khi nhập.

Nguyên nhân: thư mục tải xuống và thư mục Thư viện nằm trên các ổ đĩa hoặc mount khác nhau, hoặc ổ đĩa không thể tạo hardlink (DrivePool, nhiều NAS và thư mục chia sẻ SMB, Docker Desktop trên Windows). Mỗi tệp vẫn chỉ được ghi một lần. Các lượt tải xuống Usenet đã xong sẽ được di chuyển khi chúng cùng ổ đĩa với Thư viện.

Cách khắc phục: mount một thư mục cha chung vào container thay vì các thư mục riêng. Xem Thư mục.

HolyArrs không khởi động

Triệu chứng: container dừng hoặc khởi động lại ngay lập tức.

Nguyên nhân: nhật ký sẽ nói rõ. Những nguyên nhân thường gặp: /config nằm trên thư mục chia sẻ mạng hoặc đường dẫn FUSE, hoặc một phần bị hỏng.

Cách khắc phục:

1. Chuyển /config sang ổ đĩa cục bộ nếu nhật ký nói vậy. HolyArrs không chạy cơ sở dữ liệu của nó trên thư mục chia sẻ.
2. Nếu không, khởi động ở chế độ an toàn, sửa từ Settings, rồi khởi động lại bình thường.

Thiếu một tính năng

Triệu chứng: một tính năng bạn đã đọc về không có trong ứng dụng.

Nguyên nhân: có thể nó chưa mở trong phiên bản này.

Cách khắc phục: xem Tính năng chưa mở.

Các trang không có tên hay hình ảnh

Triệu chứng: các mục hiện ra không có poster hay chi tiết.

Nguyên nhân: không kết nối được tới máy chủ metadata.

Cách khắc phục: kiểm tra DNS và tường lửa của bạn. Phần Network của doctor cho biết máy chủ có trả lời hay không.

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

Các mục kiểm tra và tùy chọn của doctor

Doctor chạy bên trong container bằng chính người dùng mà HolyArrs chạy, nên nó gặp đúng những gì HolyArrs gặp.

Phần	Hiển thị
App	Phiên bản, người dùng và nhóm, umask, có chạy trong container hay không.
Config folder	Chủ sở hữu, quyền, dung lượng trống, có nằm trên ổ đĩa cục bộ hay không.
Library and download folders	Có tồn tại không, chủ sở hữu, có ghi được không, dung lượng trống, hardlink giữa thư mục tải xuống và thư mục Thư viện.
Network	Tên của máy chủ metadata có phân giải được không và nó có trả lời không.
Clock	Giờ, múi giờ (TZ), một lưu ý khi đồng hồ rõ ràng bị sai.

Tùy chọn	Tác dụng
-config <folder>	Kiểm tra một thư mục cấu hình HolyArrs khác với /config.
-json	In báo cáo dưới dạng JSON.

Mã thoát 0 nghĩa là không có gì lỗi; 1 nghĩa là có một dòng ghi FAIL. Báo cáo không bao giờ hiện khóa, mật khẩu hay token. Nó chỉ đọc, ngoại trừ một tệp thử nhỏ mà nó ghi rồi xóa. Nếu khởi động bằng quyền root, nó cũng giao thư mục cấu hình cho PUID:PGID, giống một lần khởi động bình thường.

Nếu HolyArrs cứ khởi động lại, docker exec sẽ thất bại. Hãy chạy doctor trong một container mới với cùng các thư mục:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Với Compose: docker compose run --rm holyarrs doctor.

Kiểm tra thư mục khi khởi động

Khi khởi động, HolyArrs kiểm tra các thư mục của nó và ghi vào nhật ký một dòng tóm tắt, như folders: 4 ok, 1 not writable, rồi mỗi thư mục có vấn đề một dòng kèm cách sửa. Việc kiểm tra dừng sau 3 giây để quá trình khởi động không bao giờ bị treo. Một thư mục trả lời quá chậm được tính là chưa kiểm tra; thường là do ổ đĩa đang thức dậy sau khi ngủ hoặc thư mục chia sẻ mạng chậm. Doctor kiểm tra mà không giới hạn thời gian. Xem Nhật ký.

Image không có shell

Image chỉ chứa chương trình HolyArrs, nên nó nhỏ gọn và để lại ít thứ hơn cho kẻ tấn công. docker exec holyarrs sh thất bại là do thiết kế. Để xem kỹ hơn, hãy khởi động một container phụ dùng một lần bên cạnh nó:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Nó thấy tiến trình HolyArrs, dùng chung mạng và có cùng các thư mục ở cùng đường dẫn. Nó chạy với quyền root, nên chỉ xem chứ đừng sửa: một tệp ghi bằng root có thể HolyArrs không đọc được. Để thử với người dùng của HolyArrs, thêm --user <PUID>:<PGID>.

Tìm phiên bản

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Phần App của doctor cũng hiển thị điều này.

Liên quan

• Nhận hỗ trợ
• Nhật ký
• Kiểm tra tình trạng