Penyelesaian masalah

Cari gejala anda, baca puncanya, ikut penyelesaiannya. Contoh menggunakan nama kontena holyarrs; gunakan nama anda jika berbeza.

First 3 checks (3 semakan pertama)

1. Perhatikan log (rekod): docker logs -f holyarrs. Rahsia ditutup. Tekan Ctrl+C untuk berhenti mengikut; kontena terus berjalan.
2. Jalankan doctor: docker exec holyarrs /holyarrs doctor. Setiap baris menyatakan OK, WARN atau FAIL, dan setiap WARN atau FAIL menyatakan cara membetulkannya.
3. Masih buntu? Muat turun pakej sokongan dan minta bantuan. Lihat Dapatkan sokongan.

Tidak boleh capai halaman web

Gejala: pelayar tidak boleh bersambung ke http://your-server:6262.

Punca: kontena sudah berhenti, port tidak dipetakan, atau ada proksi yang menghalang.

Penyelesaian:

1. Jalankan docker ps. Anda akan nampak holyarrs dengan 0.0.0.0:6262->6262.
2. Jika ia terus mula semula, baca docker logs holyarrs untuk mengetahui sebabnya.
3. Jika anda menggunakan laluan seperti /holyarrs, lihat Proksi songsang dan URL base.

Kebenaran ditolak

Gejala: doctor menyatakan folder tidak boleh ditulis, atau import gagal dengan ralat kebenaran.

Punca: pemilik folder pada host tidak sepadan dengan PUID dan PGID.

Penyelesaian: jalankan chown yang dicadangkan oleh doctor, atau tetapkan PUID dan PGID kepada pemilik folder itu. Pada NAS, beri pengguna itu kebenaran membaca dan menulis pada skrin kebenaran. Lihat NAS, Synology dan Unraid.

Tiada apa yang dimuat turun

Gejala: judul kekal tiada dan tiada apa yang sampai ke pemuat turun anda.

Punca: tiada Sumber yang menjawab, pemuat turun tidak disambungkan, atau tiada keluaran yang lulus peraturan pilihan anda.

Penyelesaian:

1. Buka Settings > Downloaders (Tetapan > Pemuat turun) dan tekan Test (Uji) pada pemuat turun anda. Ia sepatutnya lulus.
2. Buka Settings > Sources (Tetapan > Sumber) dan tekan Test pada setiap Sumber.
3. Pada judul itu, buka Choose a release (Pilih keluaran) untuk melihat setiap hasil dan sebab ia tidak dipilih.

Lihat Pemuat turun dan Sumber.

Sudah dimuat turun tetapi tidak diimport

Gejala: muat turun sudah siap dalam pemuat turun anda, tetapi judul tidak ada dalam Pustaka.

Punca: HolyArrs tidak nampak fail itu pada laluan yang sama, tidak boleh menulis ke folder Pustaka, atau import memerlukan keputusan.

Penyelesaian:

1. Beri HolyArrs dan pemuat turun folder muat turun yang sama pada laluan yang sama, seperti /downloads, atau tetapkan Downloader’s path (laluan pemuat turun) dan HolyArrs’ path (laluan HolyArrs) pada pemuat turun itu.
2. Jalankan doctor dan betulkan sebarang FAIL pada folder muat turun atau folder Pustaka.
3. Semak senarai muat turun untuk item yang ditandakan Needs a decision (Perlu keputusan), dan luluskan atau buang pelan itu.

Import menjadi salinan, bukan hardlink

Gejala: doctor menyatakan hardlink (pautan keras) tidak berfungsi, atau penggunaan cakera berganda selepas import.

Punca: folder muat turun dan folder Pustaka berada pada cakera atau pelekapan yang berbeza, atau cakera itu tidak boleh membuat hardlink (DrivePool, banyak NAS dan kongsi SMB, Docker Desktop pada Windows). Setiap fail masih ditulis sekali sahaja. Muat turun Usenet yang siap dipindahkan apabila ia berkongsi cakera dengan Pustaka.

Penyelesaian: lekapkan satu folder induk kongsi ke dalam kontena, bukannya folder yang berasingan. Lihat Folder.

