NAS, Synology dan Unraid

Jalankan HolyArrs pada NAS anda dengan folder, pemilik dan tetapan mula semula yang betul. Baca Pasang dahulu.

Sebelum bermula

• /config diletakkan pada volum atau pool setempat. Jangan sekali-kali pada folder kongsi rangkaian.
• Media diletakkan dalam satu folder kongsi dengan downloads, movies, tv dan music di dalamnya. Lekapkan setiap satu, atau lekapkan folder induk sekali untuk hardlink. Lihat Folder.

Sediakan NAS anda

::tab[Synology]

1. Dalam File Station, cipta docker/holyarrs/config.
2. Cipta satu folder kongsi media dengan downloads, movies, tv dan music di dalamnya.
3. Dalam Container Manager, buka Project > Create (Projek > Cipta) dan tampal fail Compose daripada Pasang.
4. Tetapkan volum kepada /volume1/docker/holyarrs/config:/config, kemudian /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music dan /volume1/media/downloads:/downloads.
5. Tetapkan PUID dan PGID kepada pengguna anda, selalunya 1026 dan 100. Semak dengan id <user> melalui SSH.
6. Beri pengguna itu kebenaran baca dan tulis pada media: Control Panel > Shared Folder > Edit > Permissions (Panel Kawalan > Folder Kongsi > Edit > Kebenaran).
7. Tandakan Enable auto-restart (hidupkan mula semula automatik).
8. Buka http://your-server:6262. Anda akan nampak wizard larian pertama. Tambah /movies, /tv dan /music sebagai folder Pustaka.

::tab[Unraid]

Belum ada templat Community Applications, jadi tambah kontena secara manual.

1. Dalam tab Docker, tambah kontena dengan imej HolyArrs.
2. Petakan port 6262.
3. Petakan /config ke laluan pool, seperti /mnt/<pool>/appdata/holyarrs. <pool> ialah nama pool anda. Bukan /mnt/user/appdata.
4. Petakan folder media anda ke /movies, /tv, /music dan /downloads, menggunakan laluan cakera atau pool, contohnya /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music dan /mnt/<pool>/media/downloads:/downloads.
5. Tetapkan PUID=99, PGID=100 (nobody:users Unraid) dan UMASK=022.
6. Hidupkan mula automatik untuk kontena, supaya ia mula semula dengan sendirinya.
7. Buka http://your-server:6262. Anda akan nampak wizard larian pertama.

::tab[QNAP]

1. Cipta Container/holyarrs/config dan satu kongsi media dengan downloads, movies, tv dan music di dalamnya.
2. Dalam Container Station, buka Applications > Create (App > Cipta) dan tampal fail Compose.
3. Gunakan /share/Container/holyarrs/config:/config, kemudian /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music dan /share/media/downloads:/downloads.
4. Tetapkan PUID dan PGID kepada pemilik kongsi media.
5. Tetapkan polisi mula semula kepada unless-stopped.
6. Buka http://your-server:6262. Anda akan nampak wizard larian pertama.

::tab[TrueNAS SCALE]

1. Cipta 2 dataset: apps/holyarrs-config dan media, dengan folder downloads, movies, tv dan music di dalam media.
2. Dalam Apps, tambah app tersuai daripada YAML dengan fail Compose.
3. Gunakan /mnt/<pool>/apps/holyarrs-config:/config, kemudian /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music dan /mnt/<pool>/media/downloads:/downloads.
4. Tetapkan PUID dan PGID kepada pemilik dataset, selalunya 568. Beri pengguna itu kebenaran menulis dalam ACL dataset.
5. Tetapkan polisi mula semula kepada unless-stopped.
6. Buka http://your-server:6262. Anda akan nampak wizard larian pertama.

Setiap NAS: beri pengguna PUID kebenaran baca dan tulis pada folder media dalam skrin kebenaran NAS; HolyArrs menguruskan folder konfigurasi sendiri. Hidupkan mula semula automatik untuk kontena (polisi unless-stopped Docker).

Untuk hardlink, yang tidak menggunakan ruang tambahan dan siap serta-merta, lekapkan satu folder media itu menggantikan keempat-empatnya, dan beri pemuat turun anda lekapan yang sama pada laluan yang sama. Lihat Folder media.

Pilihan

Lekapan berasingan

