Обзор развертывания Bitrix24 на сервере¶

Предварительные требования¶

Для корректной работы приложения на сервере необходимы следующие условия:

Операционная система на базе Debian или Ubuntu (поддерживается пакетный менеджер apt).
Права доступа суперпользователя (root) или права sudo для выполнения команд установки и настройки.
Доменное имя в зоне hostkey.in.
Открытые сетевые порты для веб-трафика (80 и 443) для работы веб-сервера и получения SSL-сертификатов.

FQDN итоговой панели на домене hostkey.in¶

Формирование полного доменного имени происходит по шаблону <prefix><ID сервера>.hostkey.in. В данной конфигурации префикс установлен как bitrix24. Итоговый адрес будет иметь вид: bitrix24<ID сервера>.hostkey.in Доступ к приложению осуществляется через стандартный веб-порт 443 (HTTPS).

Структура файлов и каталогов¶

Ключевые компоненты системы размещаются в следующих каталогах:

/var/www/html — корневая директория для размещения файлов веб-приложения.
/etc/apache2/sites-available/ — каталог с конфигурационными файлами виртуальных хостов Apache.
/etc/php/8.1/apache2/ и /etc/php/8.1/cli/ — директории с конфигурационными файлами PHP.
/var/lib/mysql — стандартное расположение данных базы данных MySQL (не указано явно в конфигурации, но подразумевается пакетом mysql-server).
/var/www/html/bitrixsetup.php — место размещения скрипта установки Bitrix24 после загрузки.

Процесс установки приложения¶

Установка выполняется путем развертывания стандартных пакетов Debian и настройки среды выполнения:

Обновление кэша пакетов и установка программного обеспечения.
Установка веб-сервера apache2 и всех необходимых модулей PHP версии 8.1.
Настройка параметров интерпретатора PHP через редактирование файла php.ini.
Создание конфигурации виртуального хоста Apache.
Активация модулей перезаписи (rewrite) и нового сайта в Apache.
Перезапуск службы веб-сервера.
Автоматическая генерация и установка SSL-сертификата с помощью утилиты certbot.
Создание пользователя базы данных и самой базы данных.
Скачивание скрипта установки bitrixsetup.php в корневую директорию.

Базы данных¶

Приложение использует базу данных MySQL со следующими параметрами подключения:

Имя базы данных: sitemanager.
Пользователь базы данных: admin.
Права доступа: Пользователь имеет полные права (ALL) на все базы данных и таблицы (*.*).
Путь к сокету для локального подключения: /run/mysqld/mysqld.sock.

Конфигурация PHP¶

Параметры интерпретатора PHP версии 8.1 изменены в файле /etc/php/8.1/apache2/php.ini для соответствия требованиям приложения:

Параметр	Значение	Описание
`memory_limit`	`256M`	Максимальный объем памяти для скрипта.
`upload_tmp_dir`	`/var/www/html`	Временная директория для загрузки файлов.
`short_open_tag`	`On`	Включение поддержки коротких тегов.
`max_input_vars`	`10000`	Максимальное количество переменных входа.
`date.timezone`	`Europe/Moscow`	Часовой пояс.
`opcache.revalidate_freq`	`0`	Частота проверки обновлений кэша (отключено).

Аналогичная настройка short_open_tag = On применяется также к файлу /etc/php/8.1/cli/php.ini.

Прокси серверы и веб-сервер¶

В качестве веб-сервера используется Apache2. Для каждого сервера создается отдельная конфигурация виртуального хоста в файле /etc/apache2/sites-available/bitrix24<ID сервера>.hostkey.in.conf.

Основные настройки виртуального хоста:

Порт прослушивания: 80 (HTTP).
Корневая директория (DocumentRoot): /var/www/html.
Разрешение директив .htaccess: AllowOverride all для директории /var/www/html.
Включение модуля rewrite для обработки правил перезаписи URL.
Генерация и настройка SSL-сертификатов через certbot для автоматического перенаправления на HTTPS.

Настройки прав доступа¶

Для обеспечения работы приложения с файлами выполнены следующие действия:

Директории /var/www/html и все содержащиеся в ней файлы разрешены для записи любыми пользователями (o+w).
Пользователь веб-сервера (www-data по умолчанию для Apache) имеет полный доступ к корневой директории сайта.

Расположение конфигурационных файлов и данных¶

Конечные конфигурационные файлы и пути к данным:

Конфигурация веб-сервера: /etc/apache2/sites-available/bitrix24<ID сервера>.hostkey.in.conf.
Конфигурация PHP для Apache: /etc/php/8.1/apache2/php.ini.
Конфигурация PHP для командной строки: /etc/php/8.1/cli/php.ini.
Скрипт установки приложения: /var/www/html/bitrixsetup.php.
Логи веб-сервера: ${APACHE_LOG_DIR}/error.log и ${APACHE_LOG_DIR}/access.log (обычно /var/log/apache2/).

Доступные порты для подключения¶

После настройки SSL-сертификата и работы веб-сервера доступны следующие порты:

Порт 80 (HTTP) — используется для перенаправления на защищенное соединение или для первоначальной установки сертификатов.
Порт 443 (HTTPS) — основной порт для работы веб-приложения Bitrix24.

Запуск, остановка и обновление¶

Управление сервисом веб-сервера Apache2 осуществляется через систему systemd. После применения конфигурационных изменений необходимо выполнить перезапуск службы для применения настроек:

Перезапуск и активация службы при загрузке:
```
systemctl restart apache2
systemctl enable apache2
```
В процессе настройки конфигурация применяется автоматически с перенастройкой демонов (daemon_reload).

Для повторной выдачи или обновления SSL-сертификата используется утилита certbot в режиме --apache.