Как запустить консоль сервера битрикс

Для управления проектом на Битрикс с максимальной эффективностью необходим доступ к консоли сервера. Это позволяет выполнять миграции, управлять кэшем, индексировать контент, запускать агенты и выполнять другие задачи без доступа к административной панели.

Работа с консолью начинается с подключения к серверу через SSH. Убедитесь, что у вас есть права пользователя, под которым работает веб-сервер (обычно www-data или apache). После авторизации перейдите в корневой каталог проекта, как правило, это /home/bitrix/ext_www/ваш-домен/.

Далее необходимо убедиться в наличии скрипта bitrix.php в директории bitrix/modules/main/tools. Если он отсутствует, возможно, потребуется обновление платформы или ручная загрузка соответствующего инструментария. Консоль запускается командой php bitrix/modules/main/tools/console.php, при этом должна использоваться та же версия PHP, что и на продакшн-сервере.

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

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

Для работы с консолью Битрикс необходимо убедиться, что у вас есть доступ к командной строке сервера, на котором размещён сайт. Если используется VPS или выделенный сервер, подключение осуществляется по SSH. В случае shared-хостинга – только при наличии соответствующей опции у провайдера.

Подключитесь к серверу с помощью SSH-клиента. На Windows используйте PuTTY или встроенный терминал Windows 10/11 (через ssh user@host). На Linux и macOS откройте терминал и выполните команду:

ssh имя_пользователя@IP_адрес_сервера

После ввода пароля или подтверждения ключа должен открыться терминал сервера. Если возникает ошибка «Permission denied» или «Connection refused», проверьте правильность данных и доступность SSH в настройках сервера.

После подключения выполните команду whoami, чтобы удостовериться, под каким пользователем вы вошли. Доступ к консоли Битрикс требует прав на выполнение PHP-скриптов и записи в корневой каталог проекта.

Убедитесь, что доступен PHP в командной строке. Выполните:

php -v

Если команда возвращает версию PHP, можно переходить к следующему этапу. В противном случае – PHP не установлен или не добавлен в переменную среды PATH. Решается через установку или настройку интерпретатора.

Проверьте, существует ли директория с проектом Битрикс и имеет ли пользователь доступ к ней. Выполните:

ls /путь/к/проекту/bitrix

Если команда возвращает содержимое каталога, доступ имеется. При ошибке «Permission denied» настройте права доступа через chown или обратитесь к системному администратору.

Определение используемой операционной системы хостинга

Если доступен файл /etc/os-release, выполните команду cat /etc/os-release. Она отобразит дистрибутив, версию и дополнительные сведения. Например, строка PRETTY_NAME="Ubuntu 22.04.2 LTS" однозначно определяет систему.

На CentOS и производных можно использовать cat /etc/centos-release. Для AlmaLinux и Rocky Linux: cat /etc/redhat-release.

Если доступен только хостинг-панельный интерфейс (например, cPanel или ISPmanager), информация о системе может быть указана в разделе «Информация о сервере» или «Сведения о системе».

На Windows-серверах подключение осуществляется через RDP. После входа откройте «Командную строку» и выполните systeminfo. Найдите строку OS Name и OS Version для получения данных.

Для BitrixVM, основанной на CentOS/AlmaLinux, команды cat /etc/os-release и hostnamectl дадут точную информацию о версии и типе ОС.

Подключение к серверу через SSH с помощью терминала

Откройте терминал на локальной машине. Убедитесь, что установлен SSH-клиент: введите ssh -V. Если команда возвращает версию клиента, можно продолжать. В противном случае установите пакет OpenSSH.

Для подключения к серверу потребуется IP-адрес и имя пользователя, имеющего доступ. Команда подключения:

ssh username@server_ip

Замените username на имя пользователя, server_ip – на IP-адрес сервера. Если используется нестандартный порт, добавьте флаг -p:

ssh username@server_ip -p 2222

При первом подключении подтвердите ключ безопасности сервера, введя yes. Затем введите пароль пользователя.

Рекомендуется использовать аутентификацию по ключу. Сгенерируйте ключ командой:

ssh-keygen -t rsa -b 4096

По умолчанию ключи сохраняются в ~/.ssh/id_rsa и id_rsa.pub. Чтобы передать публичный ключ на сервер, используйте:

ssh-copy-id username@server_ip

После этого вход будет выполняться без ввода пароля, при условии правильных прав на каталог ~/.ssh (700) и файл authorized_keys (600).

Для диагностики используйте параметр -v:

ssh -v username@server_ip

Если соединение не устанавливается, проверьте:

Доступность порта на сервере (например, telnet server_ip 22)
Работу SSH-сервиса: systemctl status sshd
Настройки файрвола и правил безопасности (например, ufw status или iptables -L)

Переход в директорию проекта Битрикс

Для запуска консоли Битрикс необходимо перейти в корневую директорию проекта, где расположен файл bitrix или bitrix/.settings.php. Обычно структура проекта включает каталог, в котором находятся папки bitrix, local и файл bitrix.php.

Откройте терминал на сервере или локальной машине, в зависимости от того, где размещён проект.
Подключитесь к серверу по SSH, если проект размещён на удалённой машине:
```
ssh имя_пользователя@адрес_сервера
```
Перейдите в корневую папку веб-сервера. Например, для Apache это может быть:
```
cd /var/www/html
```
Определите директорию, в которой расположен проект. Обычно она совпадает с доменным именем или указана в конфигурации веб-сервера.
Выполните переход в директорию проекта:
```
cd /var/www/html/имя_проекта
```

Проверьте, что вы в нужной директории, выполнив:

ls

