Обновление BitrixVM: пакеты сервера, версия PHP и база данных

Веб-окружение «1С-Битрикс» (BitrixVM) обновляется не само и не вместе с сайтом. Обновлений здесь три, и они независимы: продукт 1С-Битрикс через админку, пакеты окружения и системы через меню BitrixVM, версия PHP и базы данных — отдельным пунктом того же меню. Пропущенное обновление PHP — это не только устаревший синтаксис, но и незакрытые уязвимости: в октябре 2026 года вышли исправления двух критических дыр, через которые на сервере выполняется чужой код, и единственная защита от них — обновление PHP.

Инструкция актуальна для BitrixVM 9 на AlmaLinux 9 — текущей ветки веб-окружения. В ней меню перестроено по сравнению с прежними версиями: добавился раздел управления текущим хостом, а пункт обновления PHP теперь включает и PostgreSQL.

Что сделать до обновления

• Снимите резервную копию сайта и базы — по этой инструкции. Отдельно убедитесь, что копия скачана за пределы сервера.
• Обновите сам продукт 1С-Битрикс до актуальной версии на текущем PHP. Старое ядро на новой версии PHP — самая частая причина белого экрана после обновления.
• Проверьте совместимость на тестовой копии, если на сайте есть собственные доработки, компоненты из Маркетплейса или интеграции. Поднимать копию проще всего на отдельном хосте с тем же окружением.
• Выберите окно работ. Обновление пакетов и PHP занимает от нескольких минут до часов — зависит от объёма данных и мощности сервера.

Как попасть в меню

Подключитесь к серверу по SSH под пользователем root — меню запускается автоматически. Если вы вышли из него, вернитесь командой:

/opt/webdir/bin/bitrix_menu.sh

Главное меню BitrixVM 9 выглядит так:

Available actions:

                 0. Manage current host
                 1. Manage group of servers

Раздел 0. Manage current host управляет только той машиной, на которой вы находитесь: имя хоста, сеть, обновление и выключение сервера. Раздел 1. Manage group of servers — это менеджер пула: он управляет всеми машинами окружения, даже если машина одна. Именно он нужен для обновлений.

                 1. Add new host to the pool
                 2. Remove host from the pool
                 3. Reboot host
                 4. Update packages on host
                 5. Change 'bitrix' user password on host
                 6. Configure pool timezone
                 7. Remove pool configuration
                 8. Update PHP, MySQL, PostgreSQL
                 9. Rename host
                10. Change repository

Обновление пакетов сервера

Выберите 1. Manage group of servers → 4. Update packages on host. Система спросит имя хоста, а затем — что именно обновлять:

• bitrix — только пакеты веб-окружения: Apache, nginx, PHP текущей ветки, утилиты BitrixVM;
• all — окружение и систему целиком, включая ядро и системные библиотеки.

Вариант all правильнее: уязвимости находят не только в PHP. Но он чаще требует перезагрузки сервера, поэтому его планируют на окно работ. Если нужно закрыть конкретную проблему в PHP прямо сейчас — начните с bitrix, а полное обновление проведите следом.

Менеджер пула ставит задачу в фоновую очередь и возвращает вас в меню. Это не значит, что обновление закончилось.

Как следить за фоновыми задачами

Задачи выполняются от нескольких минут до двух-трёх часов. Посмотреть текущие можно через Background pool tasks → 1. View running tasks. Подробные логи лежат на сервере:

ls -lt /opt/webdir/temp | head
ls -lt /opt/webdir/logs | head

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

Смена версии PHP

Версия PHP при обновлении пакетов не меняется: Update packages on host обновляет текущую ветку, например 8.2.33 до 8.2.35, но не переводит с 8.2 на 8.3. Для смены ветки есть отдельный пункт 1. Manage group of servers → 8. Update PHP, MySQL, PostgreSQL:

                 1. Upgrade PHP
                 2. Downgrade PHP
                 3. Upgrade MySQL version
                 4. Upgrade PostgreSQL version

