Lychee

Lychee — самостоятельная веб-галерея для фотографий: приложение устанавливается на собственный сервер или подходящий веб-хостинг, после чего пользователь загружает снимки, распределяет их по альбомам, редактирует названия и описания, работает с метаданными, тегами и географией, а затем при необходимости открывает выбранные альбомы другим людям. Главный сценарий Lychee — не локальное редактирование изображений на одном компьютере, а управление личной или небольшой совместной медиатекой через браузер с контролем над местом хранения и правилами доступа. Текущая стабильная версия — 7.7.4; готовый пакет Lychee.zip для этой версии имеет размер 49,1 МБ. Программа распространяется как открытый исходный код под лицензией MIT, а часть дополнительных возможностей вынесена в Supporter Edition и отдельный Webshop Pro.

Что представляет собой Lychee и как точно идентифицировать программу

Lychee проекта LycheeOrg — серверное приложение для управления фотографиями. Это важно из-за совпадения названия с продуктами из других областей, в частности с программами для подготовки моделей к 3D-печати. У нужного здесь Lychee исходный код размещён в организации LycheeOrg, основной репозиторий называется Lychee, а актуальная линейка релизов в августе 2026 года относится к ветке 7.x. Назначение проекта однозначно связано с photo management: веб-интерфейсом для загрузки, просмотра, систематизации и публикации фотографий и поддерживаемых видеороликов.

Lychee не является настольным просмотрщиком, который открывает отдельную папку двойным щелчком, и не является облачным сервисом с обязательным хранением данных у стороннего провайдера. Серверная часть должна работать постоянно там, где находятся веб-сервер, PHP и база данных либо Docker-окружение. Пользователь обращается к уже запущенному экземпляру через браузер. Поэтому установка и эксплуатация состоят из двух разных уровней: администратор поддерживает сервер и обновления, а обычные участники работают с альбомами, фотографиями и общим доступом.

У проекта есть историческое ответвление Lychee-v3. Его репозиторий переведён в режим read-only и относится к прежней архитектуре; для новой установки его использовать не следует. Современная линия продолжает развитие в LycheeOrg/Lychee. Версия 4 стала границей перехода от старого репозитория к новой кодовой базе, а позднее проект прошёл через несколько крупных изменений серверной и клиентской части. Текущий выпуск 7.7.4 является неизменяемым релизом GitHub и датирован 19 августа 2026 года; последующие коммиты в ветке master относятся к разработке и не меняют номер последнего стабильного выпуска.

Программа ориентирована прежде всего на изображения, но современная документация перечисляет и видеоформаты. Это не превращает Lychee в видеоредактор: видео помещаются в ту же библиотечную модель, а для генерации видеоминиатюр при ручной установке рекомендован FFmpeg. Аналогично ExifTool и Imagick расширяют качество обработки метаданных и миниатюр, но не являются обязательными для базового запуска.

Назначение и целевая аудитория

Lychee полезен там, где требуется аккуратно представить и систематизировать фотографии, не отдавая управление библиотекой внешнему фотосервису. Типичная аудитория — фотограф, владелец домашнего сервера или NAS, семья с общей медиатекой, небольшая команда, которой нужны разграниченные альбомы, либо автор сайта, публикующий отдельные коллекции. Встроенная модель альбомов особенно удобна для событий, поездок, фотосессий и проектов, когда материал естественно делится на самостоятельные наборы.

Для фотографа важны три свойства. Во-первых, Lychee показывает исходные снимки и создаёт варианты для просмотра, при этом загрузка не сводится к безвозвратному уменьшению файла. Во-вторых, интерфейс умеет извлекать и отображать EXIF, а при наличии координат — показывать фотографии на карте. В-третьих, альбом можно сделать публичным, защитить паролем, ограничить скачивание или предоставить доступ конкретным зарегистрированным пользователям. Такой набор подходит для портфолио, семейной подборки и передачи клиенту галереи на просмотр.

Домашний администратор получает самостоятельный экземпляр, поэтому место на диске, резервное копирование и доменное имя определяются его инфраструктурой. В самой бесплатной редакции нет продуктового лимита на число альбомов и загрузок, однако физическая вместимость всегда ограничена диском, файловой системой, базой данных, настройками PHP и ресурсами сервера. Для большой медиатеки это принципиальное различие: отсутствие искусственной квоты не означает бесконечной ёмкости.

Lychee менее удачен для пользователя, которому нужен полностью автоматический мобильный бэкап «как в телефоне» без обслуживания сервера, либо сложный AI-каталог с распознаванием объектов уже сегодня. В документации распознавание лиц помечено как функция v8, то есть оно относится к следующему поколению, а не к стабильной 7.7.4. Для текущей версии основу каталогизации составляют альбомы, вложенные альбомы, теги, поиск, рейтинг, избранное, хронология и геоданные.

Командный сценарий возможен благодаря нескольким учётным записям, правам на уровне альбома и совместному доступу между пользователями. Бесплатная версия уже поддерживает несколько пользователей и базовые права, а Supporter Edition добавляет группы, квоты на загрузку, учёт занимаемого места, заметки администратора и несколько администраторов. Это делает платную надстройку осмысленной там, где экземпляром пользуются не два человека, а постоянная группа с различными ролями.

Модель распространения и лицензирование

Базовый Lychee распространяется бесплатно с открытым исходным кодом под лицензией MIT. Готовые стабильные сборки публикуются в виде ZIP-пакета, параллельно поддерживается контейнерный запуск. Для версии 7.7.4 релизный пакет Lychee.zip занимает 49,1 МБ; вместе с ним опубликованы данные Sigstore и контрольная сумма SHA-256. Наличие отдельного готового пакета важно для shared hosting и ручной установки: администратору не обязательно собирать фронтенд npm и зависимости Composer из исходников.

Контейнерный канал использует образы LycheeOrg. В ветке 7 основным рантаймом контейнера стал FrankenPHP. Для быстрого старта предлагается минимальная Docker Compose-конфигурация с MariaDB и постоянными томами, а для более производительного развертывания — полный Compose-вариант с worker-процессами. Образ с тегом latest относится к стабильной линии, тогда как edge предназначен для разработки; смешивать эти каналы на рабочем сервере без причины не стоит.

Supporter Edition не заменяет бесплатный проект другим закрытым приложением. Код остаётся под MIT, но дополнительные возможности активируются лицензионным ключом поддержки. На странице редакций указана подписка 5 евро в месяц; пробного периода и возврата средств нет, поэтому сначала имеет смысл развернуть бесплатную редакцию и проверить совместимость с собственным сервером и рабочим процессом. Среди возможностей SE находятся расширенная статистика, группы пользователей, квоты, водяные знаки, защищённые ссылки, дополнительные варианты оформления и часть расширенных настроек Flow и Timeline.

Webshop Pro — отдельная надстройка для продажи цифровых или печатных вариантов снимков. Она добавляет корзину, варианты цен и лицензий, обработку заказов и способы оплаты, в том числе Mollie, PayPal и офлайн-оплату. Для домашней фототеки этот модуль не нужен; его наличие не следует принимать за обязательную часть Lychee или за свойство бесплатной редакции.

Практически модель распространения даёт три пути. Docker Compose требует меньше ручной настройки PHP и веб-сервера. ZIP-релиз подходит хостингу или администратору, который уже обслуживает Apache/nginx и базу данных. Сборка из исходников нужна разработчикам и тем, кто сознательно управляет Composer/npm. Выбирать способ лучше по инфраструктуре, а не по тому, какой вариант выглядит технически сложнее: в рабочей системе наиболее важны повторяемое обновление, понятные тома с фотографиями и базой и наличие резервной копии.

Интерфейс: основные области, команды и навигация

Интерфейс Lychee построен вокруг галереи, а не вокруг таблицы файлов. После входа пользователь видит альбомы или содержимое выбранного альбома крупными миниатюрами. В верхней панели находятся действия создания и загрузки; текущая инструкция для альбомов описывает последовательность + → New Album, а для фотографий — кнопку загрузки в верхней панели либо перетаскивание файлов в окно браузера. Внутри альбома те же действия позволяют создать вложенный альбом и добавить новые снимки непосредственно в текущий уровень.

