Люди, ищущие информацию по запросу Immich self-hosted фото, обычно задают два практических вопроса: может ли этот проект с открытым исходным кодом организовать личную фото- и видеотеку, и что потребуется для его безопасной работы? Immich — репозиторий для самостоятельно размещаемого управления фотографиями и видео. Он не заменяет отдельную систему резервного копирования. Это различие следует учитывать с самого начала развертывания.
Репозиторий был представлен в предоставленном снимке ежедневного рейтинга GitHub 2026-08-18. Это контекст, актуальный на определенную дату, а не утверждение о долговременной популярности. На момент исследования API GitHub показывал общедоступный репозиторий immich-app/immich на main под лицензией AGPL-3.0. Конечная точка последнего релиза вернула v3.1.0, опубликованный 2026-07-29. Эти значения могут измениться, поэтому перед развертыванием ознакомьтесь с текущими примечаниями к выпуску и документацией.
Что документируют README и исходный код
В таблице функций README перечислены загрузка и просмотр через веб-интерфейс и мобильные приложения, резервное копирование с мобильных устройств, альбомы, общие альбомы, поддержка нескольких пользователей, представления метаданных и карт, исходные форматы, LivePhoto и MotionPhoto, OAuth, публичный доступ, задаваемая пользователем структура хранения, распознавание лиц и кластеризация, воспоминания, а также поиск по метаданным, объектам, лицам и CLIP. Таковы возможности, документированные сопровождающими проекта. Это не независимое тестирование производительности, не обещание одинакового поведения на каждом устройстве и не сертификат безопасности.
Репозиторий распространяется по лицензии AGPL-3.0. Если вы изменяете программное обеспечение AGPL и эксплуатируете его как сетевую службу, изучите условия лицензии вместе с юридическим консультантом или специалистом по комплаенсу. Эта статья не является юридической консультацией.
Требования перед установкой
На текущей странице с требованиями рекомендуется операционная система на базе Linux или Unix-подобная операционная система с разрядностью 64 бит. В ней указано не менее 6 GB оперативной памяти, при этом рекомендуется 8 GB, а также не менее 2 ядер ЦП, при этом рекомендуется 4. Рекомендуется использовать файловую систему, совместимую с Unix, которая сохраняет права собственности и разрешения. В документации Immich описаны образы amd64 и arm64. Начиная с версии 3, контейнер машинного обучения amd64 требует микроархитектурного уровня x86-64-v2.
В используемом программном обеспечении применяется Docker с плагином Docker Compose. Поддерживаемая команда — docker compose; более старая команда docker-compose больше не поддерживается командой Immich. По возможности храните каталог данных PostgreSQL на локальном SSD-накопителе. Разработчики утверждают, что сетевая папка не подходит для этой базы данных, и отмечают, что миниатюры и перекодированное видео могут увеличить объем занимаемой библиотекой памяти.
Эти значения являются опубликованными исходными ориентирами, а не планом расчёта ёмкости. Размер библиотеки, нагрузка, связанная с видео, количество одновременных пользователей и необязательные задания машинного обучения могут изменить требования к ресурсам. Оцените характеристики используемого узла и подготовьте план отката изменений.
Ограниченная конфигурация Docker Compose
Разработчики рекомендуют Docker Compose для использования в рабочей среде. Используйте файлы текущего выпуска, а не копируйте старый файл compose из сообщения на форуме:
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Задайте для UPLOAD_LOCATION новый каталог с достаточным объёмом свободного места. Проверьте остальные значения в .env, включая TZ и параметры базы данных. В руководстве по установке предлагается изменить DB_PASSWORD; не храните секреты в истории командной оболочки, тикетах, снимках экрана и общедоступных репозиториях. Проверив файлы, запустите службы из того же каталога:
docker compose up -dЭто схема развёртывания, а не команда, которую следует выполнять на ненадёжном узле. Загружайте файлы выпуска по HTTPS, убедитесь, что узел и хранилище принадлежат вам, и ограничьте круг лиц, имеющих доступ к сокету Docker и учётной записи администратора Immich.
Резервное копирование, доступ и конфиденциальность
Создавайте резервные копии базы данных и оригиналов
В документации по резервному копированию Immich это сформулировано однозначно: автоматические дампы базы данных содержат метаданные и пути к файлам, но не фотографии и видео. База данных по-прежнему необходима, поскольку Immich не восстанавливает библиотеку путем сканирования папок. План восстановления должен включать как дампы базы данных, так и исходные медиафайлы.
В документации указаны следующие расположения исходного контента:
UPLOAD_LOCATION/libraryUPLOAD_LOCATION/uploadUPLOAD_LOCATION/profile
Полный UPLOAD_LOCATION также содержит сгенерированные миниатюры, закодированное видео и файлы дампов базы данных. Можно выбрать более узкий набор, но в документации предупреждается: если исключить сгенерированный контент, после восстановления придется повторно запускать задания по созданию миниатюр и транскодированию. Используйте внешний инструмент резервного копирования, храните как минимум три копии на двух типах носителей, причем одну копию держите за пределами основной площадки, и периодически выполняйте пробное восстановление. Immich подготавливает данные к резервному копированию, но не выполняет за вас весь процесс 3-2-1.
Ограничьте доступ из сети
Если вы используете обратный прокси перед Immich, следуйте рекомендациям разработчиков для Host, X-Real-IP, X-Forwarded-Proto и X-Forwarded-For и разрешите загрузку файлов достаточного размера для ваших медиафайлов. Адрес Immich находится в корне домена или поддомена, а не по пути типа /immich. Используйте HTTPS на внешнем периметре, защищайте учетные записи администраторов надежными уникальными учетными данными и подходящим методом аутентификации, а также открывайте только те порты и маршруты, которые действительно нужны.
Обновляйте сервер и мобильные клиенты одновременно. В руководстве по обновлению указано ознакомиться с примечаниями к выпуску, обновить IMMICH_VERSION после его закрепления и запустить docker compose pull && docker compose up -d. Сервер должен соответствовать основной версии клиента; понижение версии не поддерживается. Перед крупным обновлением или миграцией базы данных создайте свежую резервную копию базы данных и медиафайлов.
Что изменилось в датированной версии?
В примечаниях к выпуску v3.1.0 упоминаются изменение синхронизации ролевых утверждений OIDC, аннулирование сеансов при сбросе пароля администратора, блокировка перехода веб-загрузки в спящий режим, фильтрация рабочего процесса метаданных EXIF и прекращение поддержки iOS 14. Это наблюдения из примечаний к выпуску, а не утверждение о том, что каждый пункт актуален для вашей установки. Непосредственно перед обновлением ознакомьтесь со страницей выпуска, чтобы проверить наличие критических изменений и примечаний по миграции.
Где подходит OdiRouter и где он не подходит
OdiRouter — отдельный от проекта immich-app/immich. На главной странице OdiRouter описаны API моделей для разработчиков, среда выполнения агентов и инструменты для GPU-нагрузок. Это не подтверждает наличие интеграции Immich, отношений в сфере хостинга, сервиса резервного копирования или поддержки конкретной модели. Переходите на OdiRouter только в том случае, если отдельно оцениваете эти инфраструктурные сервисы для разработчиков.
Чего не подтверждают имеющиеся данные
Репозиторий и документация сопровождающих проекта лиц не содержат подтвержденных данных о посещаемости, объеме поисковых запросов по ключевым словам, количестве обратных ссылок, уровне распространения, результатах тестирования, оценке совокупной стоимости владения, универсальной рекомендации по оборудованию, независимом аудите безопасности или гарантии того, что каждый дополнительный ускоритель будет работать на вашем узле. Размещение в разделе Trending с указанной датой не подтверждает ни одно из этих утверждений. Протестируйте именно тот релиз, комплект оборудования, вариант хранения данных, обратный прокси и процедуру восстановления, которые планируете использовать.
Источники
Повторно проверьте эти источники перед публикацией обновления. Релизы, требования и контакты для связи по вопросам безопасности могут изменяться.