Melekapkan /movies, /tv, /music dan /downloads satu demi satu berfungsi, tetapi setiap import menjadi salinan penuh. Setiap lekapan ialah sistem failnya sendiri di dalam kontena, dan hardlink tidak dapat merentas sistem fail. Folder kongsi atau dataset berasingan di bawah satu induk juga disalin. Settings > Library folders (Tetapan > Folder Pustaka) memberi peringatan apabila HolyArrs terpaksa menyalin.

Biarkan cakera anda tidur

Tugas ini membangunkan cakera media. Ubah kekerapannya pada halaman Schedules (Jadual).

Tugas	Apa yang dibacanya
Rescan the Library (imbas semula Pustaka)	Setiap folder Pustaka. Paling kerap membangunkan cakera.
Check Library folders (semak folder Pustaka)	Butiran dan ruang kosong setiap folder. Ujian tulis dan hardlink hanya berjalan semasa permulaan, pada Run now (jalankan sekarang) dan apabila folder berubah.
Look for missing subtitles (cari sari kata yang tiada), Look for better subtitles (cari sari kata yang lebih baik)	Folder di sebelah setiap video.

• Letakkan /config dan folder muat turun pada SSD atau pool cache.
• Pastikan 1 GB ruang kosong pada cakera yang menyimpan /config. Di bawah itu anda mendapat peringatan kesihatan.
• Pada Unraid, pemalam Cache Directories menyimpan senarai folder dalam memori, jadi imbasan tidak menyentuh cakera.
• Import, tambah dan padam menyentuh cakera yang digunakan, pada ketika ia berlaku.
• Tetapkan imbasan semula kepada setiap 7 hari atau matikan. Fail yang anda tambah dengan tangan kemudian hanya ditemui apabila anda menekan Run now pada Rescan the Library.
• Torrent yang sedang seed membaca failnya. Jika ia dihardlink ke Pustaka anda, cakera itu kekal berjaga sehingga seeding berhenti.

Jika tidak berfungsi

Gejala	Punca	Penyelesaian
Tidak mahu bermula, menyebut laluan FUSE, folder kongsi rangkaian atau kongsi pengguna Unraid	/config tidak berada pada cakera setempat (pada Unraid, ia menuju ke /mnt/user)	Pindahkan /config ke laluan cakera atau pool setempat, seperti /mnt/<pool>/appdata/holyarrs.
Kekal berhenti selepas mula semula atau pemulihan	Mula semula automatik dimatikan	Hidupkannya dan mulakan kontena.
Import gagal dengan ralat kebenaran	Pengguna PUID tidak boleh menulis ke media	Beri kebenaran baca dan tulis dalam skrin kebenaran NAS (pada Synology: Control Panel > Shared Folder > Edit > Permissions).
Import menjadi salinan, bukan hardlink	Muat turun dan Pustaka berada pada lekapan atau cakera berbeza	Lekapkan satu folder kongsi sekali, dalam HolyArrs dan pemuat turun.

Lebih banyak penyelesaian: Penyelesaian masalah.

Untuk pakar

Sebab HolyArrs menolak sesetengah laluan konfigurasi

HolyArrs menyimpan pangkalan datanya dalam /config. Folder kongsi rangkaian dan laluan FUSE boleh merosakkannya, jadi HolyArrs enggan bermula pada laluan sebegitu dan menyatakan sebabnya.

Pada Unraid, /mnt/user ialah laluan FUSE. Gunakan laluan pool, atau jadikan appdata Exclusive: hidupkan Permit exclusive shares dalam Settings > Global Share Settings, kemudian tetapkan Shares > appdata kepada storan utama pada satu pool dan storan sekunder kepada tiada.

Laluan /config pada pool yang tidak wujud akan berakhir dalam memori dan hilang apabila but semula. HolyArrs menolaknya juga. Elakkan /mnt/user untuk media juga; hardlink merentasinya boleh gagal.

Kepentingan mula semula automatik

Mula semula dalam app, mod selamat dan pemulihan sandaran semuanya menghentikan HolyArrs dan menjangka Docker memulakannya semula. Tanpa mula semula automatik, ia kekal berhenti. Lihat Bahagian dan mod selamat.

Port dan kemas kini

• Petakan port 6262 kepada rangkaian rumah anda sahaja. Baca Asas keselamatan sebelum membukanya kepada sesiapa di luar.
• Untuk mengemas kini, tarik imej baharu dan cipta semula kontena. Data anda kekal dalam /config. Lihat Kemas kini.

Berkaitan

• Folder
• Folder Pustaka
• Jadual