Разработка white-label решения на 1С-Битрикс
Компания-разработчик создаёт продукт, который клиенты продают под своим брендом — это white-label. Агрегатор туров, платёжный шлюз, CRM-система или маркетплейс: всё это можно построить как white-label на 1С-Битрикс. Один код, десятки инсталляций с разным брендингом — или одна инсталляция с мультитенантностью. Мы специализируемся на таких решениях и гарантируем архитектуру, которая масштабируется от 5 до 500 клиентов без переписывания ядра.
Ключевой технический вопрос при старте — выбор между одной кодовой базой на всех клиентов или отдельным инстансом на каждого. Этот выбор определяет дальнейшую архитектуру, стоимость поддержки и скорость внедрения. Ниже разберём обе модели.
Две архитектурные модели
Мультисайтовость Битрикс (один инстанс, несколько сайтов). Битрикс поддерживает несколько сайтов в рамках одной установки. Каждый сайт — запись в b_lang, отдельный шаблон в /local/templates/{SITE_ID}/, свои настройки в b_option. Данные (товары, пользователи, заказы) могут быть общими или разделёнными по сайтам. Подходит когда клиентов мало (до 20–30 сайтов), данные частично общие, одна команда администрирует все сайты. Экономия на лицензиях достигает 30%.
Раздельные инсталляции. Каждый клиент получает независимую установку Битрикс. Общая кодовая база поставляется как модуль или через Git. Обновления раскатываются отдельно на каждый инстанс. Подходит когда клиенты хотят независимость (свои данные, свои бэкапы), требуется разная конфигурация, или строгие требования к изоляции данных (GDPR, медицина).
Как работает мультитенантность в одной инсталляции?
Для агрегаторов и SaaS-продуктов на Битрикс строится мультитенантная архитектура:
- Таблица
b_lang— каждый сайт (тенант) с уникальнымLID - Шаблоны — общий базовый шаблон (
/local/templates/base/) + переопределения в/local/templates/{TENANT_ID}/ - Настройки тенанта — кастомная таблица
b_tenant_settingsс парамиTENANT_ID / KEY / VALUE - Пользователи — общая таблица
b_user, разделение по группам и поSITE_ID
Брендирование каждого тенанта:
// В init.php или в header шаблона $tenantId = SITE_ID; $tenantConf = TenantSettingsTable::getByTenantId($tenantId); define('TENANT_PRIMARY_COLOR', $tenantConf['PRIMARY_COLOR'] ?? '#0052cc'); define('TENANT_LOGO_URL', $tenantConf['LOGO_URL'] ?? '/logo.svg'); define('TENANT_DOMAIN', $tenantConf['DOMAIN']); CSS-переменные генерируются динамически через PHP, кешируются на уровне страницы:
$css = ":root { --primary: " . TENANT_PRIMARY_COLOR . "; --brand-font: " . $tenantConf['FONT'] . "; }"; Разработка ядра продукта как Битрикс-модуля
Если код продукта поставляется нескольким клиентам, его лучше оформить как модуль Битрикс. Модуль устанавливается через /bitrix/admin/partner_modules.php, регистрируется в b_module:
/local/modules/vendor.whitelabel/ ├── install/ │ ├── index.php │ └── db/install.sql ├── lib/ │ ├── TenantManager.php │ ├── BrandingService.php │ └── ... ├── options.php └── include.php Преимущество: модуль обновляется через стандартный механизм Битрикс (ModuleManager::isModuleInstalled(), ModuleManager::install()), аналогично стандартным модулям. На практике это сокращает время деплоя обновлений на 50%.
Разграничение функциональности по тарифам
White-label часто предполагает тарифные планы: базовый, стандарт, премиум. Каждый тарифный план открывает/закрывает часть функционала.
Проверка доступности фичи:
public static function hasFeature(string $feature, string $tenantId = SITE_ID): bool { $plan = self::getTenantPlan($tenantId); $features = self::PLAN_FEATURES[$plan] ?? []; return in_array($feature, $features, true); } if (!TenantLicenseManager::hasFeature('advanced_analytics')) { // Заглушка или редирект на страницу апгрейда } Матрица фич хранится в коде или в БД. Изменения тарифа применяются без деплоя.
Административный интерфейс для клиентов
Клиент white-label продукта должен управлять своим экземпляром. Это не стандартная админка Битрикс — она избыточна и небезопасна. Строится отдельный «личный кабинет партнёра»:
- Управление брендингом (загрузка логотипа, выбор цветов)
- Управление пользователями своего тенанта
- Просмотр статистики и аналитики
- Настройки уведомлений и интеграций
Реализация — отдельный раздел сайта с авторизацией по группе TENANT_ADMIN. Компоненты в /local/components/vendor.whitelabel/tenant.admin.*.
Почему важна изоляция данных между тенантами?
Критичный вопрос безопасности: данные тенанта A не должны быть видны тенанту B. Во всех запросах к инфоблокам добавляется обязательный фильтр по SITE_ID или по кастомному полю TENANT_ID:
$filter = array_merge($userFilter, ['=PROPERTY.TENANT_ID' => CURRENT_TENANT_ID]); $res = CIBlockElement::GetList([], $filter, ...); Для критичных данных (платёжная информация, персональные данные) рекомендуется разделение баз данных между тенантами — каждый тенант работает со своей схемой PostgreSQL. Битрикс не поддерживает это из коробки, но через переключение $DB объекта в начале каждого запроса это реализуемо.
Как обновлять кодовую базу при множестве клиентов?
Поддержка нескольких инсталляций — самая сложная операционная задача. При раздельных инстансах нужна система автоматического деплоя обновлений:
- Git-репозиторий с кодом модуля/шаблонов
- CI/CD (GitLab CI, GitHub Actions) с раскаткой на каждый сервер через SSH или Ansible
- Версионирование: модуль имеет
VERSIONвinstall/index.php, перед обновлением проверяется совместимость с версией Битрикс на сервере клиента
При единой инсталляции обновление проще — один деплой.
Типичные ошибки при проектировании white-label
- Игнорирование кэширования — тегированный кэш с учётом тенанта обязателен
- Хранение настроек в символьных константах, а не в БД
- Отсутствие мониторинга производительности при росте числа тенантов
Что входит в нашу работу?
Мы предоставляем полный комплект: документация по архитектуре, настройка CI/CD, обучение команды клиента, техническая поддержка на этапе запуска и сопровождение обновлений. Конкретный состав работ уточняется при постановке задачи.
Сроки ориентировочно
| Этап | Что входит | Срок |
|---|---|---|
| Прототип (1 тенант) | Архитектура, базовое брендирование, ЛК | 4–6 недель |
| Полноценный white-label | + тарифы, multi-tenant, CI/CD | 8–16 недель |
| Enterprise-изоляция | + разделение БД, аудит, SLA | 16–24 недели |
Сравнение архитектур
| Критерий | Мультисайтовость | Раздельные инсталляции |
|---|---|---|
| Изоляция данных | Средняя (фильтр по SITE_ID) | Полная (своя БД) |
| Сложность обновления | Низкая (один деплой) | Высокая (CI/CD на каждый инстанс) |
| Макс. кол-во клиентов | ~30 | Неограниченно |
| Лицензирование | Одна лицензия | На каждую инсталляцию |
White-label на Битрикс — нестандартное применение платформы, требующее глубокого понимания её архитектуры. При правильном проектировании система масштабируется от 5 до 500 клиентов без переписывания ядра. Наш опыт более 10 лет и сертифицированные специалисты гарантируют надёжность решения. Закажите прототип уже сегодня. Свяжитесь с нами для консультации по архитектуре вашего продукта.