Левая область навигации используется для перехода к библиотечным представлениям и служебным разделам. В актуальных экранах и обсуждениях команды Lychee встречается название Left menu; там же доступен список существующих тегов. Настройки организованы по категориям. Для параметров отображения тегов используется путь Settings → Gallery → Expert Settings. Такое разделение важно: часть функций доступна сразу в контекстном меню объекта, а более редкие параметры вынесены в настройки галереи.

Основное пространство отдаётся фотографиям: это удобно при отборе снимков, потому что карточки не зажаты многоуровневыми панелями. В альбомах можно выбирать разные схемы раскладки — justified, masonry и square. Для отдельного альбома задаются обложка, изображение заголовка, порядок сортировки, пропорции миниатюр и тип раскладки. Поэтому одна инсталляция может одновременно содержать компактную семейную галерею и более презентационный альбом для публикации.

Меню добавления и импорта

В меню загрузки предусмотрены разные источники. Помимо локальной загрузки, Lychee умеет импортировать по ссылке, с сервера и из Dropbox. Для больших локальных файлов веб-загрузка использует chunk upload: файл делится на части, что снижает вероятность отказа из-за единственной длинной передачи. Для массового импорта из уже существующего дерева каталогов предусмотрена консольная синхронизация, поэтому сотни или тысячи файлов необязательно перетаскивать вручную через браузер.

Команда New Album создаёт логический контейнер библиотеки. Вложенность не ограничивается одним уровнем: альбомы можно помещать друг в друга. Это позволяет строить структуру «год → поездка → день» или «клиент → проект → отбор», не превращая каждую тему в отдельную независимую галерею. При этом доступ назначается на уровне альбома, поэтому структура одновременно выполняет организационную и разрешительную функцию.

Просмотр фотографии и информационная панель

При открытии снимка Lychee переходит к крупному просмотру. Информационный блок показывает основные сведения об объекте: название, дату загрузки, описание, размер изображения, формат, разрешение, теги и доступные данные камеры. При наличии EXIF в интерфейсе отображаются параметры съёмки, а координаты используются модулем Map. У пользователя остаётся возможность менять заголовок и описание, назначать теги, ставить оценку, помечать фотографию как избранную и перемещать её между альбомами.

Быстрые клавиши ускоряют отбор без постоянного обращения к меню. В списке альбомов клавиша n создаёт новый альбом, u открывает загрузку, s — поиск. Внутри альбома r меняет заголовок, d — описание, i показывает информацию, f включает полноэкранный режим. В просмотре фотографии стрелки переходят к соседним снимкам, t открывает теги, s переключает избранное, o меняет режим оверлея. Комбинации с Ctrl/Cmd используются для выбора всех объектов и удаления.

Массовые действия

Lychee допускает множественный выбор. На группе фотографий доступны операции с тегами, перемещением и другими свойствами. Это отличается от последовательного редактирования каждого файла: сначала пользователь формирует выборку, затем применяет действие ко всей группе. В текущей документации отдельно подтверждены bulk select, bulk tagging, перемещение фотографий и копирование в несколько альбомов.

Массовая работа особенно полезна после импорта одной съёмки. Сначала можно выбрать все кадры события и назначить общий тег, затем переместить технические дубли или отдельный отбор в другие альбомы. Теги при пакетной операции можно добавлять к существующим или использовать режим замены набора тегов. Для больших библиотек это снижает количество однотипных действий и делает структуру более последовательной.

Общий доступ из просмотра

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

Для публичных альбомов пароль добавляет отдельный барьер, но не заменяет TLS и нормальную защиту сервера. Для зарегистрированных пользователей доступ тоньше: можно дать чтение или запись конкретного альбома, а cross-user sharing позволяет участникам одной инсталляции совместно работать с разрешёнными коллекциями. Подобная модель удобнее одного общего логина, потому что права можно отозвать для отдельного человека, не меняя пароль всем остальным.

Теги, их отображение и Expert Settings

Теги в Lychee являются глобальными сущностями по имени, но операции обычного пользователя затрагивают только его собственные фотографии; администратор может применять изменения ко всей галерее. В отдельном Tag Management доступны переименование, объединение и удаление тегов, а список показывает количество фотографий. Поле тегов использует автодополнение. На основе одного или нескольких существующих тегов создаются динамические Tag Albums с логикой AND или OR.

Показ тегов непосредственно на миниатюрах относится к дополнительной настройке Supporter Edition. В интерфейсе этот параметр находится в Gallery/Expert Settings. Отдельно настраивается, как выводить сведения на миниатюре: постоянно или при наведении. Это полезный пример устройства Lychee: редактор не перегружает карточку всеми метаданными по умолчанию, но администратор может сделать часть информации более заметной.

С точки зрения освоения интерфейс имеет два слоя. Частые действия — загрузка, создание альбома, открытие фотографии, поиск и множественный выбор — находятся рядом с самой галереей. Более специальные параметры распределены по Settings, а некоторые возможности открываются только после включения соответствующего модуля. Поэтому при первом знакомстве разумнее сначала освоить цикл «альбом → загрузка → теги → общий доступ», а затем настраивать Timeline, Flow, Map, RSS и расширенные параметры.

Установка и первый запуск

Самый короткий путь к рабочему экземпляру — Docker Compose. Минимальная конфигурация запускает Lychee с FrankenPHP, MariaDB и постоянным хранилищем. После запуска контейнеров приложение по умолчанию доступно на локальном порту 8000; при первом посещении появляется создание учётной записи администратора. Для боевого сервера одной локальной схемы недостаточно: нужно задать внешний адрес приложения, ключ приложения, постоянные тома, резервное копирование и HTTPS через reverse proxy.

Быстрый запуск через Docker Compose

1. На сервере устанавливают Docker и Compose, затем получают минимальный файл конфигурации Lychee.
2. Стек запускают командой docker compose -f docker-compose.minimal.yaml up -d.
3. Проверяют, что контейнеры приложения и базы данных находятся в состоянии running и что постоянные тома созданы на ожидаемом накопителе.
4. Открывают адрес экземпляра в браузере. Для локальной минимальной схемы это порт 8000.
5. Создают администратора при первом посещении и сразу проверяют вход после выхода из учётной записи.
6. Перед публикацией в интернет задают корректные APP_URL и APP_KEY, подключают домен и TLS, а также проверяют резервное копирование базы и фотографий.

Полный Docker Compose-шаблон предусматривает worker-сервисы. Они нужны не для изменения пользовательского интерфейса, а для переноса фоновых заданий из основного веб-процесса. На сервере с большим потоком загрузок или тяжёлыми операциями это уменьшает конкуренцию между открытием страниц и обработкой очереди. После перехода на Lychee 7 старые volume mappings нельзя слепо переносить из шестой ветки: смена базового образа на FrankenPHP была одной из главных причин отдельной инструкции обновления.

Ручная установка из ZIP-релиза

Готовый ZIP подходит серверу, где уже работают Apache или nginx, PHP и база данных. Текущая ветка требует PHP 8.4 или новее. Поддерживаются MySQL новее 5.7.8, MariaDB новее 10.2, PostgreSQL новее 9.2 и SQLite3. Обязательный набор PHP-расширений включает bcmath, ctype, dom, exif, fileinfo, filter, gd, json, libxml, mbstring, openssl, pcre, PDO, Phar, SimpleXML, tokenizer, xml и xmlwriter; LDAP, Imagick и Redis относятся к дополнительным возможностям.

1. Скачивают именно готовый Lychee.zip нужной стабильной версии и распаковывают его в каталог веб-приложения.
2. Настраивают права так, чтобы веб/PHP-пользователь читал код и мог писать в storage/, bootstrap/cache/, public/uploads и public/sym. Для изменения CSS из интерфейса запись требуется и в public/dist.
3. Создают или проверяют .env. В нём находятся реквизиты базы и криптографические настройки, поэтому файл нельзя отдавать веб-сервером.
4. Генерируют APP_KEY, если он не создан установочным процессом, и задают APP_URL равным внешнему адресу каталога public/.
5. Направляют document root Apache/nginx на каталог public/, а не на корень проекта.
6. Открывают приложение по HTTPS и создают администратора.

