Immich на TerraMaster: хранение фотографий и резервное копирование

Immich на TerraMaster позволяет собирать фотографии и видео с телефонов в домашнем архиве, просматривать их в приложении и подключать уже существующие папки. Для установки нужен NAS с Docker и достаточным объёмом памяти. Чтобы восстановить архив после сбоя NAS, нужны копии медиафайлов и базы данных Immich.

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

Какой TerraMaster подойдёт для Immich

Проверьте наличие Docker Engine в центре приложений вашей модели, архитектуру процессора и свободную память. Immich работает на amd64 и arm64; минимальные требования — два ядра и 6 ГБ RAM, рекомендуемые — четыре ядра и 8 ГБ. Для amd64 в ветке v3 контейнер машинного обучения требует инструкции x86-64-v2. Проверьте расход памяти в TOS при работающих приложениях: часть установленной RAM уже занята системой и другими сервисами.

На устройстве с 4 ГБ возможен запуск с отключённым машинным обучением, однако покупать такую конфигурацию ради распознавания лиц и умного поиска не стоит. Базу PostgreSQL желательно размещать на локальном SSD; сетевой ресурс SMB/NFS для её каталога не подходит. Под миниатюры и перекодированные видео оставляйте дополнительное место.

TerraMaster F2-424 имеет два дисковых отсека, Intel N95 и 8 ГБ DDR5. F4-424 Pro предлагает четыре отсека, Core i3-N305 и 32 ГБ DDR5: больший объём памяти полезен, если рядом работают другие контейнеры. Два отсека ограничивают число устанавливаемых дисков; четыре оставляют больше вариантов расширения архива.

Установка в TOS: проект, папки и параметры

Если NAS ещё не подготовлен, сначала выполните установку сетевого хранилища: создайте том, проверьте состояние дисков и доступ из домашней сети.

  1. Установите Docker Engine и менеджер контейнеров. В TOS 6 он называется Docker Manager; в новых версиях TOS 7 — Container Manager. Откройте раздел Projects: он разворачивает связанные контейнеры из Compose-файла.
  2. Создайте отдельную папку проекта. Поместите в неё актуальные docker-compose.yml и example.env из одного стабильного выпуска Immich; второй файл переименуйте в .env. Не смешивайте старый сторонний YAML с параметрами нового выпуска.
  3. В .env задайте UPLOAD_LOCATION для загружаемых медиа и DB_DATA_LOCATION для PostgreSQL. Укажите реальные пути на вашем NAS, часовой пояс и собственный пароль базы. Эти каталоги должны сохраняться при пересоздании контейнеров.
  4. Создайте проект в менеджере, укажите его папку и YAML, проверьте конфигурацию и примените. Убедитесь, что менеджер читает .env из папки проекта. При работе через терминал проверьте docker compose version; устаревшая команда docker-compose не является поддерживаемой заменой.
  5. После запуска откройте в домашней сети http://IP-NAS:2283, если порт не меняли. Создайте администратора, затем отдельные учётные записи пользователей. Сначала загрузите небольшую подборку фото и видео.

Если проект не запускается, откройте журнал. При отказе записи проверьте права на указанную в ошибке папку; при отклонении YAML — версию Compose и строку, на которую он указывает. Не выдавайте всем пользователям полный доступ ко всему тому ради устранения одной ошибки.

Куда попадут фотографии: два разных способа

ЗадачаСпособЧто учесть
Собирать новые снимки с телефонаЗагрузка через приложение ImmichФайлами управляет Immich в каталоге UPLOAD_LOCATION. Не перемещайте их вручную.
Показывать старый архив с собственной структурой папокВнешняя библиотекаПапку нужно подключить в контейнер и добавить её внутренний путь в библиотеку. Изменения файлов требуют сканирования.

Условный пример: папка NAS /Volume2/Photos подключена в контейнер как /mnt/photos:ro. В настройках внешней библиотеки нужен путь /mnt/photos, а не имя общей папки в проводнике. Режим :ro оставляет исходники доступными контейнеру только для чтения. Фактический путь тома проверьте в своей TOS.

Внешняя библиотека не создаёт вторую копию исходников. Альбомы и описания, добавленные в Immich, хранятся в его базе; переезд файла в другую папку может привести к потере этих связей после сканирования. Подключайте архив с устойчивой структурой каталогов.

Автозагрузка с телефона и доступ вне дома

В мобильном приложении укажите адрес сервера, войдите под своей учётной записью, откройте экран резервного копирования и выберите альбомы. По умолчанию загрузка выполняется по Wi-Fi. На Android энергосбережение может останавливать фоновую задачу, на iOS её запуск зависит от ограничений системы: при первой большой загрузке оставьте приложение открытым и подключите телефон к зарядке.

Проверьте результат с другого устройства: откройте несколько оригиналов и длинное видео, а не только миниатюры. Если дома всё работает, а через мобильный интернет нет, проверьте доступ к серверу. Для подключения извне используйте VPN либо правильно настроенный обратный прокси с HTTPS. Простой проброс порта 2283 в интернет оставляет соединение HTTP незащищённым. Доступ к панели TOS сам по себе не настраивает доступ к Immich.

Что копировать и как проверить восстановление

Сохраняйте весь UPLOAD_LOCATION, дамп базы, docker-compose.yml и .env. Внешние библиотеки копируются отдельно. Автоматический дамп Immich в подпапке backups содержит метаданные, но не фотографии. Переносите резерв за пределы NAS: копия на соседнем томе остаётся зависимой от того же устройства.

Для согласованной копии приостановите загрузки и фоновые задания, создайте свежий дамп, затем на время копирования остановите проект. Не подменяйте дамп обычным копированием работающего каталога PostgreSQL. Включите уведомления об ошибках и хранение нескольких версий копии в рамках управления сетевым хранилищем.

Пробное восстановление проводите в отдельном экземпляре, не поверх рабочего архива. Верните папки и настройки подключений. В актуальном интерфейсе восстановление дампа доступно при первоначальной настройке; в работающем экземпляре — через Administration → Maintenance. Перед восстановлением сверьте версию сервера и дампа. Проверьте вход пользователей, альбомы, оригиналы и воспроизведение видео. Сохраните дату копии и версию сервера, с которой она сделана.

Как обновлять без потери настроек

Перед обновлением прочитайте примечания к выпуску и сделайте резервную копию. Сравните Compose-файл с новым шаблоном, сохранив свои пути и параметры. В папке проекта обновление образов и пересоздание контейнеров выполняют последовательно:

docker compose pull
docker compose up -d

Команда Clear («Очистить») в менеджере TerraMaster может удалить связанные тома данных — для обычного обновления она не нужна. После запуска проверьте журнал, загрузку с телефона и открытие старых снимков. Не рассчитывайте на откат одной заменой тега образа: понижение версии Immich не поддерживается.