Установка CRM Битрикс24 на Ubuntu 20.04/22.04

Установить Битрикс24 можно двумя способами: развернуть готовый образ BitrixVM или установить «коробку» вручную. В этой инструкции мы рассмотрим второй — установку через официальный скрипт bitrix-env.sh на чистую систему Ubuntu.

Подготовка сервера

Убедитесь, что у вас:

• Свежий сервер с Ubuntu 20.04 или 22.04 LTS
• Доступ по SSH от пользователя с правами sudo
• Статический IP-адрес или доменное имя
• SELinux отсутствует (в Ubuntu он не используется по умолчанию)

Установка веб-окружения Битрикс

Официальный скрипт автоматически настроит Nginx, PHP, MySQL и необходимые зависимости.

1. Установите curl и скачайте установочный скрипт

sudo apt update
sudo apt install -y curl
curl -sOL http://repos.1c-bitrix.ru/yum/bitrix-env.sh
chmod +x bitrix-env.sh

Важно: Несмотря на расширение .sh, скрипт совместим с Ubuntu. Он адаптирует установку под дистрибутив.

2. Запустите скрипт от root

sudo ./bitrix-env.sh

Скрипт выполнит проверки и установит:

• MySQL 8.0
• PHP 7.4 (временно — обновим до 8.1 позже)
• Nginx
• Memcached и другие зависимости

По завершении вы увидите:

Bitrix Environment bitrix-env has been installed successfully.

3. Сохраните пароль от MySQL

sudo cat /root/.my.cnf

Пароль будет указан в строке вида password='...'. Сохраните его.

Система может потребовать смены пароля root при первом входе. Также вместо firewalld (нет в Ubuntu) будет использоваться ufw или iptables.

Установка Битрикс24

Откройте в браузере:

http://<ваш_IP>/bitrixsetup.php

Следуйте мастеру установки:

1. Выберите «1С-Битрикс24» и «Демонстрационная версия» (или введите лицензионный ключ)
2. Примите лицензионное соглашение
3. Пропустите регистрацию (снимите галочку)
4. Создайте аккаунт администратора
5. Настройте портал и завершите установку

Настройка HTTPS через Let’s Encrypt

HTTPS обязателен для корректной работы Битрикс24.

1. Разрешите доступ к .well-known

sudo nano /etc/nginx/bx/site_enabled/s1.conf

Добавьте внутрь блока server:

location ~ /.well-known {
    root /var/www/html;
    allow all;
}

2. Установите Certbot

sudo apt install -y certbot

3. Получите сертификат

Замените bitrix.example.com на ваш домен. Убедитесь, что он указывает на IP сервера.

sudo certbot certonly --webroot -w /var/www/html \
  --agree-tos --email admin@example.com -d bitrix.example.com

4. Настройте Nginx на использование сертификата

sudo nano /etc/nginx/bx/conf/ssl.conf

Укажите пути:

ssl_certificate     /etc/letsencrypt/live/bitrix.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/bitrix.example.com/privkey.pem;

5. Перезапустите Nginx

sudo nginx -t && sudo nginx -s reload

6. Включите редирект с HTTP на HTTPS

sudo touch /home/bitrix/www/.htsecure
sudo chown bitrix:bitrix /home/bitrix/www/.htsecure

Обновление PHP до версии 8.1

Битрикс24 требует PHP ≥ 8.0. Установленный по умолчанию PHP 7.4 устарел.

1. Добавьте репозиторий Remi (для Ubuntu — Ondřej Surý)

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

2. Установите PHP 8.1 и необходимые модули

sudo apt install -y php8.1 php8.1-fpm php8.1-mysql php8.1-mbstring \
php8.1-xml php8.1-gd php8.1-opcache php8.1-curl php8.1-zip \
php8.1-ldap php8.1-sodium php8.1-memcached

3. Обновите конфигурацию Nginx

Битрикс в Ubuntu использует PHP-FPM. Убедитесь, что в /etc/nginx/bx/php-fpm.conf указан php8.1-fpm.

Если используется Apache (редко в новых установках), перезапустите его:

sudo systemctl restart apache2

Но чаще — используется Nginx + PHP-FPM:

sudo systemctl restart php8.1-fpm nginx

4. Проверьте версию PHP в админке

Перейдите: Настройки → Производительность → PHP.

Важно: Перед обновлением создайте резервную копию (снапшот ВМ или бэкап сайта и БД).

Настройка кэширования (Memcached)

Memcached уже установлен скриптом, но убедимся, что он активен.

sudo systemctl enable memcached --now

Создайте файл /home/bitrix/www/bitrix/.settings_extra.php:

<?php
return [
  'cache' => [
    'value' => [
      'type' => [
        'class_name' => '\\Bitrix\\Main\\Data\\CacheEngineMemcache',
        'extension' => 'memcache'
      ],
      'memcache' => [
        'host' => '127.0.0.1',
        'port' => '11211',
      ],
      'sid' => $_SERVER["DOCUMENT_ROOT"]."#01"
    ],
  ],
];
?>

И добавьте в /home/bitrix/www/bitrix/php_interface/dbconn.php:

define("BX_CACHE_TYPE", "memcache");
define("BX_CACHE_SID", $_SERVER["DOCUMENT_ROOT"]."#01");
define("BX_MEMCACHE_HOST", "127.0.0.1");
define("BX_MEMCACHE_PORT", "11211");

Перезапустите PHP-FPM и Nginx:

sudo systemctl restart php8.1-fpm nginx

Добавление второго сайта (например, интернет-магазина)

Запустите меню управления:

sudo /root/menu.sh

Следуйте инструкциям:

1. Выберите «Create management pool»
2. Укажите домен (например, shop.example.com)
3. В меню пула выберите «Configure pool sites» → «Create a site»
4. Укажите домен и тип kernel (отдельная БД)
5. Разрешите cron

После этого сайт будет доступен по новому домену.

Решение типичных проблем

Ошибка «Работа с сокетами не поддерживается»

• Убедитесь, что сайт доступен по HTTPS
• Обновите CA-сертификаты: sudo apt install -y ca-certificates

Ошибка 504 при оптимизации БД

Увеличьте таймауты в Nginx:

sudo nano /etc/nginx/nginx.conf

Добавьте в блок http:

proxy_connect_timeout 3600;
proxy_send_timeout    3600;
proxy_read_timeout    3600;

Не забудьте вернуть значения после завершения операции!

Временная папка не существует

sudo mkdir -p /home/bitrix/tmp/bak
sudo chown bitrix:bitrix /home/bitrix/tmp/bak

Заключение

Теперь у вас полноценный портал Битрикс24 на Ubuntu. Для продакшена рекомендуется:

• Настроить резервное копирование
• Использовать внешний SMTP-сервер для почты
• Регулярно обновлять систему и Битрикс

Если возникли вопросы — включите логирование в /home/bitrix/www/bitrix/.settings.php (установите 'debug' => true) и изучите bitrix/modules/error.log.