Диск на сервері закінчується. Або потрібно рознести кілька серверів і синхронізувати завантажені файли між ними. Перенесення /upload/ в S3-сумісне сховище (MinIO, Selectel, VK Cloud, Cloudflare R2) вирішує обидві задачі — але тільки якщо налаштувати правильно, інакше Бітрікс почне записувати шляхи до файлів некоректно. Ми часто бачимо проєкти, де після перенесення ламаються посилання на зображення або падає продуктивність через невірну адресацію бакета. Наш досвід роботи з Бітрікс — понад 10 років, ми налаштовували S3 для проєктів з каталогами на 100 000+ товарів і знаємо всі підводні камені. Для швидкого та безпечного налаштування зв'яжіться з нами.
Чому варто перенести файли в S3?
Локальний диск — це вузьке горлечко. Він обмежений за обсягом, не масштабується і вимагає ручного моніторингу. S3-сховище дає практично необмежений простір, автоматичну реплікацію та доступ через API. Для Бітрікс це особливо актуально, якщо сайт працює в кластері — всі сервери бачать єдину файлову систему без NFS-кошмарів. S3-сховище в 2-3 рази дешевше за локальний SSD, а швидкість завантаження не поступається при правильному налаштуванні CDN.
Порівняння локального зберігання та S3:
| Параметр | Локальний диск | S3-сховище |
|---|---|---|
| Ємність | Фізичний ліміт сервера | Від кількох ТБ до петабайт |
| Відмовостійкість | Залежить від RAID | Автоматична реплікація в різні зони |
| Швидкість для нових файлів | Обмежена IOPS диска | Залежить від провайдера, зазвичай 100+ МБ/с |
| Ціна за 1 ТБ | ~$50/міс (SSD) | ~$20/міс (S3 стандарт) |
| Інтеграція з Бітрікс | З коробки | Через модуль main.cloudstorages |
Як налаштувати S3-сховище для 1С-Бітрікс?
Бітрікс підтримує хмарні сховища через модуль main.cloudstorages (офіційна документація на dev.1c-bitrix.ru). Він абстрагує роботу з файлами через провайдерів. Для S3-сумісних сховищ використовується провайдер amazon (сумісність на рівні API S3).
Налаштування провайдера виконується в /bitrix/admin/main_cloud_storage.php. Параметри для S3-сумісного сховища:
- Endpoint URL — URL сервісу (для MinIO:
http://minio:9000, для Selectel:https://s3.selectel.ru) - Key — Access Key ID
- Secret — Secret Access Key
- Bucket — ім'я бакета
- Region — регіон (для кастомних S3 часто
us-east-1)
Конфігурація в коді (для автоматизації налаштування):
\Bitrix\Main\Config\Option::set('main', 'cloud_storage_active', 'Y'); \Bitrix\Main\Config\Option::set('main', 'cloud_storage_provider', 'amazon'); \Bitrix\Main\Config\Option::set('main', 'cloud_storage_endpoint', 'https://s3.example.com'); \Bitrix\Main\Config\Option::set('main', 'cloud_storage_access_key', 'ACCESS_KEY'); \Bitrix\Main\Config\Option::set('main', 'cloud_storage_secret_key', 'SECRET_KEY'); \Bitrix\Main\Config\Option::set('main', 'cloud_storage_bucket', 'bitrix-uploads'); \Bitrix\Main\Config\Option::set('main', 'cloud_storage_path', 'upload/'); Path style vs virtual hosted style: чому це важливо
Найчастіша проблема при підключенні не-AWS S3 — невірна адресація бакета. AWS використовує virtual hosted style: https://bucket.s3.amazonaws.com/key. Більшість S3-сумісних сервісів підтримують path style: https://s3.example.com/bucket/key.
Стандартний модуль Бітрікса використовує virtual hosted style. Для сервісів, які не підтримують його (наприклад, MinIO в локальній мережі без wildcard DNS), потрібно патчити клас провайдера /bitrix/modules/main/lib/cloudstorages/amazon.php — додати параметр use_path_style_endpoint: true при ініціалізації AWS SDK:
$s3Client = new \Aws\S3\S3Client([ 'version' => 'latest', 'region' => $region, 'endpoint' => $endpoint, 'use_path_style_endpoint' => true, 'credentials' => [ 'key' => $accessKey, 'secret' => $secretKey, ], ]); Порівняння популярних S3-провайдерів для Бітрікс:
| Провайдер | Endpoint | Path style | Ціна за 1 ТБ/міс | Особливості |
|---|---|---|---|---|
| MinIO | http://minio:9000 |
Потрібен | Безкоштовно (свій сервер) | Локальна розробка, низька затримка |
| Selectel | https://s3.selectel.ru |
Підтримується | ~$22 | Дата-центри в РФ, SLA 99.9% |
| VK Cloud | https://hb.bizmrg.com |
Підтримується | ~$20 | Інтеграція з CDN, РФ |
| Cloudflare R2 | https://<account>.r2.cloudflarestorage.com |
Підтримується | ~$15 | Немає плати за вихідний трафік |
Як перенести існуючі файли в S3?
Після підключення сховища Бітрікс починає завантажувати нові файли в S3, але старі залишаються локально. Для міграції використовується вбудована утиліта: /bitrix/admin/main_cloud_copy.php. Вона запускає агент, який пакетами переносить файли з /upload/ у сховище та оновлює шляхи в b_file.
При перенесенні важливо: поле SUBDIR в b_file зберігає відносний шлях файлу. Після міграції в S3 шляхи стають URL-адресами бакета. Якщо міграція перерветься на середині, частина файлів буде в S3, частина — локально. Бітрікс визначає джерело файлу по полю EXTERNAL_ID в b_file — якщо воно заповнене, файл вважається хмарним.
Публічний доступ і CDN
Файли в S3 мають бути публічно доступними для прямих посилань на зображення. Налаштування політики бакета (bucket policy) для публічного читання:
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": "*", "Action": "s3:GetObject", "Resource": "arn:aws:s3:::bitrix-uploads/*" }] } Для підключення CDN перед бакетом (CloudFront, Cloudflare) в налаштуваннях модуля вказується параметр CDN_URL — Бітрікс формуватиме публічні URL через CDN, а запис до S3 буде йти напряму.
Що входить у послугу
Ми підключаємо S3-сховище під ключ. У роботі:
- Аудит поточної інфраструктури та розрахунок навантаження
- Налаштування модуля main.cloudstorages з коректним endpoint і path style
- Міграція існуючих файлів з /upload/ з перевіркою цілісності
- Налаштування політик бакета та CDN (опціонально)
- Документація щодо доступів та конфігурації
- Технічна підтримка на етапі впровадження
Наші інженери сертифіковані за 1С-Бітрікс та AWS. Гарантія на коректну роботу файлового сховища після перенесення — якщо виникнуть проблеми, виправляємо безкоштовно. Офіційна документація 1С-Бітрікс з хмарних сховищ.
Типові помилки при налаштуванні S3
- Вибрано virtual hosted style, який не підтримується провайдером — файли не завантажуються.
- Не налаштована політика бакета — користувачі бачать 403 помилки на зображення.
- Перенесення виконано без перевірки b_file — шляхи залишилися локальними, файли дублюються.
- Кеш перенесено в S3 — різке падіння продуктивності через затримки.
Строки та вартість
Налаштування S3-сховища займає від 3 до 7 днів залежно від обсягу файлів та необхідності міграції. Вартість розраховується індивідуально після аудиту. Залиште заявку — ми оцінимо ваш проєкт і запропонуємо оптимальне рішення.
Замовте налаштування S3-сховища для вашого Бітрікса — ми гарантуємо коректну роботу.
Зверніться до нас, щоб отримати консультацію з налаштування S3 для вашого Бітрікс-проєкту. Ми гарантуємо стабільну роботу файлового сховища без сюрпризів.