HolyArrs tidak mahu bermula

Gejala: kontena berhenti atau mula semula serta-merta.

Punca: log menyebutnya. Yang biasa: /config pada folder kongsi rangkaian atau laluan FUSE, atau bahagian yang rosak.

Penyelesaian:

1. Pindahkan /config ke cakera setempat jika log menyatakan demikian. HolyArrs tidak akan menjalankan pangkalan datanya pada folder kongsi.
2. Jika tidak, mulakan dalam mod selamat, betulkan dari Settings (Tetapan), dan mulakan semula seperti biasa.

Ciri tiada

Gejala: ciri yang anda baca tidak ada dalam app.

Punca: ia mungkin ditahan dalam keluaran ini.

Penyelesaian: lihat Ciri ditahan.

Halaman tiada nama atau gambar

Gejala: judul dipaparkan tanpa poster atau butiran.

Punca: pelayan metadata tidak dapat dicapai.

Penyelesaian: semak DNS dan tembok api anda. Bahagian Network dalam doctor menunjukkan sama ada pelayan menjawab.

Untuk pakar

Semakan dan pilihan doctor

Doctor berjalan di dalam kontena sebagai pengguna yang sama dengan HolyArrs, jadi ia menghadapi perkara yang sama seperti HolyArrs.

Bahagian	Menunjukkan
App	Versi, pengguna dan kumpulan, umask, sama ada ia berjalan dalam kontena.
Config folder	Pemilik, kebenaran, ruang kosong, sama ada ia berada pada cakera setempat.
Library and download folders	Wujud, pemilik, boleh ditulis, ruang kosong, hardlink antara folder muat turun dan folder Pustaka.
Network	Sama ada nama pelayan metadata boleh diselesaikan dan ia menjawab.
Clock	Masa, zon waktu (TZ), amaran apabila jam jelas salah.

Pilihan	Fungsi
-config <folder>	Menyemak folder konfigurasi HolyArrs lain selain /config.
-json	Mencetak laporan sebagai JSON.

Kod keluar 0 bermakna tiada yang gagal; 1 bermakna ada baris yang menyatakan FAIL. Laporan tidak pernah menunjukkan kunci, kata laluan atau token. Ia hanya membaca, kecuali satu fail ujian kecil yang ditulis dan dipadam olehnya. Jika dimulakan sebagai root, ia juga menyerahkan folder konfigurasi kepada PUID:PGID, seperti permulaan biasa.

Jika HolyArrs terus mula semula, docker exec gagal. Jalankan doctor dalam kontena baharu dengan folder yang sama:

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

Dengan Compose: docker compose run --rm holyarrs doctor.

Semakan folder semasa permulaan

Semasa bermula, HolyArrs menyemak foldernya dan mencatat satu baris ringkasan, seperti folders: 4 ok, 1 not writable, kemudian satu baris bagi setiap folder yang bermasalah beserta penyelesaiannya. Semakan berhenti selepas 3 saat supaya permulaan tidak tersangkut. Folder yang terlalu lambat menjawab dikira tidak disemak; ini selalunya cakera yang sedang bangun daripada tidur atau folder kongsi rangkaian yang perlahan. Doctor menyemaknya tanpa had masa. Lihat Log.

Imej tiada shell

Imej hanya mengandungi program HolyArrs, supaya ia kekal kecil dan penyerang mendapat lebih sedikit untuk disalahgunakan. docker exec holyarrs sh gagal secara sengaja. Untuk melihat dengan lebih dekat, mulakan pembantu sementara di sebelahnya:

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

Ia nampak proses HolyArrs, berkongsi rangkaiannya dan mempunyai folder yang sama pada laluan yang sama. Ia berjalan sebagai root, jadi lihat sahaja dan jangan ubah: fail yang ditulis sebagai root mungkin tidak boleh dibaca oleh HolyArrs. Untuk menguji sebagai pengguna HolyArrs, tambah --user <PUID>:<PGID>.

Cari versi

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

Bahagian App dalam doctor menunjukkan perkara yang sama.

Berkaitan

• Dapatkan sokongan
• Log
• Semakan kesihatan