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 (в Unraid это nobody:users) и 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, а внутри media — папки downloads, movies, tv и music.
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 заботится сам. Включите автоматический перезапуск контейнера (политика Docker unless-stopped).

Чтобы работали жёсткие ссылки, которые не занимают лишнего места и создаются мгновенно, смонтируйте одну папку с медиа вместо четырёх и дайте загрузчику ту же точку монтирования по тому же пути. См. Папки с медиа.

Варианты выбора

Отдельные точки монтирования

Монтировать /movies, /tv, /music и /downloads по одной можно, но тогда каждый импорт — это полная копия. Каждая точка монтирования внутри контейнера — отдельная файловая система, а жёсткая ссылка не может пересечь границу файловых систем. Отдельные общие папки или датасеты под одним родителем тоже копируются. Settings > Library folders (настройки > папки Медиатеки) предупреждает, когда HolyArrs приходится копировать.

Дайте дискам спать

Эти задания будят диски с медиа. Изменить их частоту можно на странице Schedules (расписания).

Задание	Что читает
Rescan the Library (пересканировать Медиатеку)	Каждую папку Медиатеки. Будит диски чаще всего.
Check Library folders (проверить папки Медиатеки)	Сведения о каждой папке и свободное место. Тест записи и жёстких ссылок идёт только при запуске, по Run now (запустить сейчас) и когда меняются папки.
Look for missing subtitles (искать недостающие субтитры), Look for better subtitles (искать субтитры получше)	Папку рядом с каждым видео.

• Разместите /config и папку загрузок на SSD или кэш-пуле.
• Держите 1 GB свободным на диске, где лежит /config. Если места меньше, появится предупреждение об исправности.
• В Unraid плагин Cache Directories держит списки папок в памяти, так что сканирование не трогает диск.
• Импорт, добавление и удаление обращаются к диску, с которым работают, в момент самой операции.
• Поставьте пересканирование раз в 7 дней или выключите его. Тогда файлы, добавленные вручную, находятся, только когда вы нажимаете Run now у Rescan the Library.
• Торрент на раздаче читает свой файл. Если он связан жёсткой ссылкой с вашей Медиатекой, этот диск не уснёт, пока раздача не закончится.

Если не работает

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

Другие решения: Устранение неполадок.

Для опытных

Почему HolyArrs отказывается от некоторых путей конфигурации

HolyArrs хранит свои базы данных в /config. Сетевые папки и пути FUSE могут их повредить, поэтому на таком пути HolyArrs отказывается запускаться и говорит почему.

В Unraid /mnt/user — это путь FUSE. Используйте путь на пуле или сделайте appdata эксклюзивной: включите Permit exclusive shares (разрешить эксклюзивные общие папки) в Settings > Global Share Settings (настройки > общие настройки папок), затем в Shares > appdata (общие папки > appdata) задайте основное хранилище на одном пуле, а вторичное — «нет».

Путь /config на пуле, которого не существует, попадает в память и теряется при перезагрузке. HolyArrs отказывается и от этого. Для медиа тоже избегайте /mnt/user; жёсткие ссылки через него могут не сработать.

Почему важен автоматический перезапуск

Перезапуск из приложения, Безопасный режим и восстановление резервной копии останавливают HolyArrs и ждут, что Docker запустит его снова. Без автоматического перезапуска он остаётся остановленным. См. Части и Безопасный режим.

Порт и обновления

• Пробрасывайте порт 6262 только в домашнюю сеть. Прочитайте Основы безопасности, прежде чем открывать его кому-то снаружи.
• Чтобы обновиться, скачайте новый образ и пересоздайте контейнер. Ваши данные остаются в /config. См. Обновления.

См. также

• Папки
• Папки Медиатеки
• Расписания