Skip to content

About

Персональная фотогалерея на Django: сетка ровными строками, просмотр на весь экран с жестами, загрузка с прогрессом и версии фото в WebP. Запускается одной командой в Docker. Self-hosted photo gallery and portfolio on Django.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Repository files navigation

Django Photo Gallery

Персональная фотогалерея на Django

Version License: GPL-3.0-only

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

Галерея на компьютере: имя в шапке, иконка управления справа и сетка из снимков одной высоты в каждой строке

Сетка раскладывает фото строками одной высоты, слева направо: новые снимки встают первыми, а порядок можно поменять в разделе управления. Новые снимки подгружаются по 12 штук при прокрутке, и уже показанные фото при этом не сдвигаются: меняется только последняя строка. На телефоне в строке по два снимка.


Запуск

Нужен установленный Docker с Docker Compose.

git clone https://github.com/tgeruzov/django-photo-gallery.git
cd django-photo-gallery
docker compose up --build

Галерея откроется на localhost:8000. При первом запуске Docker соберёт образ, поднимет PostgreSQL, применит миграции и создаст локального администратора: логин и пароль лежат в docker-compose.yml, в переменных DJANGO_SUPERUSER_USERNAME и DJANGO_SUPERUSER_PASSWORD. Войдите на localhost:8000/admin, и в шапке галереи появится иконка управления.

Код подключён в контейнер напрямую, поэтому правки подхватываются без пересборки. Миграции базы тоже применяются сами: после git pull сервер разработки (python manage.py devserver) доустанавливает новые миграции на первом же запросе, перезапускать контейнер не нужно. Загруженные фото лежат в папке media/ рядом с кодом, база - в томе Docker postgres_data, они переживают перезапуск. Остановить: Ctrl+C или docker compose down.

Warning

docker-compose.yml рассчитан только на локальный запуск: там включён режим отладки и простой пароль администратора. Как запускать галерею на сервере - в разделе Деплой.


Как пользоваться

Просмотр

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

Управление в просмотре едва заметно: счётчик в углу, крестик и стрелки вдоль краёв экрана, которые проступают при наведении. Через 2.5 секунды без движения мыши всё это гаснет вместе с курсором, и остаётся только фото.

Действие Мышь и клавиатура Телефон
Следующее и предыдущее фото клавиши со стрелками вправо и влево или стрелки у краёв экрана свайп влево и вправо
Увеличить двойной клик по фото двойной тап или щипок
Подвинуть увеличенное фото перетащить мышью перетащить пальцем
Закрыть Esc, крестик или клик по фону свайп вниз

Просмотр фото: снимок на весь экран, счётчик 04 / 12 и едва заметные крестик и стрелки    Галерея на телефоне: имя и иконка управления в шапке, по два-три снимка в строке

Управление

Управлять галереей может только администратор: иконка с ползунками в шапке открывает раздел /manage/. В нём две вкладки, Фото и Загрузка, а справа ссылки на админку Django и выход.

Порядок и удаление

Во вкладке Фото все снимки стоят квадратами в том же порядке, что и в галерее, с номером места внизу.

  • Перетащите фото мышью, чтобы поменять порядок. На телефоне фото нужно сначала подержать, а обычный свайп просто прокручивает страницу.
  • Клик или касание выбирает фото, клик с Shift выбирает диапазон. Выбранные можно отправить В начало или В конец либо удалить.
  • Перед удалением галерея переспрашивает: фото удаляются вместе со всеми версиями на диске, безвозвратно.
  • Порядок сохраняется сам через полсекунды после изменения, статус виден справа над сеткой.
  • С клавиатуры: стрелки переводят фокус, Alt со стрелками двигает фото, пробел выбирает, Delete удаляет выбранные, Esc снимает выбор.

Вкладка Фото в разделе управления: пронумерованные квадраты снимков, два выбраны, над сеткой кнопки В начало, В конец, Снять выбор и Удалить

Загрузка

Во вкладке Загрузка файлы можно выбрать или перетащить в рамку, подходят JPEG, PNG и WebP до 100 МБ каждый. Лишний файл убирается крестиком на его превью.

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

  • 64% и оранжевая полоска - файл отправляется, полоска показывает настоящий прогресс отправки
  • Обработка - файл уже на сервере, галерея готовит его версии
  • Готово с галочкой - фото опубликовано
  • Уже есть и чёрно-белое превью - такое фото уже есть в галерее, повторно оно не загружается
  • Ошибка и оранжевая линия - файл не принят, причина видна в подсказке при наведении

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

Вкладка Загрузка в разделе управления: превью с состояниями Готово, Уже есть, Обработка, 64% и в очереди

Админка

В /admin/ у каждого фото можно заполнить заголовок и альтернативный текст: они не показываются в галерее, но уходят в подписи для экранных читалок и в метаданные для поисковиков. Там же фото можно удалить. Фото можно добавить и в админке или заменить у него оригинал: файл проходит те же проверки, что и на странице загрузки, версии строятся заново, а новое фото встаёт первым. После пяти неудачных попыток входа подряд вход под этим логином закрывается на 15 минут.


Как обрабатываются фото

Галерея хранит оригинал и сразу при загрузке делает из него три версии в WebP:

