Skip to content

README.md

Latest commit

 

History

History
102 lines (72 loc) · 3.49 KB

README.md

File metadata and controls

102 lines (72 loc) · 3.49 KB

Image Storage Server (FastAPI)

Статический сервер хранения изображений:

  • POST и DELETE защищены статичным токеном (Bearer).
  • GET /images/... открыт без авторизации.
  • При загрузке изображение автоматически конвертируется в WEBP.
  • После загрузки API делает редирект на публичный URL сохраненного файла.

Требования

  • Python 3.10+

Установка

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Конфигурация

Переменные окружения:

  • STORAGE_API_TOKEN - токен для POST/DELETE (по умолчанию: change-me-token)
  • STORAGE_DIR - путь до постоянного хранилища файлов (по умолчанию: data/images)
  • STORAGE_WEBP_QUALITY - качество WEBP (0..100, по умолчанию: 80)
  • STORAGE_WEBP_METHOD - метод кодирования WEBP (0..6, по умолчанию: 2, меньше = быстрее)
  • STORAGE_MAX_IMAGE_SIDE - ограничение максимальной стороны в пикселях (по умолчанию: 0, без ограничения)
  • STORAGE_MAX_CONVERT_CONCURRENCY - число одновременных конвертаций (по умолчанию: cpu_count/2, минимум 1)

Пример:

export STORAGE_API_TOKEN="super-secret-token"
export STORAGE_DIR="./data/images"
export STORAGE_WEBP_QUALITY="80"
export STORAGE_WEBP_METHOD="2"
export STORAGE_MAX_IMAGE_SIDE="0"
export STORAGE_MAX_CONVERT_CONCURRENCY="4"

Запуск

uvicorn app.main:app --host 0.0.0.0 --port 8000

Документация OpenAPI:

  • Swagger UI: http://localhost:8000/docs
  • ReDoc: http://localhost:8000/redoc

API

Загрузка изображения (с авторизацией)

curl -i -X POST "http://localhost:8000/api/images" \
  -H "Authorization: Bearer super-secret-token" \
  -F "file=@./photo.jpg"

Ожидаемый ответ: 303 See Other и заголовок Location: /images/<uuid>.webp

Удаление изображения (с авторизацией)

curl -i -X DELETE "http://localhost:8000/api/images/<uuid>.webp" \
  -H "Authorization: Bearer super-secret-token"

Ожидаемый ответ: 204 No Content

Публичная выдача файла (без авторизации)

curl -I "http://localhost:8000/images/<uuid>.webp"

Ожидаемый ответ: 200 OK (если файл существует), с Content-Length, который можно использовать как размер файла в байтах.

То же поведение доступно и для постоянного URL:

curl -I "http://localhost:8000/images-permanent/<uuid>.webp"

Перенос во permanent (с авторизацией)

curl -i -X POST "http://localhost:8000/api/images/<uuid>.webp/persist?overwrite=true" \
  -H "Authorization: Bearer super-secret-token"

Ожидаемый ответ: 303 See Other и заголовок Location: /images-permanent/<uuid>.webp. Если overwrite=true, существующий permanent-файл будет заменён новым temp-файлом с тем же именем.

Тесты

pytest