Сборка из исходников требует Composer и npm: после клонирования устанавливаются PHP-зависимости, npm-пакеты и собирается фронтенд. Этот путь оправдан при разработке или осознанной модификации, но для обычной установки он добавляет больше точек отказа. Готовый ZIP уже предназначен для развертывания и поэтому предпочтительнее на классическом PHP-хостинге.

Что проверить сразу после первого входа

Первый успешный экран ещё не означает готовность сервера к реальной библиотеке. Перед массовой загрузкой стоит выполнить короткую проверку. Создайте тестовый альбом, загрузите несколько JPEG/PNG и один типичный для вашей коллекции крупный файл, откройте миниатюры и оригинал, проверьте отображение EXIF, затем выйдите и убедитесь, что приватный альбом не открывается без разрешения. После этого протестируйте резервную копию: в ней должны быть и файлы изображений, и база данных, потому что только фотографии без базы не сохраняют структуру альбомов, пользователей и настройки.

Если используются видео, отдельно устанавливают FFmpeg для формирования миниатюр. Для более полного извлечения метаданных доступен ExifTool, а Imagick помогает получать более качественные миниатюры. Эти инструменты не следует считать заменой обязательного GD: в требованиях GD входит в основной набор расширений, тогда как Imagick помечен дополнительным.

Базовый рабочий процесс: от пустой галереи до опубликованного альбома

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

Шаг 1. Создать структуру альбомов

До массовой загрузки определите верхний уровень. Для семейной медиатеки это могут быть годы, для фотографа — клиенты или проекты, для команды — события и направления. Новый альбом создаётся через кнопку + и команду New Album; внутри него можно создать подальбом. Иерархия должна помогать найти материал без поиска, поэтому не стоит делать отдельный верхнеуровневый альбом для каждого дня, если эти дни относятся к одной поездке или проекту.

Шаг 2. Загрузить или импортировать фотографии

Небольшую подборку удобно перетащить в браузер или добавить через Upload. Для данных, уже лежащих на сервере, полезнее серверный импорт или консольная команда php artisan lychee:sync /path/to/import. Такой подход сокращает повторную передачу по сети. Импорт по URL и из Dropbox нужен, когда исходник находится не на локальном компьютере. После загрузки следует дождаться появления миниатюр и открыть несколько оригиналов, а не считать отсутствие ошибки достаточным доказательством успешного импорта.

Шаг 3. Исправить названия, даты и описания

Камера обычно создаёт имена вроде DSC_1234.JPG; в галерее такие заголовки мало помогают. Lychee позволяет менять название и описание фотографии, а также задавать или корректировать дату. Метаданные камеры при этом остаются отдельной информацией. Если библиотека используется как долговременная медиатека, описание лучше давать фактическое: событие, место, участники, условия съёмки. Это повышает полезность поиска по тексту и облегчает работу людям, которые не знают структуру каталога.

Шаг 4. Назначить теги и рейтинг

Теги пересекают границы альбомов. Например, один и тот же человек, техника съёмки или тема встречаются в разных поездках. В Lychee можно назначить тег одной фотографии или группе, а существующие значения подсказываются автодополнением. Отдельный Tag Album строится по набору тегов и автоматически обновляется при изменении тегирования. Рейтинг 1–5 звёзд и пометка избранного решают другую задачу — отбор внутри коллекции, поэтому смешивать их с тематическими тегами не требуется.

Шаг 5. Настроить внешний вид альбома

После организации выбирают обложку, при необходимости header photo, сортировку и раскладку миниатюр. Justified выравнивает строки по ширине при разных пропорциях кадров, masonry сохраняет колоночный ритм, square делает сетку однородной. Выбор влияет на просмотр, но не меняет исходные файлы. Для портфолио обычно важнее визуальный ритм, для каталожной медиатеки — предсказуемая сортировка по дате или названию.

Шаг 6. Проверить права и только затем поделиться

У публичного альбома отдельно задаются пароль и разрешение на скачивание. Для постоянного участника безопаснее создать отдельную учётную запись и предоставить права конкретному альбому. Перед отправкой ссылки откройте её в приватном окне браузера: так видно, что получит незалогиненный посетитель, а не администратор с расширенными правами. Если альбом должен быть закрытым, отсутствие доступа в таком тесте — обязательный результат.

Шаг 7. Зафиксировать резервную копию

После первичного импорта медиатека уже содержит значимый объём работы: не только файлы, но и связи альбомов, теги, пользователей, права и настройки. Резервная копия должна охватывать каталог фотографий/вариантов и базу данных. Для Docker это означает не просто сохранить compose-файл, а копировать данные постоянных томов или внешних путей. Для ручной установки — сохранить uploads и дамп базы, а также безопасно хранить конфигурацию, необходимую для восстановления.

Управление фотографиями, метаданными и отбором

Lychee хранит оригинал и формирует оптимизированные варианты для просмотра. Это принципиально для фототеки: веб-интерфейсу не приходится каждый раз передавать полный многомегабайтный исходник, но пользователь может скачать фотографию в исходном разрешении. Для групп и альбомов предусмотрены ZIP-загрузки. Автоматическая ориентация использует EXIF orientation, а извлечённые EXIF-данные становятся частью информационного представления снимка.

Поддержка EXIF полезна не только для «технической карточки». Координаты из EXIF включают фотографию в Map, а дата помогает Timeline и сортировке. Если камера или экспортирующая программа удалили GPS, карта не сможет восстановить место сама. Поэтому при импорте старой коллекции полезно проверить несколько файлов с заведомо известными геотегами и убедиться, что маркеры появились корректно.

IPTC также относится к метаданным, которые Lychee умеет читать и показывать. Для профессиональной медиатеки это важно, потому что IPTC часто содержит подписи, авторские поля и сведения, подготовленные ещё до импорта. При этом Lychee не следует воспринимать как специализированный DAM, который гарантирует полный круговой обмен всеми полями XMP/IPTC между приложениями. Его сильная сторона — представление и организация библиотеки; критичные метаданные, предназначенные для внешнего издательского процесса, лучше дополнительно проверять в специализированном инструменте.

Фотографии можно перемещать между альбомами и копировать в несколько альбомов. Это позволяет не плодить физические копии ради разных подборок, но при проектировании библиотеки нужно понимать модель конкретной операции: «move» меняет расположение в структуре, «copy» добавляет присутствие в другом альбоме. Перед массовой операцией полезно сделать небольшую пробу на нескольких элементах и проверить итог в обоих альбомах.

Рейтинг 1–5 звёзд удобен для отбора после съёмки. В отличие от тега «лучшее», число звёзд задаёт градацию. Избранное — ещё более быстрый бинарный признак. Для небольшой коллекции можно обходиться только избранным, но при регулярной работе рейтинг помогает разделить черновой отбор, хорошие кадры и финальную подборку без создания множества вспомогательных альбомов.

Альбомы, Smart Albums и представления библиотеки

Обычный альбом — основной контейнер Lychee. Он имеет собственное имя, описание, обложку и настройки отображения. Вложенные альбомы позволяют строить дерево. Динамические представления решают другую задачу: показывают фотографии по признакам, не заставляя вручную переносить их в новую папку. К ним относятся встроенные smart-представления и Tag Albums.

Tag Albums

Tag Album задаётся одним или несколькими существующими тегами и режимом совпадения. OR включает фотографию, если совпал хотя бы один выбранный тег; AND требует всех тегов сразу. Состав пересчитывается автоматически. Это удобно, например, для подборки «портрет + студия»: фотография появится в ней после назначения обоих тегов и исчезнет, если один тег снят.

У параметра TA_override_visibility есть существенное последствие: при включении видимость Tag Album способна переопределять собственную видимость подходящих фотографий и делать их доступными. Значение по умолчанию выключено. Администратору, который использует умные подборки в публичной галерее, нельзя включать такой режим механически — сначала нужно понять, какие приватные снимки попадают под правила тегов.

Timeline

Timeline показывает библиотеку по времени на отдельной странице и позволяет перейти к конкретной дате. Доступ учитывает права альбомов. В бесплатной редакции доступно базовое хронологическое представление, а Supporter Edition добавляет настройку гранулярности по дням, неделям, месяцам или годам, формат дат и отдельные параметры Timeline для альбомов. Это полезно для длинных хронологических коллекций, где человек помнит период съёмки, но не название альбома.

Map

