К статье
Практический материал

Администрирование · 11 мин

Как установить 1С-Битрикс: пошаговое руководство

Подробная инструкция по установке 1С-Битрикс: требования к серверу, настройка PHP и MySQL, установка через скрипт bitrixsetup.php, проверка и типичные ошибки.

1С-Битрикс — коммерческая CMS, которая устанавливается на веб-сервер и требует связки PHP, веб-сервера (Apache или Nginx) и базы данных MySQL/MariaDB. Процесс установки несложен, если заранее подготовить окружение: большинство ошибок возникает не на этапе мастера установки, а из-за несоответствия сервера системным требованиям.

Установить продукт можно двумя способами: автоматически через скрипт bitrixsetup.php, который сам скачает и распакует дистрибутив, или вручную — загрузив архив с дистрибутивом на сервер. Первый способ удобнее и быстрее, второй выручает, когда на сервере ограничен исходящий трафик или низкий лимит времени выполнения скриптов.

Ниже разобран полный цикл: от проверки хостинга до первого входа в административный раздел, с типичными ошибками и способами их диагностики.

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

Битрикс требователен к окружению, и несоответствие хотя бы одному параметру приведёт к ошибкам на этапе установки или к проблемам в работе сайта. Проверьте версию PHP, наличие необходимых расширений, версию MySQL/MariaDB и настройки веб-сервера. Актуальные требования зависят от версии продукта, поэтому сверяйтесь с разделом «Технические требования» в документации к вашей редакции.

Как правило, требуются: актуальная поддерживаемая версия PHP с расширениями mysqli, gd, mbstring, openssl, zlib и другими; MySQL или MariaDB поддерживаемой версии; Apache с mod_rewrite или корректно настроенный Nginx. На бесплатных и дешёвых shared-хостингах часто не хватает лимитов памяти и времени выполнения скриптов — это самая частая причина обрыва установки.

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

bash
php -v && mysql --version && php -m | grep -E 'mysqli|gd|mbstring|openssl'
Версия PHPДолжна входить в список поддерживаемых вашей редакцией Битрикса

Команда php -v или phpinfo()

Лимит памяти PHPСлишком низкий memory_limit обрывает распаковку дистрибутива

Параметр memory_limit в php.ini или phpinfo()

Права на файлыУ веб-сервера должны быть права записи в корень сайта

Проверка прав через ls -la или панель хостинга

База данныхНужна пустая БД в кодировке UTF-8 и пользователь с полными правами на неё

Создаётся в панели хостинга или через mysql

Выбор редакции и получение дистрибутива

Продукт поставляется в нескольких редакциях — от «Старта» до «Энтерпрайза», а также в виде «Управление сайтом» и «Корпоративный портал». Редакция определяет набор модулей и ограничения, но процедура установки у всех одинаковая. Для знакомства доступна пробная версия с ограниченным сроком работы, которую позже можно активировать коммерческим ключом без переустановки.

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

Подготовка базы данных

До запуска мастера установки создайте пустую базу данных и пользователя с полными правами на неё. На shared-хостинге это делается через панель управления (cPanel, ISPmanager и аналоги), на VPS — через консоль MySQL или phpMyAdmin. Кодировка базы должна быть UTF-8 (utf8mb4), иначе возможны проблемы с хранением кириллицы и спецсимволов.

Создание базы через консоль выглядит так:

sql
CREATE DATABASE bitrix_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'bitrix_user'@'localhost' IDENTIFIED BY 'СложныйПароль'; GRANT ALL PRIVILEGES ON bitrix_db.* TO 'bitrix_user'@'localhost'; FLUSH PRIVILEGES;

Сохраните имя базы, имя пользователя, пароль и адрес сервера БД (обычно localhost) — эти данные мастер запросит на одном из шагов. Не используйте для сайта root-пользователя MySQL: при компрометации сайта злоумышленник получит доступ ко всем базам сервера.

Установка через скрипт bitrixsetup.php

Это рекомендуемый способ. Загрузите файл bitrixsetup.php в корневую директорию сайта (обычно public_html или www/имя-домена) по FTP/SFTP или через файловый менеджер панели хостинга. Затем откройте в браузере адрес http://ваш-домен/bitrixsetup.php.

Порядок действий
  1. 1
    Загрузите bitrixsetup.php в корень сайта и откройте его в браузере
  2. 2
    Выберите дистрибутив (пробная версия или установка по лицензионному ключу) и дождитесь скачивания и распаковки архива
  3. 3
    Примите лицензионное соглашение и введите лицензионный ключ либо выберите демо-режим
  4. 4
    Дождитесь проверки системы: мастер покажет несоответствия требованиям, если они есть
  5. 5
    Укажите параметры подключения к базе данных: сервер, имя БД, логин и пароль
  6. 6
    Задайте логин, пароль и email администратора сайта
  7. 7
    Выберите готовое решение (шаблон сайта) и завершите установку
  8. 8
    Удалите файл bitrixsetup.php из корня сайта

На шаге проверки системы мастер может выдать предупреждения по настройкам PHP. Критические ошибки нужно исправить до продолжения — например, попросить хостера включить недостающее расширение или изменить параметр в php.ini. Некоторые рекомендации неблокирующие, но их лучше выполнить для стабильной работы.

После завершения установки обязательно удалите bitrixsetup.php и файлы установщика: оставленный скрипт — известный вектор взлома, через него можно повторно развернуть дистрибутив поверх рабочего сайта.

Ручная установка из архива

