BitrixEnv — это набор пакетов и конфигураций, который превращает чистый сервер на AlmaLinux/CentOS в готовое окружение 1С-Битрикс. В отличие от образа BitrixVM, вы ставите его скриптом на уже существующую систему, сохраняя контроль над ОС.
Когда ставить окружение вручную
Ручная установка BitrixEnv оправдана, когда готовый образ не подходит по инфраструктурным причинам. Типичные сценарии:
- сервер уже развёрнут у хостера/в облаке и переустановка из OVA невозможна;
- нужна конкретная версия дистрибутива или своя разметка дисков (LVM, отдельный раздел под
/home/bitrix); - требуется вписать окружение в существующую систему мониторинга и резервного копирования;
- развёртывание автоматизируется через Ansible/Terraform и образ ВМ не вписывается в pipeline.
Подготовка сервера
BitrixEnv рассчитан на «чистую» ОС семейства RHEL — AlmaLinux 8/9, CentOS 7 и совместимые. Ставить его поверх сервера с уже настроенным вручную LAMP-стеком не следует: скрипт разворачивает свои конфиги nginx/php-fpm/MySQL и конфликтует с чужими.
- Обновите систему:
yum update -y. - Проверьте, что доступны официальные репозитории и есть выход в интернет (скрипт тянет пакеты из
repos.1c-bitrix.ru). - Убедитесь, что порты 80/443 не заняты сторонним веб-сервером.
- Задайте корректный
hostname— он станет именем master-узла в пуле.
enforcing с кастомными правилами, будьте готовы к тому, что часть настроек придётся выверять вручную.Установка через bootstrap-скрипт
Вендор поставляет установочный скрипт, который подключает репозиторий и ставит метапакет окружения. Классическая последовательность:
cd /root && wget http://repos.1c-bitrix.ru/yum/bootstrap/CentOS/bitrix-env.sh
chmod +x bitrix-env.sh && ./bitrix-env.sh
Скрипт подключает репозиторий bitrix, устанавливает пакет bitrix-env и тянет зависимости: nginx, httpd, php, mysql-сервер, memcached, push-server. По завершении он запускает то же меню, что и в BitrixVM, и просит задать пароль пользователя БД bitrix.
Установка занимает от нескольких минут в зависимости от скорости репозиториев. По окончании проверьте версию окружения командой cat /etc/sysconfig/pool и статус служб через systemctl.
Что устанавливается в составе окружения
BitrixEnv — это не один пакет, а согласованный набор служб с готовыми конфигами под 1С-Битрикс.
| Компонент | Роль | Где конфиги |
|---|---|---|
| nginx | фронтенд, статика, SSL, проксирование | /etc/nginx/bx/ |
| Apache + php-fpm | обработка PHP, backend | /etc/httpd/, /etc/php-fpm.d/ |
| MySQL/MariaDB | база данных | /etc/my.cnf.d/ |
| memcached | кэш данных и сессий | /etc/sysconfig/memcached |
| push-server | websocket-уведомления, RTC | /etc/nginx/bx/conf/ |
Всё это управляется единым инструментом окружения (утилиты bx-sites, bx-nodes и т. п.), а под капотом конфигурация раскатывается плейбуками Ansible из каталога /opt/webdir/.
Проверка после установки
Первое, что проверяет система «1С-Битрикс» — тест «Настройка веб-окружения» в разделе Настройки → Инструменты → Проверка системы. Он контролирует наличие нужных модулей PHP, прав, memcached и push.
- Проверьте PHP:
php -vиphp -m | grep -E "opcache|apcu|memcache". - Проверьте, что nginx проксирует на backend:
nginx -t && systemctl reload nginx. - Убедитесь, что окружение опознано:
cat /etc/sysconfig/poolдолжен показывать роль хоста.
/home/bitrix/www. Права должны принадлежать пользователю bitrix:bitrix, иначе появятся ошибки записи в кэш и загрузок.Перенос существующего сайта под окружение
Если сайт уже работал на «самосборном» стеке, перенос под BitrixEnv выполняют аккуратно, чтобы не потерять данные и настройки кэша.
- Скопируйте файлы в
/home/bitrix/www, выставьте владельцаchown -R bitrix:bitrix. - Импортируйте дамп БД в MySQL окружения, создайте пользователя и права.
- Приведите
bitrix/.settings.phpиbitrix/php_interface/dbconn.phpк параметрам окружения (memcached, кэш). - Через меню добавьте сайт в пул — окружение сгенерирует корректные vhost nginx и пул php-fpm.
Отличия от готового образа BitrixVM
Функционально окружения совпадают, но эксплуатационные нюансы есть:
| Аспект | BitrixVM (образ) | BitrixEnv (скрипт) |
|---|---|---|
| Скорость старта | минуты (импорт OVA) | зависит от репозиториев |
| Контроль над ОС | фиксированная сборка | полный, ваша инсталляция |
| Разметка дисков | предустановленная | любая, до установки |
| Автоматизация IaC | сложнее | вписывается в pipeline |
Для облачных провайдеров, где вы стартуете с базового образа AlmaLinux, вариант со скриптом — почти всегда единственно возможный.
Итог
Установка BitrixEnv на существующий сервер — это подготовка чистой ОС, запуск bootstrap-скрипта и проверка служб. Вы получаете то же окружение, что в образе, но с полным контролем над системой и возможностью вписать его в свою инфраструктуру.
Мы в B2Bsite разворачиваем BitrixEnv в облаке и на bare-metal, переносим действующие проекты под окружение без простоя и настраиваем автоматический деплой. Если нужна помощь с миграцией или проектированием масштабируемой инсталляции — возьмём это на себя.
Частые вопросы
Можно ли ставить BitrixEnv на Ubuntu или Debian?
Официально окружение рассчитано на дистрибутивы семейства RHEL — AlmaLinux, CentOS и совместимые. На Debian-системах установка не поддерживается.
Не сломает ли скрипт уже настроенный вручную LAMP?
Скорее всего да. BitrixEnv ставит свои конфиги nginx, php-fpm и MySQL, поэтому ставить его нужно на чистую ОС, а не поверх ручной сборки.
Откуда скрипт скачивает пакеты?
Из официального репозитория repos.1c-bitrix.ru. Серверу нужен исходящий доступ в интернет на время установки.
Где лежат сайты после установки?
Каталог по умолчанию — /home/bitrix/www, владелец bitrix:bitrix. Дополнительные сайты размещаются в /home/bitrix/ext_www.
Как проверить, что окружение установилось корректно?
Запустите штатную проверку системы в админке 1С-Битрикс и убедитесь, что службы nginx, mysqld, php-fpm и memcached активны через systemctl.
Почему мои правки в конфиге nginx исчезают?
Окружение перегенерирует vhost при изменениях через меню. Кастомные директивы выносите в отдельные подключаемые файлы, которые BitrixEnv не перезаписывает.
Нужно ли что-то делать с SELinux?
Установщик сам настраивает политику. Если у вас были свои правила в режиме enforcing, часть настроек придётся выверить вручную после установки.
Поможем с настройкой и поддержкой Для разработчиков
Поможем с настройкой, доработкой и поддержкой Для разработчиков.