Map размещает геотегированные снимки на интерактивной карте, группирует плотные области в кластеры и позволяет фильтровать по альбому или диапазону дат. Ключевое требование — наличие GPS в EXIF. Модуль можно отключить, а поставщик карт и стартовый масштаб настраиваются. Для приватной коллекции геоданные являются чувствительной информацией: перед публикацией альбома стоит решить, действительно ли посетителю должны быть видны места съёмки.

Flow

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

Карточки Flow загружаются страницами по мере прокрутки, а права доступа остаются теми же, что у альбомов. Базовый режим auto включает подходящие альбомы автоматически. Режим opt-in относится к Supporter Edition и в текущем описании имеет ограничение интерфейса: действие для явной публикации альбома в ленту ещё не выведено во фронтенд, поэтому включение этого режима способно оставить Flow пустым. Это хороший пример функции, которую нельзя оценивать только по наличию настройки — нужно учитывать фактически доступный путь управления.

Slideshow и Frame

Slideshow предназначен для последовательного полноэкранного показа фотографий. Frame — отдельное представление для использования галереи как цифровой фоторамки или экранной подборки. Эти режимы не меняют структуру медиатеки и потому безопасны для просмотра: пользователь может подготовить альбом обычным способом, а затем выбрать формат демонстрации. Для постоянного экрана важнее сетевые и энергосберегающие настройки устройства, чем сама структура Lychee.

Форматы, импорт, экспорт и интеграции

В явном списке текущей документации для изображений нет RAW-расширений вроде CR2, NEF или ARW, поэтому включать их в таблицу как гарантированно поддерживаемую веб-загрузку нельзя. При рабочем процессе с RAW разумно хранить исходники отдельно либо проверять конкретную камеру и способ импорта на тестовом экземпляре. Lychee ориентирован на веб-представление готовых изображений и метаданных, а не на проявку RAW.

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

Для массовой синхронизации используется консольная команда php artisan lychee:sync. Она подходит администраторам, которые автоматизируют импорт, но требует правильных прав на каталоги: CLI-пользователь и веб/PHP-пользователь должны иметь согласованный доступ к uploads. Документация предлагает общий системный group и SGID для наследования групповых прав при CLI-импорте.

Поддержка S3-подобного объектного хранилища возможна через расширенную конфигурацию. При этом опубликованы ограничения: размер одного загружаемого файла до 5 ГБ и низкая производительность рекурсивных файловых операций из-за сетевой задержки. Поэтому объектное хранилище не следует представлять как автоматическое ускорение. Оно меняет модель хранения, но операции, требующие обхода дерева, могут стать медленнее.

LDAP является необязательным PHP-расширением, а пользовательская аутентификация поддерживает также WebAuthn и OAuth. WebAuthn позволяет вход с ключом безопасности или биометрией, OAuth — через внешнего провайдера. Эти механизмы полезны для постоянной многопользовательской инсталляции, но требуют отдельной серверной настройки; обычный логин и пароль остаются базовым способом входа.

Пользователи, роли и общий доступ

Lychee поддерживает несколько пользователей и связывает права с конкретными альбомами. Администратор может оставить альбом приватным, открыть его всему интернету или дать чтение/запись выбранным учётным записям. Это позволяет на одном сервере разделить семейные, рабочие и публичные материалы без создания нескольких независимых установок.

Базовый вход выполняется по имени пользователя и паролю. Дополнительно предусмотрены WebAuthn и OAuth. WebAuthn полезен там, где нужно уменьшить зависимость от паролей: вход подтверждается аппаратным ключом или поддерживаемой биометрией. OAuth позволяет использовать внешний провайдер идентификации. Наличие этих способов не отменяет необходимости правильно закрывать административный интерфейс, обновлять сервер и использовать HTTPS.

Регистрацию новых пользователей можно разрешить через отдельную страницу, а точечное приглашение — оформить ссылкой. Trust levels регулируют возможности учётной записи, а cross-user sharing даёт доступ к альбомам между владельцами одной инсталляции. Для простой домашней галереи логичнее не включать открытую регистрацию без необходимости: администратор может создавать или приглашать только тех участников, которым действительно нужен доступ.

В Supporter Edition управление расширяется. Появляются пользовательские квоты, учёт занимаемого пространства, административные заметки, multi-admin и группы. Группы нужны, когда одинаковые права назначаются нескольким людям: например, редакторам проекта или членам семьи. Квота предотвращает ситуацию, когда одна учётная запись заполняет весь диск, хотя физический контроль свободного места всё равно остаётся обязанностью администратора.

Для публичной публикации отдельная учётная запись посетителю не обязательна. Альбом можно открыть по ссылке и при необходимости защитить паролем. Дополнительно задаётся возможность скачивания и присутствие в публичной галерее. Sensitive Album скрывает содержимое за дополнительным действием и может исключаться из Flow, Tag Albums, поиска и других публичных представлений в зависимости от настроек. Этот механизм относится к отображению и не заменяет настоящую приватность: материал, который не должен быть доступен посетителю вообще, должен оставаться закрытым правами.

Производительность и масштабирование

Lychee не публикует единый числовой минимум CPU и RAM для всех установок. Нагрузка зависит от размера библиотеки, разрешения файлов, числа одновременных пользователей, генерации миниатюр, видео и фоновых задач. Поэтому практическая оценка сервера должна опираться на собственную медиатеку, а не на абстрактное число фотографий. Один и тот же экземпляр может почти не нагружать процессор при чтении уже созданных миниатюр и кратковременно требовать заметно больше ресурсов во время массового импорта.

В ветке 7 контейнерный стек перешёл на FrankenPHP. Полный Docker Compose предусматривает worker-процессы и прямо рекомендуется для лучшей производительности по сравнению с минимальным одноконтейнерным стартом. Смысл worker-модели — вынести фоновые задания из пути обычного HTTP-запроса. Для небольшого домашнего сервера минимальная схема остаётся удобной точкой входа, но при регулярном массовом импорте стоит оценить полный стек.

Создание миниатюр — одна из операций, где качество и скорость зависят от серверной графической библиотеки. GD обязателен, Imagick необязателен и рекомендован для более качественных thumbnails. ExifTool улучшает работу с метаданными, FFmpeg нужен для видеоминиатюр. Установка всех дополнительных инструментов без фактической необходимости не делает галерею автоматически быстрее; каждый компонент следует добавлять под конкретный сценарий.

Chunk upload решает сетевую проблему больших файлов: передача разбивается на части. Однако серверные лимиты PHP и reverse proxy всё равно нужно согласовать. В примере nginx для ручной установки показаны post_max_size=100M, upload_max_filesize=30M, memory_limit=300M и увеличенное время выполнения. Это пример конфигурации, а не универсальный предел Lychee. Если типичный JPEG больше 30 МБ, администратор должен настроить допустимый размер под собственные файлы.

Flow показывает важный компромисс масштабирования. Карточки загружаются постранично, но опция включения фотографий из дочерних альбомов прямо отмечена как потенциально медленная и способная вызвать нехватку памяти на больших деревьях. Поэтому расширенные режимы следует включать после измерения, а не как обязательную «полную» конфигурацию.

Объектное хранилище даёт независимый от локального диска слой, но рекурсивные операции по сети работают хуже. В расширенной инструкции указана плохая производительность search/find/ls-подобных рекурсивных задач из-за latency. Для медиатеки, где часто выполняются массовые обходы, локальный SSD или быстрое сетевое хранилище может оказаться предсказуемее S3-монтирования через FUSE.

Профильное издание Android Authority в 2026 году запустило Lychee на старом Google Pixel через Termux с PHP, Apache и SQLite и описало просмотр галереи как отзывчивый. Это полезный практический пример низкого порога по ресурсам, но не нормативный тест: мобильный процессор, локальный объём библиотеки и сценарий автора не задают минимальные требования для всех. Для рабочей инсталляции важнее провести собственный импорт типичной партии и измерить время создания миниатюр, расход памяти и скорость резервного копирования.

Как проверить производительность до миграции большой библиотеки

