NAS, Synology и Unraid

Стартирай HolyArrs на своя NAS с правилните папки, собственик и настройка за рестарт. Първо прочети Инсталиране.

Преди да започнеш

• /config отива на локален том или пул. Никога на мрежова папка.
• Медията е в една обща папка с downloads, movies, tv и music вътре. Монтирай всяка поотделно или родителската веднъж, за да работят hardlink (твърда връзка). Виж Папки.

Настрой своя NAS

::tab[Synology]

1. Във File Station направи docker/holyarrs/config.
2. Направи една обща папка media с downloads, movies, tv и music вътре.
3. В Container Manager отвори Project > Create (проект > създаване) и постави Compose файла от Инсталиране.
4. Задай томовете на /volume1/docker/holyarrs/config:/config, после /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music и /volume1/media/downloads:/downloads.
5. Задай PUID и PGID на твоя потребител, често 1026 и 100. Провери с id <user> през SSH.
6. Дай на този потребител четене и запис върху media: Control Panel > Shared Folder > Edit > Permissions (Контролен панел > Споделена папка > Редактиране > Права).
7. Отбележи Enable auto-restart (включи автоматичния рестарт).
8. Отвори http://your-server:6262. Трябва да видиш съветника за първо стартиране. Добави /movies, /tv и /music като папки на Библиотеката.

::tab[Unraid]

Още няма шаблон в Community Applications, така че добави контейнера на ръка.

1. В раздела Docker добави контейнер с образа на HolyArrs.
2. Пренасочи порт 6262.
3. Пренасочи /config към път на пул, например /mnt/<pool>/appdata/holyarrs. <pool> е името на твоя пул. Не /mnt/user/appdata.
4. Пренасочи папките си с медия към /movies, /tv, /music и /downloads, с пътища на диск или пул, например /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music и /mnt/<pool>/media/downloads:/downloads.
5. Задай PUID=99, PGID=100 (nobody:users на Unraid) и UMASK=022.
6. Включи автоматичното стартиране на контейнера, за да се рестартира сам.
7. Отвори http://your-server:6262. Трябва да видиш съветника за първо стартиране.

::tab[QNAP]

1. Направи Container/holyarrs/config и една папка media с downloads, movies, tv и music вътре.
2. В Container Station отвори Applications > Create (приложения > създаване) и постави Compose файла.
3. Ползвай /share/Container/holyarrs/config:/config, после /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music и /share/media/downloads:/downloads.
4. Задай PUID и PGID на собственика на папката media.
5. Задай политиката за рестарт на unless-stopped.
6. Отвори http://your-server:6262. Трябва да видиш съветника за първо стартиране.

::tab[TrueNAS SCALE]

1. Направи 2 набора от данни: apps/holyarrs-config и media, с папки downloads, movies, tv и music вътре в media.
2. В Apps добави собствено приложение от YAML с Compose файла.
3. Ползвай /mnt/<pool>/apps/holyarrs-config:/config, после /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music и /mnt/<pool>/media/downloads:/downloads.
4. Задай PUID и PGID на собственика на набора от данни, често 568. Дай на този потребител право за запис в ACL на набора.
5. Задай политиката за рестарт на unless-stopped.
6. Отвори http://your-server:6262. Трябва да видиш съветника за първо стартиране.

На всеки NAS: дай на потребителя PUID четене и запис върху папката с медия в екрана за права на NAS; за папката с конфигурация HolyArrs се грижи сам. Включи автоматичния рестарт на контейнера (политиката unless-stopped на Docker).

За hardlink (твърда връзка), които не заемат допълнително място и свършват мигновено, монтирай една папка с медия вместо четирите и дай на програмата си за изтегляне същото монтиране на същия път. Виж Папки с медия.

Възможности

Отделни монтирания

Монтирането на /movies, /tv, /music и /downloads едно по едно работи, но всяко импортиране става пълно копиране. Всяко монтиране е своя файлова система вътре в контейнера, а hardlink не може да минава през файлови системи. Отделни споделени папки или набори от данни под един родител също се копират. Settings > Library folders (Настройки > Папки на Библиотеката) предупреждава, когато HolyArrs трябва да копира.

Остави дисковете да спят

Тези задачи будят дисковете с медията. Променяй колко често вървят на страницата Schedules (Графици).

Задача	Какво чете
Rescan the Library (сканирай Библиотеката пак)	Всяка папка на Библиотеката. Буди дисковете най-много.
Check Library folders (провери папките на Библиотеката)	Данните и свободното място на всяка папка. Тестът за запис и hardlink върви само при стартиране, при Run now (пусни сега) и когато папките се променят.
Look for missing subtitles, Look for better subtitles (търси липсващи субтитри, търси по-добри субтитри)	Папката до всяко видео.

• Сложи /config и папката за изтегляне на SSD или кеш пул.
• Дръж 1 GB свободно на диска, който държи /config. Под това получаваш предупреждение за здравето.
• На Unraid плъгинът Cache Directories държи списъците с папки в паметта, така че сканиранията не ползват диска.
• Импортирането, добавянето и изтриването докосват диска, с който работят, когато се случат.
• Задай повторното сканиране на всеки 7 дни или го изключи. Файловете, които добавяш на ръка, тогава се намират само когато натиснеш Run now на Rescan the Library.
• Торент, който се раздава, чете файла си. Ако е свързан с hardlink в Библиотеката ти, този диск остава буден, докато раздаването не спре.

Ако не работи

Проблем	Причина	Решение
Не стартира, назовава FUSE път, мрежова папка или потребителска папка на Unraid	/config не е на локален диск (на Unraid сочи към /mnt/user)	Премести /config на път на локален диск или пул, например /mnt/<pool>/appdata/holyarrs.
Остава спрян след рестарт или възстановяване	Автоматичният рестарт е изключен	Включи го и стартирай контейнера.
Импортите се провалят с грешка за права	Потребителят PUID не може да пише в медията	Дай му четене и запис в екрана за права на NAS (на Synology: Control Panel > Shared Folder > Edit > Permissions).
Импортите са копия, не hardlink	Изтеглянията и Библиотеката са на различни монтирания или дискове	Монтирай една обща папка веднъж, в HolyArrs и в програмата за изтегляне.

Още решения: Отстраняване на проблеми.

За експерти

Защо HolyArrs отказва някои пътища за конфигурация

HolyArrs държи базите си данни в /config. Мрежовите папки и FUSE пътищата могат да ги повредят, затова HolyArrs отказва да стартира на такъв и казва защо.

На Unraid /mnt/user е FUSE път. Ползвай път на пул или направи appdata Exclusive: включи Permit exclusive shares (разреши изключителни споделени папки) в Settings > Global Share Settings, после задай за Shares > appdata основно хранилище един пул и вторично хранилище няма.

Път /config на пул, който не съществува, се озовава в паметта и се губи при рестарт. HolyArrs отказва и това. Избягвай /mnt/user и за медия; hardlink през него могат да се провалят.

Защо автоматичният рестарт има значение

Рестартът в приложението, безопасният режим и възстановяването на резервно копие спират HolyArrs и очакват Docker да го стартира отново. Без автоматичен рестарт остава спрян. Виж Модули и безопасен режим.

Порт и актуализации

• Пренасочи порт 6262 само към домашната си мрежа. Прочети Основи на сигурността, преди да го отвориш за някого отвън.
• За да актуализираш, изтегли новия образ и създай контейнера наново. Данните ти остават в /config. Виж Актуализации.

Свързано

• Папки
• Папки на Библиотеката
• Графици