Bunny Storage Adapter

Адаптер хранилища Bunny.net для Payload CMS 3.x с дозагрузкой TUS, интеграцией Bunny Stream и очисткой кэша CDN.

Проверенный 59 3,5 тыс./нед MIT v3.1.2

Установка

pnpm add @seshuk/payload-storage-bunny

Описание

Адаптер построен на `@payloadcms/plugin-cloud-storage` и подключается к каждой настроенной коллекции загрузок. Файлы, изображения и документы загружаются в Bunny Storage zone и раздаются через Bunny CDN. Для коллекций с адаптером принудительно включается `disableLocalStorage`, поэтому файлы не попадают на диск сервера. Плагин регистрирует хуки `afterChange`, `beforeRead` и `beforeValidate` для каждой коллекции. При необходимости добавляются эндпоинты для Bunny Stream и фоновая задача очистки через систему jobs в Payload. Если одновременно включены Bunny Stream и TUS, в админ-панель инжектируется React-компонент `TusUpload` и поле предпросмотра медиа. Конфигурация задаётся на уровне коллекций с глобальными значениями по умолчанию. Доступны префикс хранилища, `disablePayloadAccessControl` для раздачи напрямую с CDN в обход авторизации Payload, подписанные URL с ограничениями по времени и географии, автоматическая очистка кэша CDN при загрузке и удалении, генерация миниатюр с настраиваемыми трансформациями и собственные преобразования URL. Для отдельных коллекций можно отключить storage или stream, изменить таймаут загрузки или отключить очистку кэша. Для загрузки больших видеофайлов используется протокол TUS с автоматическим возобновлением при обрыве через `tus-js-client`. Требуется Payload 3.53.0 или выше, для версий от 3.0.0 до 3.52.x используйте 1.x. Нужны API-ключ Bunny Storage, hostname и имя зоны; Bunny Stream подключается опционально. В комплекте идут переводы интерфейса админки на несколько языков.

О пакете

Имя пакета
@seshuk/payload-storage-bunny
Последняя версия
3.1.2
Размер
1 МБ
Лицензия
MIT
Загрузок в неделю
3,5 тыс.
Последняя публикация
1 окт. 2026 г.

Ещё от maximseshuk

Профиль автора