Перейти к основному содержимому

Файлы - Настройка пользовательских мест хранения

В этом руководстве объясняется, как хранить сгенерированные и исходные файлы с использованием монтирования томов Docker в разных местах.

:::cautionРезервное копирование Важно помнить о необходимости обновления настроек резервного копирования после выполнения данного руководства, чтобы создать копии новых путей, особенно profile/, если используются инструменты автоматического резервного копирования. :::

В нашем .env файле мы определим пути, которые хотим использовать. Обратите внимание, что вы не обязаны указывать все из них. UPLOAD_LOCATION будет базовой папкой, куда по умолчанию будут сохраняться файлы, а остальные пути будут служить для переопределения.

.env
# Документацию по всем поддерживаемым переменным окружения можно найти [здесь](/docs/install/environment-variables)

# Пользовательское место хранения загруженных файлов, эскизов и перекодированных видеозаписей
- UPLOAD_LOCATION=./library
+ UPLOAD_LOCATION=/custom/path/immich/immich_files
+ THUMB_LOCATION=/custom/path/immich/thumbs
+ ENCODED_VIDEO_LOCATION=/custom/path/immich/encoded-video
+ PROFILE_LOCATION=/custom/path/immich/profile
+ BACKUP_LOCATION=/custom/path/immich/backups
...

После определения мест хранения этих файлов, мы редактируем файл docker-compose.yml соответственно и добавляем новые переменные в контейнер immich-server. Эти пути являются местами привязки внутри контейнера, поэтому их не нужно менять.

docker-compose.yml
services:
  immich-server:
      volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
+     - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
+     - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+     - ${PROFILE_LOCATION}:/usr/src/app/upload/profile
+     - ${BACKUP_LOCATION}:/usr/src/app/upload/backups
      - /etc/localtime:/etc/localtime:ro

После внесения этих изменений вам необходимо переместить файлы в новые папки, чтобы убедиться, что Immich может найти все необходимое. Если вы еще ничего важного не загрузили, можно полностью сбросить настройки Immich, удалив папку базы данных. Затем перезапустите Immich, чтобы зарегистрировать изменения:

docker compose up -d
заметка

Из-за свойств монтирования Docker не рекомендуется монтировать папки upload/ и library/ как отдельные точки монтирования, если они находятся на одном устройстве. По этой причине мы монтируем HDD или сетевое хранилище (NAS) в /usr/src/app/upload, а затем монтируем папки, к которым хотим получить доступ, внутри этой папки.

Папка thumbs/ содержит как маленькие эскизы, отображаемые на временной линии, так и большие превью, показанные при нажатии на изображение. Они не могут быть разделены.

Метрики хранения Immich-сервера будут отслеживать доступное место в UPLOAD_LOCATION, поэтому администратор должен настроить мониторинг, чтобы убедиться, что место не закончится. Папка profile/ намного меньше, обычно меньше 1 МБ.