Міграція з хмарного Бітрікс24 на On-Premise

Міграція з хмарного Bitrix24 на On-Premise

Перехід з хмарного тарифу на коробкову версію — це не просто зміна сервера. Хмара та On-Premise — принципово різні продукти з різними можливостями, API та обмеженнями. Частина функцій хмари недоступна в коробці, частина — навпаки, з'являється. Знати ці відмінності потрібно до початку міграції.

Що не переноситься автоматично

Bitrix24 не надає офіційного інструменту повного експорту з хмари до коробки. Дані мігрують через REST API. Обмеження REST API хмари:

• Диск (файли та папки) — доступний через disk.folder.* та disk.file.*, але швидкість обмежена лімітами API (не більше 2 запитів на секунду на безкоштовному тарифі, до 200 на платному)
• Чати та стрічки — історія листування через REST не експортується; доступні тільки структуровані сутності CRM
• Бізнес-процеси — шаблони можна вивантажити через bizproc.workflow.template.list, але вони прив'язані до специфіки хмарної конфігурації та потребують ручної адаптації
• Телефонія — налаштування SIP-підключень, історія дзвінків; історія дзвінків частково доступна через voximplant.statistic.get

CRM: основний обсяг даних

Найповніше через API мігрують CRM-сутності. Порядок перенесення критичний:

1. Користувачі (user.get) — створюються на коробці вручну або через LDAP
2. Статуси та воронки (crm.status.list, crm.dealcategory.list) — перестворюються на коробці до завантаження даних
3. Користувацькі поля (crm.userfield.list) — створюються через crm.userfield.add
4. Компанії → Контакти → Ліди → Угоди (у такій послідовності, зберігаючи маппінг ID)
5. Активності / справи (crm.activity.list)
6. Коментарі та таймлайн (crm.timeline.comment.list)

Приклад отримання всіх угод з посторінковим обходом:

$start = 0;
$deals = [];
do {
    $result = $bitrix24->call('crm.deal.list', [
        'select' => ['*', 'UF_*'],
        'start'  => $start,
    ]);
    $deals = array_merge($deals, $result['result']);
    $start = $result['next'] ?? null;
} while ($start !== null);

Файлове сховище

Файли з Диска Bitrix24 завантажуються через disk.file.get (отримати URL завантаження) та вивантажуються на коробку через disk.folder.uploadfile. При великих обсягах (десятки тисяч файлів) процес займає кілька днів при безперервній роботі скрипту.

Рішення для прискорення: паралельний запуск кількох процесів з поділом файлів по папках. Але потрібно стежити за лімітами API та квотою підключень до сервера-джерела.

Налаштування та структура порталу

На відміну від даних, налаштування не мігрують через API — їх потрібно перелаштовувати вручну:

• Структура відділів та посад
• Права доступу (ролі CRM, права на диск, права на групи)
• Інтеграції із зовнішніми сервісами (пошта, телефонія, месенджери)
• Зовнішні віджети та застосунки з маркетплейсу

На коробці доступні можливості, яких немає в хмарі: прямий доступ до бази даних, налаштування LDAP/Active Directory, кастомні модулі, повний контроль над файловою системою. Це основна причина переходу для компаній з нетиповими вимогами.

Підготовка On-Premise сервера

Коробковий Bitrix24 вимагає:

• Linux (CentOS 7+, Ubuntu 18.04+) або Windows Server
• PHP 7.4–8.1 з набором обов'язкових розширень
• MySQL 5.7+ / MariaDB 10.3+
• Мінімум 4 ГБ RAM для невеликої команди (до 50 користувачів), 16+ ГБ для 200+

Для встановлення рекомендується використовувати BitrixVM — готовий образ віртуальної машини з налаштованим стеком. Це економить 2–4 години на налаштуванні сервера.

Типові терміни

Після міграції обов'язковий період паралельної роботи (2–4 тижні), коли хмара ще доступна і можна звірити дані. Потім — перемикання та закриття хмарної підписки.