1. Возьмите репрезентативную выборку: несколько сотен файлов разных размеров, часть с EXIF/GPS и несколько видео, если они используются.
2. Засеките время импорта и момент, когда все миниатюры перестают появляться с задержкой.
3. Одновременно откройте галерею во втором браузере и оцените, мешает ли обработка загрузке страниц.
4. Проверьте Timeline, Search и Map после импорта, а не только обычный альбом.
5. Посмотрите свободное место до и после: к оригиналам добавляются служебные варианты и база.
6. Сделайте резервную копию и восстановите тестовый экземпляр. Медленный restore часто важнее нескольких секунд разницы при просмотре.

Безопасность и приватность

Self-hosted-модель переносит контроль данных к владельцу сервера, но одновременно переносит к нему ответственность за обновления, HTTPS, резервные копии, права файловой системы и экспозицию приложения в интернет. Lychee не отправляет библиотеку в обязательное централизованное облако, однако сам факт локального или собственного размещения не делает сервер защищённым автоматически.

Защита конфигурации и транспортного канала

Файл .env содержит реквизиты базы и ключи. Корневой каталог приложения нельзя публиковать веб-сервером; document root направляется в public/. При ручной установке отдельно рекомендуется TLS. В Docker-производстве приложение обычно ставят за nginx, Traefik или Caddy с HTTPS. Корректный APP_URL нужен не только для красивых ссылок: он должен соответствовать реальному внешнему адресу экземпляра.

APP_KEY обязателен. Если установщик не создал его, используется php artisan key:generate. Ключ не следует менять без понимания последствий для зашифрованных данных. Резервная копия конфигурации должна храниться отдельно от публично доступного каталога и иметь ограниченные права.

Обновления как часть защиты

В 2026 году у проекта выходили исправления, связанные не только с функциями, но и с безопасностью. В ветке 7.6.3 исправлялся обход скачивания в защищённых паролем альбомах. В 7.7.2 добавлялись меры против ZIP bomb и другие защитные изменения, а 7.7.3 исправляла проблему безопасного извлечения ZIP. Это означает, что рабочий экземпляр нельзя оставлять на старой ветке только потому, что интерфейс продолжает открываться.

Обновление нужно выполнять с резервной копией и чтением переходных инструкций. Версия 7 изменила контейнерную базу и volume mappings, поэтому простая замена image tag без проверки могла повредить путь к данным. Безопасный порядок: сохранить базу и фото, изучить изменения томов и окружения, обновить тестовый экземпляр, выполнить миграции, проверить приватные и публичные альбомы, затем обновлять основной сервер.

Пароли, права и публичный поиск

Пароль публичного альбома защищает конкретную точку публикации. Для постоянной совместной работы лучше использовать индивидуальные учётные записи и права чтения/записи. Публичный поиск можно отключить; тогда незалогиненный посетитель не сможет искать по открытым альбомам через встроенный механизм. Это особенно важно, когда публичных коллекций много и владелец хочет давать доступ только по известным ссылкам.

Secure Image Links в Supporter Edition добавляют AES-защищённые ссылки, уменьшающие риск подмены параметров URL. Такая функция не отменяет контроля доступа к альбому и TLS. Аналогично hotlink protection препятствует несанкционированному встраиванию изображений на сторонних страницах, но не превращает публично доступный кадр в секретный.

Honeypot и Fail2Ban

Lychee умеет отвечать кодом 418 на запросы к выбранным ложным путям, характерным для автоматических сканеров. По записи в журнале внешний Fail2Ban может заблокировать источник на уровне firewall. Сам Fail2Ban не входит в Lychee и устанавливается отдельно. Такая схема уменьшает шум от примитивных сканеров, но не заменяет обновления, минимизацию открытых портов и общую серверную защиту.

Импорт по URL и серверные риски

Функция импорта по URL заставляет сервер обращаться к внешнему адресу. В истории проекта уже публиковались исправления SSRF-класса для такого сценария, поэтому давать право импорта неизвестным пользователям и держать старую версию опасно. На многопользовательском сервере доступ к загрузке и импорту должен соответствовать доверию к учётной записи, а сам сервер — получать обновления безопасности без многомесячных задержек.

Геоданные и чувствительные альбомы

GPS из EXIF способен раскрыть точное место съёмки. Для публичного семейного фото это может быть адрес дома, школы или другой приватной точки. Перед публикацией проверьте информационную панель и Map, а при необходимости удалите чувствительные метаданные до загрузки или не публикуйте географическое представление. Sensitive Album помогает скрыть материал в интерфейсе, но истинная конфиденциальность обеспечивается закрытым доступом, а не только blur или дополнительным кликом.

Системные требования

Lychee является серверным PHP-приложением, поэтому его требования отличаются от обычной программы для Windows или macOS. Пользовательский компьютер нужен только для браузера; основная совместимость определяется серверным рантаймом, базой данных и расширениями PHP. Для 7-й ветки ключевая граница — PHP 8.4 или новее.

На FreeBSD дополнительно могут понадобиться PHP-модули session и zlib. Для Linux ручная инструкция даёт примеры Apache и nginx, но не привязывает Lychee к одному дистрибутиву. Контейнерный вариант ещё сильнее отделяет приложение от конкретной серверной системы: администратору важно, чтобы Docker/Compose и хранилище работали стабильно.

Ограничения загрузки определяются не только Lychee. Reverse proxy, PHP и веб-сервер имеют собственные пределы размера тела запроса и времени выполнения. Если загрузка небольших JPEG проходит, а крупные файлы возвращают 413/500 или обрываются, сначала следует проверить серверные лимиты и журналы, затем уже искать проблему в интерфейсе галереи.

Практические сценарии использования

Личная фототека на домашнем сервере

Для одного владельца можно начать с бесплатной редакции, одной административной учётной записи и закрытых альбомов. Задача — получить единый браузерный каталог, а не немедленно публиковать его наружу. В таком варианте полезны вложенные альбомы, теги, Timeline, Search и Map. Если доступ нужен только из домашней сети, внешняя публикация домена вообще не обязательна; если сервер открывается из интернета, HTTPS и своевременные обновления становятся обязательной частью эксплуатации.

Хороший порядок миграции: перенести небольшой год или одну поездку, проверить даты и геотеги, затем импортировать остальную библиотеку партиями. Так легче обнаружить проблемы с часовым поясом, метаданными и правами на файлы до того, как в базе окажутся десятки тысяч объектов.

Фотографическое портфолио

Для портфолио важнее внешний вид альбомов, крупный просмотр и аккуратный контроль публикации. У каждого проекта можно выбрать обложку, header photo, тип сетки и сортировку. Публичный альбом открывается по ссылке, при необходимости защищается паролем и может запрещать загрузку оригиналов. В этом сценарии не обязательно включать публичный поиск: клиент получает прямую ссылку на конкретную подборку.

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

Семейная галерея для нескольких пользователей

Каждому постоянному участнику лучше дать отдельную учётную запись. Общие альбомы можно открывать на чтение или запись. Это позволяет родителям добавлять фотографии в одну коллекцию, а родственникам — только просматривать. При необходимости Supporter Edition добавляет группы и квоты, но для нескольких человек базовые per-album rights уже покрывают ключевую задачу.

Для семейной медиатеки особенно полезны Timeline и On This Day-подобные временные представления, если они включены в текущую конфигурацию, а также Tag Albums по людям или событиям. Распознавание лиц стабильная 7.7.4 ещё не предоставляет как готовую функцию v8, поэтому автоматическое заполнение таких подборок рассчитывать нельзя — теги назначаются самостоятельно.

Галерея события с выдачей ссылки

После мероприятия создают отдельный альбом, загружают отбор, назначают обложку и проверяют порядок кадров. Если участникам разрешено скачать оригиналы, соответствующее право включают; если нужен только просмотр, загрузку ограничивают. Пароль полезен для полу-приватного мероприятия, но получатели могут передать и ссылку, и пароль дальше, поэтому это не равнозначно персональной авторизации.

Небольшая команда или редакция

Команде важны разграничение ролей и предсказуемая каталогизация. Можно использовать отдельные альбомы проектов, теги для тем и авторов, а доступ на запись давать только тем, кто действительно редактирует коллекцию. Supporter Edition с группами и multi-admin снижает административную нагрузку, когда пользователей становится много. Для критичной издательской работы, где нужен сложный DAM-workflow, согласования и широкий XMP-круговорот, Lychee следует предварительно сравнить со специализированными системами.