Должны отображаться каталоги bitrix, local, upload, файл .settings.php и другие элементы структуры Битрикс.

Находясь в корне проекта, можно запускать консольные команды через php или файл bitrix/php_interface/init.php, в зависимости от используемого метода интеграции консоли.

Запуск консоли Bitrix Framework через php bitrix

Для запуска консоли Bitrix Framework используется скрипт bitrix, расположенный в корне проекта. Этот инструмент доступен в редакции Bitrix Framework, начиная с версии 20.0.0. Перед запуском убедитесь, что у вас установлен PHP не ниже 7.1 и настроена переменная окружения DOCUMENT_ROOT, если проект не открыт через веб-сервер.

Перейдите в корневую директорию проекта и выполните команду:

php bitrix

Если консоль запускается впервые, могут потребоваться права на выполнение. В этом случае предварительно выполните:

chmod +x bitrix

При успешном запуске появится список доступных команд. Для получения справки по конкретной команде используйте:

php bitrix help имя_команды

Наиболее часто используемые команды:

php bitrix module:install название – установка модуля;
php bitrix orm:generate – генерация ORM-классов;
php bitrix cache:clear – очистка кеша;
php bitrix migration:run – выполнение миграций.

Чтобы консоль распознавала правильный путь до ядра Bitrix, убедитесь, что структура проекта соответствует стандарту Bitrix Framework: наличие каталога bitrix и файла bitrix/.settings.php. В проектах с изменённой структурой используйте флаг —root:

php bitrix --root=/путь/до/проекта команда

Для автоматизации задач консоль можно интегрировать в cron или использовать в shell-скриптах. Обязательно указывайте абсолютные пути к PHP и проекту, чтобы избежать ошибок окружения.

Активация окружения Bitrix Virtual Appliance

Для запуска консоли сервера необходимо активировать окружение Bitrix Virtual Appliance. Это выполняется непосредственно через подключение к серверу по SSH.

Подключитесь к серверу с помощью SSH-клиента, используя логин root или другого пользователя с правами администратора.
Выполните команду:
```
/root/menu.sh
```
Это основной интерфейс управления окружением BitrixVA.
Дождитесь загрузки текстового меню. Если оно не запускается, проверьте наличие файла /root/menu.sh и права на его исполнение:
```
chmod +x /root/menu.sh
```
После запуска меню выберите пункт 1. Управление виртуальной машиной.
Далее активируйте окружение, выбрав 9. Перезапуск окружения или 8. Запуск окружения, если оно ранее не запускалось.

При активации окружения автоматически запускаются все необходимые службы: веб-сервер, PHP, база данных, cron-задачи Bitrix.

Убедитесь, что после запуска нет ошибок в логах /var/log/bitrix-env.log.
Проверьте статус служб командой supervisorctl status.

Если BitrixVA установлена не в корень, используйте абсолютный путь к menu.sh, например /opt/bitrix/menu.sh.

Выполнение базовых команд консоли Битрикс

Консоль запускается из корня проекта через команду php bitrix/modules/main/tools/console.php или через vendor/bin/bitrix, если используется Composer.

Очистка кеша выполняется командой:

php bitrix/modules/main/tools/console.php cache:clear

Эта команда удаляет все типы кеша, включая компоненты и шаблоны. Для выборочной очистки можно указать тип, например —type html_cache.

Миграции применяются командой:

php bitrix/modules/main/tools/console.php orm:migrate

Перед запуском убедитесь, что миграции размещены в папке local/php_interface/migrations или в указанной директории. Для отката используйте orm:migrate:rollback.

Создание администратора:

php bitrix/modules/main/tools/console.php user:create —admin

Укажите флаги —login, —password и —email, иначе будет запрошен ввод вручную.

Управление модулями:

php bitrix/modules/main/tools/console.php module:install название_модуля

Для удаления – module:uninstall. Убедитесь, что модуль установлен в системе или доступен в marketplace.

Проверка производительности запускается через:

php bitrix/modules/main/tools/console.php performance:test

Диагностика ошибок при запуске консоли

Если консоль Bitrix не запускается, первым шагом проверьте доступность файла bitrix.php по пути bitrix/modules/main/tools/. Его отсутствие указывает на некорректную установку или повреждение платформы.

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

php bitrix.php

или

php -f bitrix.php

в зависимости от версии PHP и настроек CLI. Убедитесь, что текущая директория – корень сайта.

Проверьте версию PHP: Bitrix CLI требует не ниже 7.4. Выполните php -v и убедитесь в соответствии. При наличии нескольких версий PHP уточните, какой бинарник используется, выполнив which php или php -i | grep «Loaded Configuration File».

Если отображается ошибка «Cannot find autoload.php», проверьте наличие файла vendor/autoload.php. Его отсутствие указывает на необходимость запуска composer install в корне проекта. Composer должен быть установлен в системе и доступен из командной строки.

При ошибках, связанных с правами доступа, убедитесь, что текущий пользователь имеет права на выполнение файлов в директории проекта. В Linux выполните chmod +x bitrix.php и убедитесь, что файлы доступны для чтения и записи веб-сервером и CLI-пользователем.

Если появляется сообщение об ошибке подключения к базе данных, откройте bitrix/.settings.php и проверьте параметры connections.mysql. Ошибки авторизации или подключения часто вызваны изменением пароля или имени БД без соответствующей корректировки конфигурации.

В случае непонятных или критических ошибок запустите консоль с флагом отображения ошибок PHP:

php -d display_errors=1 bitrix.php

Лог ошибок PHP поможет в диагностике. Его расположение определяется директивой error_log в php.ini. Также проверьте bitrix/logs, если включена системная логика логирования платформы.