Если скрипт не может скачать дистрибутив (нет исходящего доступа, обрывы соединения, жёсткий лимит времени выполнения), скачайте архив дистрибутива на компьютер и загрузите его на сервер. Распаковывать архив лучше на самом сервере — через SSH или файловый менеджер хостинга: загрузка тысяч мелких файлов по FTP занимает очень много времени и часто обрывается.

bash
cd /var/www/site.ru && unzip bitrix_distibution.zip && rm bitrix_distibution.zip

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

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

Сразу после установки войдите в административный раздел по адресу /bitrix/admin/ с логином и паролем, созданными в мастере. Первым делом проверьте «Проверку системы» в разделе «Настройки → Инструменты»: она покажет оставшиеся проблемы конфигурации, которые не мешали установке, но влияют на работу.

Затем выполните базовые действия: активируйте лицензионный ключ, чтобы получать обновления; настройте отправку почты (без неё не будут работать уведомления и восстановление пароля); включите резервное копирование по расписанию; смените пароль администратора, если задавали простой. Для боевого сайта также рекомендуется настроить HTTPS — современные браузеры помечают сайты без сертификата как небезопасные.

Контрольные точки

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

Вход в админку
Норма

Страница /bitrix/admin/ открывается, вход по логину и паролю проходит

Тревожный признак

Ошибка 500, белый экран или циклический редирект

Проверка системы
Норма

Все обязательные проверки в статусе «успешно»

Тревожный признак

Красные ошибки по PHP, БД или правам доступа

Публичная часть
Норма

Главная страница открывается, шаблон отображается корректно

Тревожный признак

Пустая страница, битая вёрстка, ошибки подключения к БД

Обновления
Норма

Система обновлений видит сервер и лицензию

Тревожный признак

Ошибка соединения с сервером обновлений

Типичные ошибки и их устранение

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

Типичные ошибки
01
Обрыв распаковки дистрибутива из-за низкого max_execution_time — увеличьте лимит или используйте ручную распаковку архива на сервере
02
Ошибка подключения к базе из-за неверного хоста: на части хостингов MySQL работает не на localhost, а на отдельном сервере — адрес указан в панели хостинга
03
Белый экран после установки — чаще всего нехватка памяти PHP или фатальная ошибка, смотрите лог ошибок веб-сервера
04
Оставленный bitrixsetup.php в корне — риск взлома и повторной установки поверх сайта
05
Установка в подпапку с последующим переносом в корень без правки настроек — битые ссылки и пути
06
Использование root-пользователя MySQL для сайта — при взломе под угрозой все базы сервера

Если ошибка неочевидна, первым делом смотрите логи: error_log веб-сервера, лог PHP и лог MySQL. Сообщение об ошибке в логе почти всегда точно указывает причину — отсутствующее расширение, превышение лимита, отказ в доступе к таблице.

Маршрут решения

Как выбрать действие

Скрипт bitrixsetup.php не может скачать дистрибутивСкачайте архив вручную и распакуйте его на сервере, затем откройте сайт в браузере
Мастер сообщает о нехватке памяти или времени выполненияУвеличьте memory_limit и max_execution_time в настройках PHP или обратитесь к хостеру
Ошибка доступа к базе данных на шаге подключенияПроверьте хост, имя базы, логин и пароль; убедитесь, что пользователю выданы права именно на эту БД
После установки белый экран вместо сайтаОткройте лог ошибок PHP и устраните указанную причину, обычно это память или отсутствующее расширение

Частые вопросы

Можно ли установить Битрикс на обычный shared-хостинг?

Да, если хостинг соответствует системным требованиям: нужные версии PHP и MySQL, достаточные лимиты памяти и времени выполнения. Многие хостинг-провайдеры предлагают тарифы, специально подготовленные под Битрикс, — это снижает риск проблем. На минимальных тарифах с жёсткими лимитами установка может обрываться.

Что делать, если нет лицензионного ключа?

Установите пробную версию — мастер предлагает такой вариант на шаге ввода ключа. Пробный период ограничен по времени, но все функции доступны. После покупки лицензии ключ вводится в административном разделе, переустановка сайта не требуется.

Можно ли установить Битрикс на локальный компьютер для разработки?

Да. Поднимите локальное окружение с Apache/Nginx, PHP и MySQL — вручную или через готовые сборки и Docker. Процедура установки полностью совпадает с серверной. Учитывайте, что лицензия привязывается к домену, для разработки обычно используют пробный режим или тестовый ключ.

Обязательно ли удалять bitrixsetup.php после установки?

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

Сколько времени занимает установка?

На нормально настроенном сервере весь процесс — от загрузки скрипта до первого входа в админку — занимает от 10 до 30 минут. Основное время уходит на скачивание и распаковку дистрибутива. Если процесс затянулся на часы, почти наверняка есть проблема с лимитами сервера или каналом связи.

Как перенести установленный Битрикс на другой сервер?

Используйте встроенный механизм резервного копирования: создайте полную копию в административном разделе, разверните её на новом сервере через скрипт restore.php и обновите параметры подключения к базе данных. После переноса проверьте пути, права на файлы и работу системы обновлений.

Итог

Что важно запомнить

Успешная установка Битрикса — это прежде всего подготовленный сервер: подходящие версии PHP и MySQL, достаточные лимиты, пустая база в UTF-8 и отдельный пользователь БД. Ставьте через bitrixsetup.php, исправляйте все критические замечания мастера до продолжения и сразу после установки удаляйте установочные скрипты и запускайте проверку системы.