Цифровая фоторамка

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

Медиатека на сервере с существующим деревом каталогов

Когда файлы уже лежат на NAS, серверный или CLI-импорт экономит повторную передачу. Но Lychee всё равно использует базу данных и собственную логику библиотеки. Перед полномасштабной миграцией нужно проверить, как выбранный sync-процесс обращается с удалёнными из исходной папки файлами, дубликатами и деревом каталогов. Для резервной копии нельзя полагаться только на исходную папку, если в Lychee уже сделана значительная ручная разметка.

Ограничения, которые нужно учитывать до установки

• Это серверное приложение. Пользователю, который хочет просто открыть папку на ноутбуке, придётся обслуживать веб-сервер или Docker-стек, базу данных и резервные копии.
• Минимальная версия PHP — 8.4. Старый shared hosting с PHP 8.3 для актуальной 7-й ветки не подходит.
• Обновление между крупными ветками может менять инфраструктуру. Переход на v7 изменил Docker base и пути томов.
• Функции v8 нельзя считать доступными сейчас. Facial Recognition и NSFW Classification в навигации документации помечены как v8.
• Нет универсального числового минимума CPU/RAM. Производительность нужно проверять на собственном наборе изображений и видео.
• Поддерживаемая веб-загрузка изображений явно перечисляет JPG/JPEG, PNG, GIF и WebP. RAW-проявка не является задачей Lychee.
• Часть продвинутых функций платная. Группы, квоты, watermarking, secure image links, расширенные настройки Timeline/Flow и другие возможности относятся к Supporter Edition.
• Self-hosted не означает «без администрирования». Нужно самостоятельно закрывать .env, настраивать TLS, обновлять релизы, следить за журналами и свободным местом.
• Пароль публичного альбома — ограниченная защита. Для персональных прав нужны учётные записи и per-album access control.
• Object Storage имеет компромиссы. Рекурсивные операции через сетевое S3-монтирование могут быть медленными.
• Flow имеет настройки, способные резко увеличить расход памяти. Включение фотографий из дочерних альбомов прямо отмечено как потенциально тяжёлое на крупных деревьях.
• Мобильного резервного клиента как основного обязательного компонента нет. Базовый интерфейс браузерный; сценарий автоматического camera upload следует проектировать отдельно.

Плюсы и минусы Lychee

Плюсы

• Самостоятельное размещение: фотографии, база и правила доступа находятся на инфраструктуре владельца экземпляра.
• Открытый исходный код и лицензия MIT у базового проекта.
• Два основных способа развертывания: готовый ZIP для PHP-сервера и Docker Compose для контейнерной среды.
• Вложенные альбомы, обложки, header photos и несколько типов раскладки дают удобную структуру как для каталога, так и для презентационной галереи.
• Поддерживаются теги, Tag Albums, поиск, рейтинг, избранное, Timeline, Map, Flow, Slideshow и Frame.
• Несколько пользователей и права чтения/записи на уровне альбома доступны без перехода к отдельной корпоративной системе.
• Публичные альбомы можно защитить паролем и отдельно контролировать скачивание.
• EXIF и GPS интегрированы в просмотр; для расширенной обработки метаданных можно подключить ExifTool.
• Есть массовый выбор, массовое тегирование, перемещение и другие групповые операции.
• Большие загрузки поддерживают передачу по частям, а серверный/CLI-импорт подходит для существующих медиатек.
• Релизы выходят регулярно, а история 2026 года показывает быстрые исправления функциональных и защитных проблем.

Минусы

• Для установки нужны навыки обслуживания сервера, Docker или PHP-стека; это не приложение «установил на ПК и открыл папку».
• Актуальная ветка требует PHP 8.4+, что отсекает часть старых shared-hosting окружений.
• Крупные обновления могут потребовать ручной миграции конфигурации и volume mappings.
• Часть функций, заметных в многопользовательской и презентационной работе, вынесена в Supporter Edition.
• В стабильной 7.7.4 нет готового распознавания лиц v8, поэтому автоматическая персональная каталогизация ограничена.
• Явно заявленный набор форматов изображений ориентирован на веб-форматы, а не на RAW-проявку.
• Производительность больших деревьев зависит от выбранных модулей; некоторые режимы Flow и сетевое object storage имеют документированные ограничения.
• Наличие публичной ссылки, паролей и геоданных требует от администратора внимательной проверки приватности перед публикацией.

Частые ошибки и способы проверки результата

Диагностику Lychee полезно строить по цепочке «веб-сервер → PHP → база данных → права на каталоги → обработка файлов → браузер». Один и тот же симптом может появиться на разных уровнях. Поэтому сначала проверяют, открывается ли само приложение, затем авторизацию, запись файлов и создание миниатюр, а уже после — отдельные функции вроде карты или импорта.

После установки вместо интерфейса открывается ошибка сервера

Для ручной установки критичны корректный document root и права на каталоги записи. Веб-сервер должен обслуживать каталог public, а процесс PHP — иметь возможность записи в storage, bootstrap/cache, public/uploads и public/sym; для собранных ресурсов используется public/dist. Затем сверяют версию PHP: ветке 7.7.x нужен PHP 8.4 или новее, обязательные расширения и драйвер выбранной базы данных.

• Проверьте, что веб-сервер направляет запросы в public, а не в корень проекта.
• Сверьте PHP 8.4+ и обязательные расширения, включая GD, EXIF, PDO и XML-компоненты.
• Проверьте соединение с MySQL/MariaDB, PostgreSQL либо SQLite.
• Убедитесь, что каталоги записи доступны пользователю веб-сервера или PHP-FPM.
• Не публикуйте файл .env: он содержит параметры базы данных и секреты приложения.

Небольшие фотографии загружаются, а крупные — нет

Lychee поддерживает обычную загрузку через верхнюю панель и загрузку частями. Если небольшой JPEG принимается, а крупный файл завершается ошибкой, интерфейс и базовая запись уже работают; дальше проверяют лимиты PHP и обратного прокси. В nginx ограничение размера тела запроса может сработать раньше настроек PHP. В контейнерной установке также важно, чтобы том с пользовательскими данными был подключён в ожидаемую точку и сохранялся после пересоздания контейнера.

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

Файл добавился, но миниатюра не создаётся

GD относится к обязательным расширениям Lychee. Imagick не обязателен, но поддерживается как дополнительный вариант обработки. Для миниатюр видео нужен FFmpeg. Поэтому отсутствие превью у фотографии и отсутствие кадра у видео — разные случаи: для изображения проверяют графическое расширение PHP и права записи, для видео дополнительно наличие FFmpeg.

Карта открывается, но на ней нет фотографий

Карта строится по GPS-координатам из метаданных. Если у снимков нет координат EXIF, пустая карта не означает сбой. Откройте информационную область конкретной фотографии и проверьте наличие геоданных, затем — фильтры карты по альбому и дате. Контрольным примером должен быть файл, в котором камера или телефон действительно сохранили широту и долготу.

Tag Album кажется пустым или показывает неожиданный набор

Tag Albums формируются динамически и могут объединять теги через AND или OR. При AND фотография должна удовлетворять всем выбранным условиям, поэтому результат легко сделать слишком узким. На видимость также влияет TA_override_visibility: при выключенном значении Tag Album не должен обходить обычные права исходных альбомов. Настройка скрытия sensitive-содержимого тоже меняет итоговую выборку.

Для проверки создайте три тестовых объекта: с тегом A, с тегом B и с A+B. В режиме AND по A и B ожидается только третий, в OR — все три. Такой тест точнее, чем оценка результата на большой библиотеке.

Пользователь видит альбом, который должен быть закрыт

В Lychee нужно различать публичность альбома, доступ конкретному пользователю и разрешение на скачивание. Публичный альбом можно защитить паролем и отдельно разрешить или запретить download. Проверять приватность в той же авторизованной вкладке недостаточно: браузер уже несёт сессию владельца.

Откройте альбом в отдельном приватном окне без авторизации и, отдельно, под тестовой учётной записью с ограниченными правами. Для альбома с паролем содержимое не должно открываться до ввода пароля; для частного анонимный посетитель не должен получать доступ. После изменения разрешений повторите проверку с новой сессией.

После перехода с ветки 6 на 7 контейнер не стартует или не видит прежние данные

Версия 7 изменила инфраструктурную часть контейнерного развёртывания: проект перешёл на FrankenPHP и Laravel Octane, а требование к PHP поднялось до 8.4. В пользовательских обсуждениях миграции отдельно встречались трудности с изменёнными подключениями томов. Поэтому переход между крупными ветками нельзя сводить к замене номера образа.

До миграции сохраняют базу и пользовательское хранилище, затем сверяют актуальный Compose-файл со своей конфигурацией. После запуска проверяют не только номер версии, но и наличие прежних альбомов, открытие оригиналов, новые загрузки и фоновые задачи. Пустой интерфейс после изменения точки подключения тома не доказывает удаление прежних файлов.

После обновления появляется сообщение о просроченной сессии

Такой симптом не доказывает несовместимость PHP 8.4: эта версия PHP требуется Lychee 7. В обсуждении конца 2025 года похожая проблема возникала в установке через Softaculous, тогда как сопровождающий проекта не воспроизводил её в собственных окружениях PHP 8.4 и 8.5. Практический вывод — разделять проблему приложения и проблему конкретной упаковки или конфигурации хостинга.

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

Импорт по URL не работает или требует ограничения

Import from Link заставляет сервер Lychee самостоятельно обращаться к указанному адресу. История безопасности проекта включает исправления SSRF в механизме URL-импорта, поэтому старые версии нельзя оставлять без обновлений, особенно при доступе недоверенных пользователей. На сетевом уровне серверу не требуется произвольный доступ к внутренним служебным адресам только ради обычной фотогалереи.

Результат импорта проверяют как обычную загрузку: объект должен появиться в нужном альбоме, исходный файл сохраниться, миниатюра сформироваться, а метаданные читаться. Успешный HTTP-ответ внешнего адреса сам по себе не означает успешный импорт медиафайла.

Object storage подключён, но обход файлов медленный

Lychee поддерживает S3-совместимое объектное хранилище, однако документация отдельно предупреждает, что рекурсивные операции поиска и перечисления в такой схеме дороги из-за сетевой задержки. Для этой конфигурации также указано ограничение загрузки 5 ГБ. Поэтому S3 не следует считать автоматическим способом ускорить большую медиатеку.

Flow загружается долго или потребляет много памяти

Представление Flow может включать фотографии дочерних альбомов. Опция flow_include_photos_from_children способна быть медленной и требовательной к памяти на больших деревьях. Для диагностики отключают включение потомков и сравнивают поведение с тем же набором альбомов. Если задержка исчезает, узкое место связано с расширенным способом построения Flow.

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

Для self-hosted системы наличие резервной копии не равно возможности восстановления. Lychee связывает записи базы с файлами в хранилище, поэтому резервировать нужно обе части и периодически проверять их на отдельном тестовом экземпляре.

Отзывы пользователей и профильных изданий

Отзывы о Lychee нужно читать вместе с номером версии и способом установки. Это серверное приложение: впечатление зависит не только от браузерного интерфейса, но и от PHP, базы данных, контейнеров, прокси и диска. Крупные ветки меняли и фронтенд, и инфраструктуру, поэтому наблюдение о старой версии нельзя автоматически переносить на 7.7.x.

Выводы профильных изданий

Ars Technica в сравнительном материале о self-hosted фотогалереях рассматривала Lychee как промежуточный вариант между простой веб-галереей и менеджером фотобиблиотеки. В разборе выделялись редактирование метаданных и альбомов, сетка изображений, общий доступ и детальные настройки отдельных альбомов и фотографий. Публикация относится к более раннему поколению Lychee, поэтому полезна для понимания базовой модели программы, но не для определения нынешних системных требований.

Android Authority в практическом материале 2026 года выбрала Lychee для собственной галереи из-за сочетания возможностей и умеренной нагрузки. Автор развернул приложение на старом смартфоне Pixel через Termux с PHP, Apache и SQLite и описал отзывчивую работу своей установки. В сценарии использовались альбомы, общий доступ, EXIF, On This Day, Timeline и Frame. Это реальный пример, но не универсальный тест производительности: другая коллекция, база, процессор и хранилище дадут другой результат.

TechRepublic в публикации 2026 года делала акцент на роли Lychee как простой self-hosted галереи: браузерном управлении, защищённых паролем альбомах и работе с метаданными. Такой фокус совпадает с фактической специализацией продукта: веб-организация и публикация подготовленных медиа, а не RAW-конвертация или сложное редактирование изображения.

Содержательные пользовательские обсуждения

В обсуждении проекта конца 2025 года пользователь ветки 6.10.4 Supporter Edition не сразу нашёл отображение тегов. Сопровождающий указал путь Settings → Gallery → Expert Settings, объяснил режимы показа деталей и роль Tag Albums. Случай показывает реальное ограничение интерфейса: некоторые настройки находятся глубже основной навигации и требуют знакомства с Expert Settings.

Тот же пользователь хотел переходить по тегу как по фильтру. Обсуждение получило продолжение, а весной 2026 года сопровождающий сообщил о реализации соответствующего поведения. Это показывает, что навигация и работа с тегами развиваются между релизами; при чтении старых отзывов нужно учитывать дату.

В другом обсуждении перехода на Lychee 7 пользователь, долго работавший с веткой 6, столкнулся с изменениями Docker-конфигурации и томов. Это подтверждает практическое ограничение крупных обновлений: контейнер упрощает первоначальный запуск, но не освобождает от сверки новой схемы развёртывания и резервного копирования перед миграцией.

Из отзывов складываются три устойчивые темы. Lychee ценят за веб-подачу, альбомы, метаданные и контролируемые ссылки; self-hosted модель даёт владельцу контроль над сервером, но требует администрирования; крупные обновления способны менять инфраструктуру достаточно заметно, чтобы старые инструкции переставали быть надёжными. Эти наблюдения не превращают Lychee в универсальный фотоменеджер: для RAW и глубокой настольной каталогизации нужен другой класс ПО.

Сравнение с аналогами

Для сопоставления достаточно двух решений с разной специализацией. Piwigo близок к Lychee как self-hosted веб-галерея. digiKam — настольный менеджер фотографий; он показывает границу между серверной публикацией и локальным DAM. Сравнение ниже не является рейтингом.

Lychee против Piwigo

Обе программы размещаются на сервере и предоставляют коллекцию через браузер. Lychee делает заметный акцент на встроенных представлениях Timeline, Map, Flow, Frame и Tag Albums. Piwigo сильнее опирается на каталог тем и плагинов и имеет отдельные мобильные приложения. Поэтому различие определяется способом расширения и желаемой архитектурой галереи, а не абстрактным количеством функций.

Lychee против digiKam

digiKam показывает границу класса. Lychee принимает медиа на сервер и предоставляет библиотеку через веб. digiKam устанавливается на рабочую станцию и ориентирован на импорт с камер и накопителей, RAW, метаданные, пакетные операции, редактирование и локальную каталогизацию. Эти решения могут дополнять друг друга: исходники обрабатываются локально, а подготовленные JPEG/WebP публикуются в Lychee.

Lychee разумнее оставить главным предметом выбора, когда задача сформулирована как самостоятельная веб-медиатека. Piwigo стоит рассматривать при приоритете плагинов и тем, а digiKam — когда центр процесса находится до публикации, на этапе локального управления и обработки исходников.

FAQ о Lychee

Lychee — настольная программа или веб-приложение?

Это серверное веб-приложение. Lychee устанавливается на сервер либо запускается в контейнерах, хранит состояние в базе данных и обслуживает медиатеку через браузер. Такой подход отличается от настольного фотоменеджера, который напрямую работает с локальными каталогами одной рабочей станции.

Какая стабильная версия Lychee актуальна?

Стабильный релиз — 7.7.4 от 19 августа 2026 года. После публикации релиза в ветке master уже появились дополнительные коммиты, но они не образуют новый стабильный номер. Для рабочей установки следует различать опубликованный релиз и текущее состояние ветки разработки.

Lychee бесплатна?

Базовая редакция распространяется как свободное ПО по лицензии MIT. Supporter Edition стоит 5 евро в месяц и добавляет отдельные возможности, в том числе расширенные функции управления пользователями, статистику, защищённые ссылки и дополнительные средства настройки. Для Supporter Edition не предусмотрены пробный период и возврат, поэтому сначала имеет смысл оценить бесплатную редакцию.

