Миграция с облачного Битрикс24 на On-Premise

Миграция с облачного Битрикс24 на On-Premise

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

Что не переносится автоматически

Битрикс24 не предоставляет официального инструмента полного экспорта из облака в коробку. Данные мигрируют через 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);

Файловое хранилище

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

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

Настройки и структура портала

В отличие от данных, настройки не мигрируют через API — их нужно перенастраивать вручную:

• Структура отделов и должностей
• Права доступа (роли CRM, права на диск, права на группы)
• Интеграции с внешними сервисами (почта, телефония, мессенджеры)
• Внешние виджеты и приложения из маркетплейса

На коробке доступны возможности, которых нет в облаке: прямой доступ к базе данных, настройка LDAP/Active Directory, кастомные модули, полный контроль над файловой системой. Это основная причина перехода для компаний с нетиповыми требованиями.

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

Коробочный Битрикс24 требует:

• 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 недели), когда облако ещё доступно и можно сверить данные. Затем — переключение и закрытие облачной подписки.