Я сделал эту галерею для своих фотографий: без ленты соцсетей, рекламы и чужого оформления. Снимки идут сплошной сеткой ровными строками, открываются на весь экран, а интерфейс вокруг них держится тихо и не спорит с фото. Всё, что нужно для работы, - 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, крестик или клик по фону | свайп вниз |
Управлять галереей может только администратор: иконка с ползунками в шапке открывает раздел /manage/. В нём две вкладки, Фото и Загрузка, а справа ссылки на админку Django и выход.
Во вкладке Фото все снимки стоят квадратами в том же порядке, что и в галерее, с номером места внизу.
- Перетащите фото мышью, чтобы поменять порядок. На телефоне фото нужно сначала подержать, а обычный свайп просто прокручивает страницу.
- Клик или касание выбирает фото, клик с Shift выбирает диапазон. Выбранные можно отправить
В началоилиВ конецлибо удалить. - Перед удалением галерея переспрашивает: фото удаляются вместе со всеми версиями на диске, безвозвратно.
- Порядок сохраняется сам через полсекунды после изменения, статус виден справа над сеткой.
- С клавиатуры: стрелки переводят фокус, Alt со стрелками двигает фото, пробел выбирает, Delete удаляет выбранные, Esc снимает выбор.
Во вкладке Загрузка файлы можно выбрать или перетащить в рамку, подходят JPEG, PNG и WebP до 100 МБ каждый. Лишний файл убирается крестиком на его превью.
После Опубликовать файлы уходят по одному, и на каждом превью видно, что с ним происходит:
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.comDB_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.