Нужно ли покупать облачное место у Lychee?

Нет. Основная модель — self-hosted: место предоставляет владелец установки. Файлы находятся на выбранном серверном хранилище, а база данных содержит состояние приложения. Это даёт контроль над расположением данных, но делает владельца ответственным за ёмкость, резервные копии, обновления, HTTPS и доступность сервера.

Какой PHP нужен ветке 7?

Lychee 7 требует PHP 8.4 или новее. Это ключевое отличие от старых инструкций по предыдущим версиям. При ручной установке дополнительно нужны обязательные расширения PHP и драйвер той базы данных, которая выбрана для экземпляра.

Какие базы данных поддерживаются?

Документированы MySQL новее 5.7.8, MariaDB новее 10.2, PostgreSQL новее 9.2 и SQLite3. Для MySQL/MariaDB и PostgreSQL требуется соответствующее PHP-расширение, для SQLite — SQLite3. Выбор базы влияет на схему развёртывания и резервного копирования, но не меняет браузерную модель работы.

Можно ли установить Lychee через Docker Compose?

Да. Docker Compose — один из основных способов развёртывания. Минимальная конфигурация подходит для первого запуска, а производственный вариант дополняют постоянными томами, корректным APP_URL и APP_KEY, базой данных, TLS через обратный прокси и рабочими процессами для фоновых задач.

Какие изображения и видео принимает Lychee?

Для изображений документированы JPG/JPEG, PNG, GIF и WebP. Для видео перечислены OGV, MP4, MPG, WebM, MOV, M4V, AVI и WMV. Это подтверждённый список для загрузки в веб-галерею; его не следует автоматически расширять до всех форматов, которые способны декодировать сторонние библиотеки на конкретном сервере.

Подходит ли Lychee для RAW-файлов камер?

Lychee не следует рассматривать как RAW-конвертер. RAW-форматы камер не входят в основной документированный список изображений ветки 7.7.x, а сама программа ориентирована на организацию, хранение и публикацию медиа. Для RAW-разработки нужен специализированный редактор или фотоменеджер; подготовленные JPEG или WebP затем можно загрузить в Lychee.

Сохраняет ли Lychee оригиналы?

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

Как импортировать большую коллекцию, которая уже находится на сервере?

Помимо загрузки через браузер, предусмотрена серверная синхронизация командой php artisan lychee:sync /path/to/import. Перед массовым запуском полезно проверить небольшой каталог: убедиться, что фотографии появились, даты и метаданные прочитались, а миниатюры сформировались. После этого тот же процесс можно применять к большему объёму.

Можно ли импортировать фотографию по ссылке?

Да. В меню добавления есть Import from Link. Поскольку сетевой запрос выполняет сервер Lychee, эта функция имеет значение и для безопасности: экземпляр нужно своевременно обновлять, а сетевой доступ сервера — ограничивать по реальной необходимости. Старые версии с исправленными уязвимостями URL-импорта не подходят для публичного развёртывания.

Поддерживает ли Lychee нескольких пользователей?

Да. Есть учётные записи и права на альбомы, публичный и приватный доступ. Поддерживаются имя/пароль, WebAuthn и OAuth; LDAP используется как дополнительная интеграция. Supporter Edition расширяет административные возможности группами, квотами и дополнительными средствами управления пользователями.

Можно ли открыть только один альбом, не публикуя всю медиатеку?

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

Как проверить, что закрытый альбом действительно закрыт?

Откройте его URL в приватном окне браузера без активной сессии владельца. Для полностью частного альбома содержимое не должно быть доступно. Для публичного альбома с паролем просмотр должен требовать пароль. Затем отдельно проверьте право download, потому что возможность просмотра и возможность получить оригинал регулируются раздельно.

Есть ли поиск?

Да. Поиск охватывает доступный текущему пользователю контент и работает, в частности, по названиям и описаниям фотографий, именам альбомов и тегам. Публичный поиск регулируется настройкой. Для постоянных динамических подборок по тегам используются Tag Albums — это отдельный механизм.

Что такое Tag Album?

Это динамический альбом, содержимое которого определяется тегами. Условия можно соединять через AND или OR. Изменение тегов фотографии автоматически меняет её участие в подборке. По умолчанию права исходных альбомов остаются значимыми; настройка TA_override_visibility регулирует переопределение видимости.

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

Для карты нужны GPS-координаты. Lychee считывает их из метаданных и использует для маркеров и кластеров; доступна фильтрация по альбому и дате. Если координаты были удалены до загрузки, приложение не может определить место только по изображению.

Есть ли распознавание лиц в версии 7.7.4?

Нет оснований относить его к стабильной 7.7.4. Документация проекта размещает распознавание лиц и NSFW-классификацию в материалах будущей версии 8. Поэтому эти функции нельзя использовать как характеристику текущего стабильного релиза.

Нужен ли ExifTool?

ExifTool не обязателен, но поддерживается как дополнительный инструмент для более полной работы с EXIF. Базовая установка может работать без него. Добавлять ExifTool имеет смысл тогда, когда расширенное извлечение метаданных действительно нужно конкретной библиотеке.

Нужен ли FFmpeg?

Для обычной коллекции фотографий — нет. FFmpeg является дополнительным компонентом для создания миниатюр видео. Если в медиатеке будут видеофайлы, его наличие нужно включить в проверку окружения.

Можно ли использовать S3-совместимое хранилище?

Да. Для такого режима документированы особенности производительности: рекурсивный поиск и перечисление объектов могут быть медленнее из-за сетевых обращений, а для загрузки указан предел 5 ГБ. Поэтому архитектуру S3 проверяют на реальной коллекции до полного переноса.

Как безопасно обновлять Lychee?

Сначала сохраняют базу данных, пользовательские файлы и конфигурацию. Затем сверяют требования целевой версии и примечания к обновлению. После перехода проверяют вход, существующие альбомы, новую загрузку, миниатюры, теги и права публичного альбома. При смене крупной ветки отдельно сравнивают PHP и контейнерную схему, потому что именно там происходили существенные инфраструктурные изменения.

Достаточно ли копии каталога с фотографиями для восстановления?

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

Подойдёт ли Lychee для семейной коллекции?

Да, когда семья готова обслуживать собственный сервер или уже располагает им. Вложенные альбомы, отдельные пользователи, пароли и права позволяют разделять частный и публикуемый контент. Перед открытием семейных фотографий стоит отдельно проверить GPS и другие EXIF-данные, потому что они тоже могут раскрывать информацию о месте и устройстве съёмки.

Подойдёт ли Lychee профессиональному фотографу?

Как серверная галерея для демонстрации и выдачи готовых фотографий — да. Как замена RAW-конвертеру, полноценному редактору или настольному DAM — нет. Практичная схема состоит в подготовке исходников в специализированном ПО и публикации готовых файлов через Lychee, когда нужен собственный сервер и контролируемые ссылки.

Итог: когда выбирать Lychee

Lychee имеет чёткую специализацию: собственная веб-медиатека, в которой администратор контролирует сервер и данные, а пользователи работают через браузер. Сильнее всего программа раскрывается там, где важны вложенные альбомы, теги, поиск, Timeline и Map, публичная галерея, пароль на альбом, раздельные разрешения и возможность оставить основную коллекцию на собственной инфраструктуре.

Для небольшой установки можно начать с поддерживаемого Docker Compose или релизного ZIP, выполнить базовую настройку, включить HTTPS и проверить резервное копирование. Для более нагруженной системы важны производительная конфигурация PHP/FrankenPHP, база, фоновые рабочие процессы, продуманное хранилище и дисциплина обновлений. Self-hosted модель одновременно даёт контроль и создаёт административную работу.

Lychee не следует выбирать ради функций, которых стабильная ветка не обещает: RAW-разработки, полноценного настольного редактирования или распознавания лиц в 7.7.4. Если приоритетны темы и плагины галереи, разумно сравнить Piwigo; если нужен локальный DAM и RAW, ближе digiKam. Когда задача состоит в организации и публикации собственной коллекции через свой веб-сервер, Lychee соответствует ей напрямую.