Как установить модуль 1С-Битрикс: пошаговое руководство

Модуль в 1С-Битрикс — это самостоятельный функциональный блок, который расширяет возможности системы управления сайтом: от интеграции с 1С:Управление торговлей до SEO-инструментов и платёжных агрегаторов. Установка модуля — штатная операция администратора, но она затрагивает файловую структуру и базу данных, поэтому требует аккуратности и предварительной подготовки.

Существует два основных способа установки: через встроенный каталог Marketplace прямо из административной панели и вручную — загрузкой файлов модуля на сервер. Первый способ подходит для большинства ситуаций и выполняется в несколько кликов, второй нужен для самописных решений, модулей, купленных вне Marketplace, или когда на сервере ограничен доступ к внешним ресурсам.

Перед любыми действиями убедитесь, что у вас есть актуальная резервная копия сайта и базы данных, а также доступ к административной панели с правами главного администратора. Ошибка при установке модуля может нарушить работу сайта, и откат без бэкапа займёт значительно больше времени, чем сама установка.

Что проверить перед установкой модуля

Начните с проверки лицензии: установка решений из Marketplace доступна только при активной лицензии 1С-Битрикс с действующим периодом обновлений. Откройте «Настройки → Обновление платформы» и убедитесь, что система обновлений работает и лицензионный ключ введён корректно. Если срок обновлений истёк, часть решений будет недоступна для установки.

Второй шаг — сверка технических требований модуля с вашим окружением. Уточните минимальную версию ядра Битрикса, требуемую версию PHP и наличие зависимостей от других модулей. Эта информация указана на странице решения в Marketplace или в документации разработчика. Установка модуля, рассчитанного на более новую версию ядра, часто завершается ошибкой или некорректной работой компонентов.

Третий шаг — резервное копирование. Используйте штатный механизм «Настройки → Инструменты → Резервное копирование» либо средства хостинга. Копия должна включать и файлы, и базу данных: модуль при установке может создавать таблицы, инфоблоки, агенты и обработчики событий.

Установка модуля через Marketplace

Это рекомендуемый способ для всех решений, опубликованных в каталоге. Авторизуйтесь в административной панели под учётной записью с полными правами и перейдите в раздел «Marketplace → Каталог решений». Найдите нужный модуль через поиск или рубрикатор и откройте его карточку, чтобы проверить совместимость с вашей редакцией и версией платформы.

Нажмите кнопку «Установить» (или «Купить», если решение платное, и пройдите процедуру оплаты). Система загрузит дистрибутив, распакует файлы и запустит мастер установки. В зависимости от модуля мастер может предложить выбрать параметры: устанавливать ли демо-данные, для каких сайтов активировать решение, какие права выдать группам пользователей.

Дождитесь сообщения об успешном завершении. После этого модуль появится в списке «Marketplace → Установленные решения» и в общем реестре «Настройки → Модули». Некоторые решения требуют дополнительной настройки: заполнения доступов к API, выбора инфоблоков или настройки агентов — эти шаги описаны в документации конкретного модуля.

1. 1
   Сделайте резервную копию файлов и базы данных
2. 2
   Проверьте активность лицензии и версию ядра
3. 3
   Откройте Marketplace и найдите решение
4. 4
   Нажмите «Установить» и пройдите шаги мастера
5. 5
   Проверьте появление модуля в списке «Настройки → Модули»
6. 6
   Выполните постустановочную настройку по документации

Ручная установка модуля из архива

Ручной способ применяется для модулей, разработанных под заказ, полученных от интегратора напрямую или скачанных из сторонних источников. Дистрибутив обычно представляет собой архив, внутри которого находится папка с кодом модуля вида partner.modulename — префикс партнёра и системное имя модуля через точку.

Распакуйте архив и загрузите папку модуля на сервер по FTP/SFTP или через файловый менеджер хостинга. Для кастомных решений правильное расположение — каталог /local/modules/: он не перезаписывается при обновлении ядра. Каталог /bitrix/modules/ предназначен для штатных и маркетплейс-модулей; размещать туда свои разработки не рекомендуется.

После загрузки файлов откройте в админке «Настройки → Модули». Найдите модуль в списке — он отобразится со статусом «Не установлен» — и нажмите «Установить». Система выполнит установочный скрипт: создаст таблицы, зарегистрирует обработчики и агенты. Если модуль в списке не появился, проверьте имя папки и наличие файла install/index.php внутри неё.

# Пример: распаковка модуля в каталог local/modules
unzip partner.modulename.zip -d /var/www/site/local/modules/
chown -R www-data:www-data /var/www/site/local/modules/partner.modulename

Проверка результата установки

После установки убедитесь, что модуль действительно работает, а не просто числится в реестре. Откройте «Настройки → Модули» и проверьте статус: напротив решения должна стоять отметка об установке, а в колонке версии — актуальный номер. Затем найдите в административном меню раздел настроек модуля и убедитесь, что страница открывается без ошибок PHP.

Проверьте публичную часть сайта: пройдите по основным страницам, формам и корзине, если модуль затрагивает торговый функционал. Полезно включить режим отладки или просмотреть лог ошибок сервера — предупреждения уровня notice и warning часто указывают на конфликт версий, даже когда сайт внешне работает.

Типичные ошибки и способы их устранения

Наиболее частая проблема — ошибка прав доступа к файлам: мастер установки не может записать файлы в системные каталоги. Проверьте права на папки /bitrix/modules/ и /local/modules/ и владельца процессов веб-сервера. На большинстве хостингов проблема решается через панель управления или обращение в поддержку хостера.

Вторая распространённая ситуация — конфликт версий: модуль требует функции ядра, которых нет в вашей установке. Решение одно — обновить платформу через «Настройки → Обновление платформы» до актуальной версии и повторить установку. Если обновление невозможно, ищите более раннюю версию модуля, совместимую с вашим ядром.

Третья группа ошибок связана с базой данных: установка прерывается на создании таблиц из-за недостатка прав пользователя БД или нехватки места на диске. Проверьте свободное место на сервере и права учётной записи MySQL. Если установка зависла на середине, удалите модуль через список модулей (с опцией удаления таблиц), очистите остатки и повторите процедуру.

Обновление и удаление установленных модулей

Решения из Marketplace обновляются централизованно: перейдите в «Marketplace → Обновление решений», где отображаются доступные новые версии. Перед обновлением читайте список изменений — если модуль дорабатывался под ваш проект, обновление может перезаписать кастомизацию. Доработанные решения обновляйте только после согласования с разработчиком.

Удаление модуля выполняется через «Настройки → Модули»: нажмите «Удалить» в меню действий напротив решения. Мастер предложит сохранить или удалить данные модуля — таблицы, инфоблоки, настройки. Если модуль использовался в работе (например, накапливал заказы или логи), сохраните данные либо предварительно выгрузите их, иначе информация будет потеряна безвозвратно.

После удаления проверьте, не осталось ли «висячих» ссылок на компоненты модуля на страницах сайта: страницы с удалёнными компонентами начнут выдавать ошибки. Также проверьте список агентов и обработчиков событий — некоторые модули оставляют задания в cron, которые нужно отключить вручную.

Часто задаваемые вопросы