В Upgrade PHP предлагаются ветки, которые поддерживает текущее окружение:

                 1. Update PHP to version 8.5
                 2. Update PHP to version 8.4
                 3. Update PHP to version 8.3
                 4. Update PHP to version 8.2

Дальше укажите хост: all — обновить PHP на всех машинах с ролью web, либо конкретное имя хоста. В пуле из нескольких машин обновлять нужно каждую.

Какую версию выбирать. Коробочному Битрикс24 и 1С-Битрикс нужен PHP не ниже 8.2. Но у 8.2 срок поддержки заканчивается 31 декабря 2026 года — после этого исправления безопасности для неё выходить перестанут. Если переходите сейчас, разумнее сразу брать 8.3 или 8.4: это тот же объём работ по проверке совместимости, но запас на пару лет вперёд.

Понижение версии делается через 2. Downgrade PHP — доступны ветки с 8.1 по 8.4. Это запасной выход на случай, если после перехода что-то отвалилось и чинить некогда. Пользоваться им как постоянным решением не стоит: 8.1 уже не получает исправлений от разработчиков PHP.

Обновление MySQL и PostgreSQL

В том же разделе: 3. Upgrade MySQL version поднимает базу до версии 8.4, 4. Upgrade PostgreSQL version — до 15.

Два предупреждения, которые стоят внимания больше, чем сам пункт меню:

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

После обновления

1. Откройте в админке Настройки → Инструменты → Проверка системы и посмотрите версии PHP и базы — они должны совпадать с тем, что вы ставили. Консольный php -v показывает версию для командной строки, у сайта она может быть другой.
2. Прогоните основные сценарии: вход в админку и личный кабинет, формы, загрузку файлов, отправку почты, работу CRM и обмен с 1С.
3. Посмотрите журнал ошибок PHP за первые часы: новые предупреждения уровня Deprecated — сигнал, что часть кода пора править, даже если сайт работает.
4. Проверьте, что сайт по-прежнему собирает кеш и фоновые агенты отрабатывают.

Проверка сертификатов после обновления

Эту проверку стоит делать каждый раз, и вот почему. Штатный сценарий продления сертификатов удаляет файлы старше 120 дней безусловно — не проверяя, выпустились ли новые и используются ли старые в конфигурации nginx. Если какой-то домен перестал резолвиться, а его сайт остался включённым, сертификат исчезнет, симлинк повиснет, и ближайшая перезагрузка оставит сервер без веб-сервера целиком.

Две команды ловят это заранее:

• find /home/bitrix/dehydrated/certs/ -xtype l — список симлинков, указывающих в никуда. Пустой ответ хороший.
• nginx -t — проверка конфигурации без перезапуска. Делать до перезагрузки, а не после.

Заодно загляните в список доменов продления и уберите оттуда сайты, которых больше нет.

Что чаще всего ломается

• Старые решения из Маркетплейса. Если модуль давно не обновлялся, на новой ветке PHP он может не запуститься. Обновите такие модули до перехода, а брошенные замените.
• Собственные доработки. Код, написанный под PHP 7.x, спотыкается на изменениях синтаксиса и строгих типах. Ошибки обычно видны не на главной, а в редких сценариях — поэтому и нужна тестовая копия.
• Устаревшее ядро продукта. Если обновление 1С-Битрикс откладывали годами, безопаснее сначала поднять продукт, а потом окружение.
• Нехватка места. Обновление пакетов и базы требует свободного места на диске. Проверьте его заранее — как это сделать.

Если сервер на старой версии окружения

Прежние сборки BitrixVM работали на CentOS 7, снятой с поддержки 30 июня 2024 года. На ней обновления безопасности не выходят — ни для системы, ни для PHP, и описанные пункты меню там другие. Такой сервер обновлять бессмысленно, его нужно переносить на актуальное окружение девятой ветки. Это отдельная работа: поднять новый сервер, перенести сайт и данные, проверить и переключить трафик.

Если нужна помощь — напишите нам: обновим окружение и PHP без простоя сайта, а при необходимости перенесём проект на поддерживаемую систему.