Версия Размер по длинной стороне Где используется
Миниатюра 800 px сетка галереи
Средняя 1600 px просмотр на телефонах и небольших экранах
Оптимизированная 2560 px просмотр на больших экранах
  • Поворот из EXIF применяется, прозрачность PNG сохраняется, цветовой профиль (например, Display P3 с iPhone) переносится в версии, 16-битные PNG не пересвечиваются.
  • Дубликаты отсекаются по хешу SHA-256 содержимого, а не по имени файла.
  • Если файл не удаётся прочитать как изображение, загрузка откатывается целиком, и в галерее не остаётся фото без превью.
  • Оригинал сохраняется под случайным именем: в нём остаётся EXIF, иногда с координатами съёмки, и адрес вида IMG_1234.jpg не угадать. В версиях EXIF нет.
  • Оригиналы по умолчанию хранятся. Если нужно место, DELETE_ORIGINAL_AFTER_OPTIMIZE=1 удаляет их после создания версий, безвозвратно.

Деплой

Образ из Dockerfile готов к работе на сервере: при старте он применяет миграции и запускает Gunicorn, а статику раздаёт сам через WhiteNoise. Что нужно задать в окружении:

  • DEBUG=0 - без этого включён режим отладки
  • SECRET_KEY - длинная случайная строка. Без неё при DEBUG=0 приложение не запустится
  • ALLOWED_HOSTS и CSRF_TRUSTED_ORIGINS - ваш домен, например photo.example.com и https://photo.example.com
  • DB_HOST, DB_NAME, DB_USER, DB_PASSWORD - доступ к PostgreSQL

Загруженные фото при DEBUG=0 Django не раздаёт: папку media/ должен отдавать веб-сервер перед приложением, например nginx по пути /media/. Он же обычно держит HTTPS; приложение ждёт заголовок X-Forwarded-Proto и само перенаправляет на HTTPS.

Что важно в конфигурации nginx:

  • client_max_body_size 100m; или больше, под MAX_UPLOAD_SIZE_MB. По умолчанию nginx пропускает только 1 МБ, и более крупные снимки не загрузятся: на странице загрузки будет ошибка 413.
  • Если оригиналы не должны быть доступны вовсе, закройте их: location /media/photos/ { deny all; }. Галерея показывает только версии в WebP, оригинал нужен ей лишь для фото, у которого версии не построились.

Приложение в образе работает от пользователя app (uid 1000), не от root. Папка, которая монтируется в /app/media, должна быть доступна ему на запись: для тома Docker это так и есть, для папки на хосте выполните chown -R 1000:1000 на неё.

Остальные переменные:

Переменная По умолчанию Что задаёт
DB_PORT 5432 порт PostgreSQL
MAX_UPLOAD_SIZE_MB 100 лимит размера одного файла
DELETE_ORIGINAL_AFTER_OPTIMIZE 0 удалять оригиналы после создания версий
SECURE_SSL_REDIRECT 1 перенаправлять HTTP на HTTPS при DEBUG=0
SECURE_HSTS_SECONDS 2592000 срок HSTS при DEBUG=0
LOG_LEVEL INFO уровень логов в консоли

Храните резервные копии базы и папки media/: оригиналы фото есть только там.


Если что-то пошло не так

  • Порт 8000 занят: поменяйте левую часть в docker-compose.yml, например "8080:8000", и откройте localhost:8080.
  • После обновления страница выглядит по-старому: браузер держит старые CSS и JS, обновите страницу с очисткой кэша (Ctrl+F5).
  • У фото нет превью: например, если процесс оборвался посреди обработки. В /admin/ отметьте такие фото и выберите действие Generate missing derivatives: галерея достроит недостающие версии.
  • Ошибка column ... does not exist после обновления: база отстала от кода. Если контейнер запущен со старым docker-compose.yml, где ещё был runserver, перезапустите его один раз: docker compose up -d web. Дальше миграции будут применяться сами. Применить их вручную можно так: docker compose exec web python manage.py migrate.
  • Не видно иконки управления: она показывается только администратору. Войдите через /admin/.

Страницы ошибок оформлены как плёнка: на 404 кадры вокруг пропавшего заполняются случайными снимками галереи, на 500 плёнка засвечена. На сервере они показываются при DEBUG=0, а в режиме разработки их можно открыть по адресам localhost:8000/404/ и localhost:8000/500/.


Технические детали

Python 3.13, Django 6.1, PostgreSQL 16 через psycopg 3, Pillow, Gunicorn и WhiteNoise. Фронтенд на чистом JS и CSS без сборки: шрифты Geist и Geist Mono лежат в static/fonts/ (лицензия OFL), без запросов к Google, одна тёмная тема. Переход при открытии фото и анимация имени в шапке написаны по мотивам компонентов React Bits без React.

Путь Назначение
/ галерея, отдаёт и JSON для подгрузки ленты
/manage/photos/ порядок и удаление фото, только для администратора
/manage/upload/ загрузка фото, только для администратора; старый адрес /upload/ ведёт сюда
/all_photos.json все фото постранично в JSON, до 200 на страницу
/admin/ админка Django
/healthz проверка, что приложение и база отвечают
/sitemap.xml, /robots.txt для поисковиков

Весь код - в двух папках: config/ (настройки и маршруты) и gallery/ (модель, представления, обработка фото, SEO и шаблоны), статика - в static/.

Тесты

Тесты проверяют загрузку и обработку фото, админку, ленту, SEO и служебные адреса. Запуск в контейнере, база поднимется сама:

docker compose run --rm web python manage.py test

На GitHub они запускаются на каждый push в main и на каждый pull request.

Лицензия

GPL-3.0-only

About

Персональная фотогалерея на Django: сетка ровными строками, просмотр на весь экран с жестами, загрузка с прогрессом и версии фото в WebP. Запускается одной командой в Docker. Self-hosted photo gallery and portfolio on Django.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages