Вы запустили Strapi на продакшене, а через месяц файлы теряются при деплое? Или бэкенд падает под нагрузкой при отдаче статики? Знакомая ситуация: стандартная медиа-библиотека Strapi хранит всё в public/uploads — удобно для разработки, но для продакшена критично. В этой статье разберём настройку хранилища Strapi для продакшена. За 10 лет мы настроили медиа-библиотеки для 50+ проектов на Strapi и знаем, как избежать этих проблем. Настраиваем облачное хранилище на основе S3, Cloudinary или R2, добавляем автоматическую оптимизацию изображений и контроль типов файлов. Разберём грамотную конфигурацию, которая избавит от головной боли.
Локальное хранение не решает три ключевые проблемы. Во-первых, файлы не реплицируются между инстансами: при горизонтальном масштабировании каждый сервер видит только свои файлы. Во-вторых, локальные файлы теряются при пересборке контейнера (Docker пересоздаёт слой). И наконец, производительность: отдача статики через Node.js медленнее, чем через CDN облачного провайдера. Правильная конфигурация медиа-библиотеки сокращает время загрузки страниц на 30–40% и избавляет от бекапных рисков. За месяц локальное хранилище может привести к значительным потерям из-за простоев, а оптимизация изображений у одного клиента сэкономила существенную сумму на трафике.
Почему не стоит использовать локальное хранилище в продакшене?
Локальное хранилище в public/uploads подходит только для разработки. На продакшене оно создаёт узкие места: отказоустойчивость отсутствует, масштабирование затруднено, а при каждом деплое файлы могут быть потеряны. Облачное хранилище решает все эти проблемы: файлы хранятся централизованно, доступны из любой точки мира через CDN, и не теряются при перезапуске контейнеров.
Какой провайдер выбрать для медиа-библиотеки Strapi?
| Провайдер | Пакет | Особенности |
|---|---|---|
| AWS S3 | @strapi/provider-upload-aws-s3 |
Гибкие настройки, интеграция с CloudFront, зрелый SDK |
| Cloudinary | @strapi/provider-upload-cloudinary |
Встроенная оптимизация изображений, автоматические форматы (WebP, AVIF) |
| DigitalOcean Spaces | через aws-s3 |
S3-совместимый, фиксированная цена за 250 ГБ |
| Cloudflare R2 | через aws-s3 |
Нулевая плата за egress, глобальная сеть доставки |
Cloudinary обрабатывает изображения в 2–3 раза быстрее, чем S3 с лямбда-функциями. R2 выигрывает по стоимости при большом объёме трафика — нет платы за исходящий канал.
Настройка AWS S3
Установите пакет: npm install @strapi/provider-upload-aws-s3. Конфигурация в config/plugins.js:
module.exports = ({ env }) => ({ upload: { config: { provider: 'aws-s3', providerOptions: { s3Options: { credentials: { accessKeyId: env('AWS_ACCESS_KEY_ID'), secretAccessKey: env('AWS_ACCESS_KEY_SECRET'), }, region: env('AWS_REGION', 'eu-central-1'), endpoint: env('AWS_ENDPOINT', undefined), // для S3-совместимых params: { ACL: env('AWS_ACL', 'public-read'), Bucket: env('AWS_BUCKET'), }, }, }, actionOptions: { upload: {}, uploadStream: {}, delete: {}, }, }, }, }); Amazon S3 — объектное хранилище от AWS, широко используемое для хранения файлов.
Настройка Cloudflare R2
R2 совместим с S3 API, бесплатная egress полоса:
module.exports = ({ env }) => ({ upload: { config: { provider: 'aws-s3', providerOptions: { s3Options: { credentials: { accessKeyId: env('R2_ACCESS_KEY_ID'), secretAccessKey: env('R2_SECRET_ACCESS_KEY'), }, region: 'auto', endpoint: `https://${env('CF_ACCOUNT_ID')}.r2.cloudflarestorage.com`, params: { Bucket: env('R2_BUCKET'), }, }, }, }, }, }); Для публичного доступа к файлам нужен кастомный домен R2 или Cloudflare Worker.
Настройка Cloudinary
Установите пакет: npm install @strapi/provider-upload-cloudinary. Конфигурация:
module.exports = ({ env }) => ({ upload: { config: { provider: 'cloudinary', providerOptions: { cloud_name: env('CLOUDINARY_NAME'), api_key: env('CLOUDINARY_KEY'), api_secret: env('CLOUDINARY_SECRET'), }, actionOptions: { upload: { folder: env('CLOUDINARY_FOLDER', 'strapi'), transformation: [{ quality: 'auto', fetch_format: 'auto' }], }, uploadStream: {}, delete: {}, }, }, }, }); В одном проекте с 500 000 изображений мы перенесли медиабиблиотеку на Cloudinary за 2 дня, сократив время загрузки страницы с 4.2 с до 1.1 с. Это стало возможным благодаря автоматической оптимизации и CDN.
Форматы изображений и брейкпоинты
Strapi автоматически создаёт несколько размеров при загрузке. Настройка в config/plugins.js:
breakpoints: { xlarge: 1920, large: 1000, medium: 750, small: 500, xsmall: 64, }, В API-ответе поле formats содержит URL каждого варианта. Размеры и типичное использование:
| Размер | Ширина (px) | Типичное использование |
|---|---|---|
| xlarge | 1920 | Десктопные баннеры |
| large | 1000 | Статьи, контент на десктопе |
| medium | 750 | Изображения в карточках |
| small | 500 | Миниатюры в списках |
| xsmall | 64 | Иконки, аватары |
Фильтрация типов и ограничение размера
Ограничение размера загрузки и MIME-типов:
// config/plugins.js module.exports = { upload: { config: { sizeLimit: 20 * 1024 * 1024, // 20 МБ }, }, }; // src/extensions/upload/strapi-server.js module.exports = (plugin) => { const originalUpload = plugin.controllers.upload.upload; plugin.controllers.upload.upload = async (ctx) => { const { files } = ctx.request; const allowed = ['image/jpeg', 'image/png', 'image/webp', 'application/pdf']; const invalid = Object.values(files).flat() .filter(f => !allowed.includes(f.type)); if (invalid.length) { return ctx.badRequest('Неподдерживаемый тип файла'); } return originalUpload(ctx); }; return plugin; }; Процесс настройки
- Анализ требований: определяем объём файлов, бюджет, требования к производительности.
- Выбор провайдера: на основе стоимости, географии пользователей, необходимости трансформаций.
- Настройка провайдера: установка пакета, конфигурация переменных окружения, тестовое подключение.
- Конфигурация брейкпоинтов: подгонка размеров под дизайн сайта (обычно 640, 1024, 1920).
- Фильтрация и лимиты: настройка допустимых MIME-типов и максимального размера.
- Миграция данных: перенос существующих файлов с локального диска и обновление ссылок в БД.
- Тестирование: проверка загрузки, отображения, производительности.
- Документирование и обучение: передача инструкций команде клиента.
Детали миграции
Миграция выполняется с помощью скрипта, который копирует файлы из `public/uploads` в S3-корзину и обновляет записи в базе данных Strapi. Для нескольких гигабайт процесс занимает 1-2 дня. Перед миграцией обязательно создаётся бекап базы данных и файлов. После переноса все ссылки в медиа-объектах указывают на облачное хранилище.Сроки
- Настройка S3/R2/Cloudinary провайдера — несколько часов.
- Перенос существующих файлов с локального хранилища — 1 день (зависит от объёма).
- Кастомная фильтрация типов + ограничения — несколько часов.
Что входит в работу
- Настройка провайдера хранилища (S3, Cloudinary, R2).
- Конфигурация брейкпоинтов и оптимизация изображений.
- Реализация фильтрации типов и размера файлов.
- Миграция существующих файлов на облачное хранилище.
- Написание документации и инструкций для команды.
- Гарантия корректной работы и поддержка в течение месяца после настройки.
Получите консультацию по настройке медиа-библиотеки Strapi — поможем выбрать оптимальное решение и внедрим без простоев. Свяжитесь с нами для обсуждения вашего проекта. Закажите аудит текущей конфигурации — мы проверим, есть ли узкие места.