Urocissa 2.0: Самая легкая фотогалерея для self-hosting на 1М+ фото

Обзор Urocissa 2.0 — бесплатной открытой фотогалереи для homelab, которая плавно обрабатывает более миллиона фотографий на ограниченном железе. Установка через Docker, настройка и сравнение с альтернативами.

Не указано

Подготовка окружения и структуры папок

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

mkdir -p ~/urocissa
mkdir -p /mnt/data/photos
chown -R 1000:1000 ~/urocissa

Создание файла docker-compose.yml

Создайте файл docker-compose.yml в созданной директории. В этой конфигурации мы используем SQLite (встроена по умолчанию) и монтируем папку с фото в режиме 'read-only' для безопасности.

version: '3.8'

services:
  urocissa:
    image: ghcr.io/varpanel/urocissa:2.0-latest
    container_name: urocissa
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Moscow
    volumes:
      - ./urocissa_data:/app/data
      - /mnt/data/photos:/photos:ro
    networks:
      - urocissa_net

networks:
  urocissa_net:
    driver: bridge

Запуск контейнера

Находясь в директории с файлом docker-compose.yml, запустите контейнер в фоновом режиме. Docker автоматически скачает образ и поднимет сервис.

docker compose up -d

Первичная настройка веб-интерфейса

Откройте браузер и перейдите по адресу http://IP_ВАШЕГО_СЕРВЕРА:3000. При первом входе система предложит создать учетную запись администратора (укажите Email и Пароль). После авторизации перейдите в меню настроек (Settings -> Libraries) для добавления источника фотографий.

Добавление библиотеки и сканирование

В интерфейсе нажмите 'Add Library'. В поле 'Path' укажите путь к папке, как он виден внутри контейнера: /photos. Нажмите 'Scan' для начала индексации. На слабом железе первый скан может занять много времени, но это одноразовая операция.