Установка Битрикса и мастер настройки: ошибки новичков

К концу этой инструкции у вас будет работающий сайт на «1С-Битрикс: Управление сайтом» и вход в админку по адресу /bitrix/admin/. При готовом сервере закладывайте 30–40 минут: сам мастер отрабатывает за несколько минут, остальное уходит на PHP, базу и права на папку. Инструкция рассчитана на актуальные редакции продукта и PHP 8.x. Минимальные версии для вашей редакции сверьте в документации.

Что нужно до начала

• Сервер или хостинг с PHP 8.x, MySQL или MariaDB и веб-сервером Apache или Nginx. Точные минимальные версии зависят от редакции.
• Доступ по SSH или к файловому менеджеру, а также к панели баз данных.
• Домен, направленный на сервер. Для проверки подойдёт и поддомен.
• Пустой корень сайта [1] и право записи в него для пользователя веб-сервера.
• Свободное место: архив и распакованные файлы лежат на диске одновременно.
• Лицензионный ключ либо готовность взять пробный режим.

Пошаговая установка

1. Подготовьте PHP. Мастер распаковывает архив и пишет в базу крупными порциями, стандартные лимиты ему тесны. Значения ниже взяты с запасом, это не официальный минимум. Путь указан для Debian/Ubuntu и php-fpm 8.1, на хостинге то же выставляется в панели.

   ; /etc/php/8.1/fpm/conf.d/99-bitrix.ini
   memory_limit = 512M
   upload_max_filesize = 64M
   post_max_size = 64M
   max_execution_time = 300
   date.timezone = Europe/Moscow

   sudo systemctl reload php8.1-fpm
   php -v
   php -m | grep -Ei 'mysqli|mbstring|gd|curl|zip|xml|openssl'

   Проверка: в выводе php -m есть все перечисленные модули. Консольный PHP и php-fpm могут иметь разные наборы расширений, так что при сомнениях сверьтесь с phpinfo в браузере.

2. Создайте базу и пользователя. Отдавать мастеру root не стоит: у сайта должен быть отдельный пользователь с правами только на свою базу. Кодировка utf8 с сопоставлением utf8_unicode_ci привычна для Битрикса, в MySQL 8 она работает как псевдоним utf8mb3. Если сомневаетесь, сверьтесь с требованиями вашей версии.

   -- выполните в консоли mysql под административной учётной записью
   CREATE DATABASE bitrix_shop CHARACTER SET utf8 COLLATE utf8_unicode_ci;
   CREATE USER 'bitrix_user'@'localhost' IDENTIFIED BY 'YOUR_DB_PASSWORD';
   GRANT ALL PRIVILEGES ON bitrix_shop.* TO 'bitrix_user'@'localhost';
   FLUSH PRIVILEGES;

   Проверка: команда mysql -u bitrix_user -p bitrix_shop -e 'SELECT 1;' после ввода пароля выводит единицу.

3. Загрузите установщик. Файл bitrixsetup.php должен лежать в корне сайта. Берите его только с официального сайта.

   cd /var/www/example.ru/public_html
   wget -O bitrixsetup.php https://www.1c-bitrix.ru/download/scripts/bitrixsetup.php
   # только для новой пустой папки сайта
   sudo chown -R www-data:www-data /var/www/example.ru/public_html

   Проверка: адрес https://example.ru/bitrixsetup.php открывает страницу выбора дистрибутива. Если видите заглушку хостинга, смотрите раздел об ошибках.

4. Скачайте дистрибутив и примите лицензию. Выберите «1С-Битрикс: Управление сайтом», дождитесь загрузки и распаковки, затем примите соглашение и введите ключ. Копируйте ключ без пробелов по краям. Без ключа можно взять пробный режим, срок указан на странице загрузки. Проверка: мастер переходит к проверке требований.

5. Пройдите проверку требований. Мастер сверяет версию PHP, расширения и лимиты. Критичные пункты блокируют установку, остальные только предупреждают. Проверка: блокирующих пунктов нет. Предупреждения запишите и вернитесь к ним после установки.

6. Подключите базу. Впишите данные из шага 2 по таблице ниже. Проверка: мастер доходит до создания таблиц без сообщений о доступе.

7. Создайте администратора. Укажите логин, пароль и рабочий e-mail. Не берите admin с простым паролем: страница входа по стандартному адресу /bitrix/admin/ известна всем с первого дня. Проверка: после завершения эта пара открывает админку.

8. Пройдите мастер сайта. Выберите решение, шаблон и цветовую схему. Сайт получит демо-контент выбранного решения: для знакомства удобно, для боевого проекта его придётся чистить. Затем откройте «Настройки → Инструменты → Проверка системы» (/bitrix/admin/site_checker.php). Проверка: главная открывается в браузере, а в проверке системы нет критичных ошибок.

Что куда вписать при подключении базы

Названия полей могут отличаться в зависимости от версии мастера.

Мастер ставит Битрикс за минуты. Вечер уходит на переустановку поверх полусломанной попытки, поэтому проверку после каждого шага не пропускайте.

Если не получилось

• Allowed memory size of ... bytes exhausted. Не хватает memory_limit. Поднимите значение в ini-файле из шага 1, перезагрузите php-fpm и повторите шаг.
• Maximum execution time of 30 seconds exceeded. Увеличьте max_execution_time. На хостинге лимит может быть жёстким, тогда его меняет поддержка.
• Access denied for user 'bitrix_user'@'localhost'. Неверный логин или пароль, либо пользователю не выданы права. Повторите проверку из шага 2. Если пишет Unknown database, база создана под другим именем.
• failed to open stream: Permission denied. У пользователя веб-сервера нет права записи в корень сайта. Проверьте владельца папки и выполните chown из шага 3.
• Вместо мастера заглушка хостинга или 403. Часто в корне лежит index.html или index.php хостинга. Переименуйте его, не удаляя, и откройте bitrixsetup.php напрямую. Если файл не находится, проверьте, что он лежит в корне именно этого домена.

Что делать дальше

• Удалите bitrixsetup.php из корня, если он остался.
• Сделайте первую резервную копию («Настройки → Инструменты → Резервное копирование») до наполнения сайта.
• Установите доступные обновления платформы и снова прогоните проверку системы. Предупреждения из шага 5 разберите по одному.
• По умолчанию агенты выполняются на хитах посетителей. Для боевого сайта их переносят на cron, порядок описан в документации вашей версии.
• Конфигурация Nginx под Битрикс и перенос на боевой домен: отдельные темы, здесь не разбираем.

[1] Корень сайта (document root) — папка, которую веб-сервер отдаёт по адресу домена. Именно в ней должны лежать bitrixsetup.php и позже папка bitrix. На хостингах она часто называется public_html или www.