Immich — self-hosted фото-библиотека вместо Google Photos

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

Проект открытый, распространяется под лицензией GNU AGPL v3 и ставится через Docker Compose на VPS, мини-ПК или NAS. Сама установка занимает минут пятнадцать, а вот первичная обработка большой библиотеки — превью, распознавание лиц, векторы поиска — идёт часами. Это руководство покрывает полный цикл: требования к железу, установка, настройка поиска, рабочие сценарии и проверка результата.

Что такое Immich

Immich — сервер для фото и видео с веб-интерфейсом и мобильными приложениями для iOS и Android. Внутри это несколько контейнеров: сервер, машинное обучение, кэш-сервис (Redis/Valkey) и Postgres с векторным расширением VectorChord, на котором работает контекстный поиск.

Основные возможности

Как устроен поиск

Поиск живёт в Postgres: метаданные и векторы CLIP лежат в одной базе, векторную часть обслуживает расширение VectorChord. Кроме свободных запросов доступны фильтры: люди, альбом, имя файла или расширение, папка исходного пути, описание, текст на изображении, локация, теги, камера и объектив, период, тип медиа, рейтинг.

Модель поиска выбирается в Administration → Settings → Machine Learning Settings → Smart Search. Модель по умолчанию быстрая, но качество ранжирования у более крупных моделей выше.

Требования к железу

Под превью и транскоды закладывайте дополнительно 10–20% к размеру библиотеки. Файлы базы обычно занимают 1–3 ГБ.

Запуск Docker внутри LXC-контейнера проект не рекомендует. Для amd64 последняя версия с поддержкой старых процессоров уровня x86-64-v1 — v2.7.5, и она больше не поддерживается.

Установка через Docker Compose

Шаг 1. Заготовка каталога

mkdir ./immich-app
cd ./immich-app
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

Шаг 2. Переменные окружения

Шаг 3. Запуск

docker compose up -d

Веб-интерфейс поднимется на порту 2283, первый вошедший пользователь становится администратором.

После установки

Структура хранения файлов

Storage template определяет, как сервер раскладывает оригиналы по папкам на диске. Шаблон по умолчанию — Year/Year-Month-Day/Filename.Extension, меняется в Administration → Settings → Storage Template. Настраивайте его до массовой загрузки: после смены шаблона существующие файлы перекладывает отдельная задача Storage Template Migration, и на большой библиотеке это надолго.

Аппаратное ускорение

На мини-ПК и NAS процессор упирается в двух местах: перекодирование видео и машинное обучение. Транскодинг ускоряется через NVENC (NVIDIA), Quick Sync (Intel), VAAPI (AMD, Intel, NVIDIA) и RKMPP (Rockchip). Включается это не галочкой: рядом с docker-compose.yml кладётся файл hwaccel.transcoding.yml из релиза, в сервисе immich-server раскомментируется секция extends, значение cpu меняется на нужный бэкенд, и только потом ускорение выбирается в настройках транскодинга. Для машинного обучения в документации есть отдельный раздел Hardware-Accelerated Machine Learning.

Практические сценарии

Перенос архива с телефона

1. Установите мобильное приложение и укажите адрес сервера
2. Войдите под своей учётной записью
3. Включите бэкап и выберите альбомы устройства
4. Оставьте телефон на зарядке в Wi-Fi до окончания первой загрузки
5. Проверьте счётчик оставшихся файлов в разделе бэкапа

Индексация существующего архива на диске

Если фото уже лежат в структуре папок на NAS, не копируйте их внутрь медиатеки. Подключите каталог в docker-compose.yml и добавьте его как внешнюю библиотеку в Administration → External Libraries: Immich проиндексирует файлы и оставит их на месте.

Что важно знать заранее:

• Монтируйте каталоги с флагом :ro. Без него Immich сможет удалить ваши исходники из веб-интерфейса.
• В настройках библиотеки указывается путь, который видит контейнер, а не путь на хосте.
• Библиотека принадлежит одному пользователю, и владельца нельзя сменить после создания.
• Ненужное отсекайте exclusion patterns: **/Raw/** для сырых кадров, **/\@eaDir/** для служебных папок Synology.
• Метаданные, добавленные внутри Immich (альбомы, описания), в файлы не записываются и теряются при перемещении файла в другое место библиотеки.
• Удалённый с диска файл при пересканировании уходит в корзину и окончательно исчезает через 30 дней.
• Автослежение за файловой системой помечено как экспериментальное и на сетевых дисках обычно не работает — полагайтесь на ночное пересканирование.
• Просмотр по папкам включается отдельно: Account Settings → Features → Folders.

Совместный доступ

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

Обновление

Закрепите версию в IMMICH_VERSION, читайте примечания к релизу и обновляйте контейнеры после свежего бэкапа базы. Проект развивается быстро, ломающие изменения встречаются.

Бэкапы и восстановление

Начиная с версии 2.5.0 Immich делает дампы базы сам: они складываются в UPLOAD_LOCATION/backups, по умолчанию создаются ежедневно в 2:00 и хранятся последние 14 штук. Расписание и глубину хранения меняют в Administration → Settings → Backup, разовый дамп запускают через Administration → Job Queues → Create job → Create Database Dump.

Что копировать

Порядок снятия копии

Лучший вариант — остановить контейнер immich-server на время бэкапа: тогда база и файлы гарантированно согласованы. Если останавливать нельзя, снимайте сначала базу, потом файлы. В худшем случае на диске окажутся файлы, о которых база не знает, — их можно дозалить руками. В обратном порядке база будет ссылаться на файлы, которых в копии нет, и вы получите битые ассеты.

Восстановление

Штатный путь — через интерфейс: Administration → Maintenance → Restore database backup, выбрать дамп из списка или загрузить .sql.gz. Перед восстановлением Immich создаёт точку отката и при неудаче возвращается к ней. На чистой установке тот же сценарий доступен на экране приветствия по кнопке «Restore from backup» — предварительно верните папки данных в новый UPLOAD_LOCATION.

Ручное восстановление через psql требует установки, в которой сервер ещё ни разу не запускался, либо переменной DB_SKIP_MIGRATIONS=true. Дампы, снятые до версии 2.5.0, восстанавливаются по инструкции для соответствующей версии документации.

Проверка результата

Антипаттерны

Чеклист

Подготовка

Установка

Настройка

Эксплуатация

Полезные ссылки

• Immich: официальный сайт — обзор возможностей и демо
• Immich: документация — установка, настройка, администрирование
• Immich: требования — железо, ОС, файловые системы
• Immich: установка через Docker Compose — пошаговая инструкция и типичные ошибки
• Immich: переменные окружения — полный справочник настроек
• Immich: поиск — фильтры и сравнение CLIP-моделей по языкам
• Immich: бэкап и восстановление — автоматические дампы, порядок копирования, восстановление
• Immich: внешние библиотеки — монтирование, шаблоны исключений, ограничения
• Immich: аппаратное транскодирование — NVENC, Quick Sync, VAAPI, RKMPP
• Immich: шаги после установки — администратор, storage template, мобильные приложения
• GitHub: immich-app/immich — исходники, релизы, лицензия AGPL v3
• Immich: демо-стенд — интерфейс и фильтры поиска без установки

По теме

• Статья: Как я разобрал Яндекс.Диск через Codex и официальный доступ Яндекса
• Блог: «Пиратская бухта» для ИИ-моделей: скачал и запустил у себя
• База знаний: Synology DSM — NAS как домашний сервер

Собрать фото-архив у себя проще, чем кажется, а вот эксплуатация и бэкапы требуют дисциплины. Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov