Потребовалось развернуть сайт на 1С-Битрикс на компьютере или ноутбуке локально? Использование Wampserver и аналогов ни к чему хорошему не приведёт - сайт будет медленно загружаться, и подвисать. Правильное решение - Docker!
Docker позволяет запускать локальную копию сайта на компьютере без установки PHP, MySQL и веб-сервера непосредственно в Windows. Для каждого проекта можно создать отдельное окружение, выбрать нужные версии программ и не затронуть рабочий сайт. Ниже два сценария: новая установка с официальным Docker-окружением Bitrix и восстановление старого сайта на PHP 7.4.
Важно: локальные примеры предназначены для разработки и тестирования. Старые PHP и MySQL не следует публиковать в интернете. Перед любыми операциями с резервными копиями храните исходный архив и SQL-дамп отдельно.
Установка Docker Desktop и Ubuntu на Windows
Что понадобится
- Windows 10/11 с поддержкой WSL2 и аппаратной виртуализации.
- Docker Desktop с включённой интеграцией WSL.
- Ubuntu в WSL2 и достаточно свободного места для файлов сайта, образов и базы данных.
Откройте PowerShell от имени администратора и установите WSL:
wsl --install -d Ubuntu-24.04Если Windows попросит перезагрузку, выполните её. При первом запуске Ubuntu задайте имя пользователя и пароль Linux. Проверить дистрибутивы можно из PowerShell:
wsl -l -vУстановите Docker Desktop с официального сайта docker.com. В настройках Docker Desktop выберите WSL 2 based engine и включите интеграцию с Ubuntu: Settings → Resources → WSL Integration. Дождитесь запуска Docker Desktop.
Откройте Ubuntu и проверьте доступность Docker:
docker --version
docker compose version
docker info
Файлы проектов удобно хранить в файловой системе Ubuntu, например ~/projects, а не на диске C: — так операции с большим количеством PHP-файлов обычно быстрее. Открыть текущую папку в Проводнике Windows можно командой:
explorer.exe .
Также папки доступны через адрес вида \\wsl.localhost\Ubuntu-24.04\home\имя_пользователя\projects.
Новая установка 1С-Битрикс в официальном Docker-окружении
Здесь важно различать продукты: BitrixVM 9.x — готовая виртуальная машина, а env-docker — отдельный официальный проект контейнерного окружения. Docker не устанавливает BitrixVM внутрь контейнера. Для новой установки используем bitrix-tools/env-docker, сверяясь с актуальным README репозитория.
Подготовка проекта
mkdir -p ~/projects/bitrix-new
cd ~/projects/bitrix-new
git clone https://github.com/bitrix-tools/env-docker.git
cd env-dockerПрочитайте README проекта: имена конфигурационных файлов, переменные окружения, версия PHP и способ монтирования каталога сайта зависят от конкретного релиза. При необходимости скопируйте примеры файлов окружения и задайте уникальные пароли MySQL, а также свободные порты. Не копируйте конфигурацию другого проекта без проверки портов, имён контейнеров и томов.
Проверьте конфигурацию и запустите сервисы согласно инструкции репозитория:
docker compose config
docker compose up -d
docker compose ps
После запуска поместите файлы установщика 1С-Битрикс в каталог сайта, который указан в конфигурации как bind mount. В зависимости от способа установки это может быть официальный установочный скрипт bitrixsetup.php или дистрибутив, полученный через личный кабинет Bitrix. Откройте в браузере адрес и порт, указанные в Compose, и пройдите мастер установки: выбор редакции, лицензионные данные, подключение к MySQL, создание администратора.
Внутри Docker имя сервера базы данных — обычно mysql (имя сервиса Compose), а не localhost. Имя БД, пользователь и пароль должны соответствовать настройкам конкретного окружения.
Если в официальном Compose-проекте используются явные container_name, при запуске второго экземпляра на том же компьютере потребуется устранить конфликты имён. Не достаточно поменять только порт сайта.
Восстановление старого 1С-Битрикс с PHP 7.4
Предположим, что есть архив файлов сайта и SQL-дамп. Сначала проверьте, какую версию PHP использовал исходный сервер, какие расширения нужны сайту и какая версия MySQL была установлена. PHP 7.4 — пример, а не универсальная версия для всех старых сайтов. Если код использует mysql_connect(), PHP 7.4 его не запустит: эта функция удалена начиная с PHP 7.
Структура проекта
mkdir -p ~/projects/bitrix-old/site ~/projects/bitrix-old/docker
cd ~/projects/bitrix-old
Распакуйте файлы в site, чтобы непосредственно в этой папке находились bitrix/, upload/ и index.php. SQL-дамп положите рядом, под именем backup.sql. Оригинальные архивы сохраните отдельно.
Dockerfile: Apache и PHP 7.4
Пример ниже использует старый официальный образ PHP 7.4. Из-за завершения поддержки Debian-репозитории этого образа могут потребовать дополнительной настройки архивных источников. Это не производственная конфигурация; если сборка не проходит, изучите точный вывод docker compose build --progress=plain, а не отключайте проверку подписей без необходимости.
cat > docker/Dockerfile <<'EOF'
FROM php:7.4-apache
RUN apt-get update && apt-get install -y --no-install-recommends \
libfreetype6-dev libjpeg62-turbo-dev libpng-dev libzip-dev libicu-dev libonig-dev libxml2-dev \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install -j2 mysqli pdo_mysql mbstring gd zip intl soap opcache \
&& a2enmod rewrite \
&& rm -rf /var/lib/apt/lists/*
EOF
Если официальный образ больше не собирается из-за архивных репозиториев, используйте поддерживаемый для локальной разработки проверенный образ с PHP 7.4 либо отдельно адаптируйте Dockerfile. Для сайта с PHP 5.6 потребуется другой Dockerfile и, возможно, старое расширение mysql.
Настройки PHP
cat > docker/php.ini <<'EOF'
short_open_tag=On
memory_limit=512M
max_execution_time=300
max_input_vars=10000
upload_max_filesize=128M
post_max_size=128M
date.timezone=Europe/Moscow
EOFDocker Compose
В примере используются свободные локальные порты 8788 и 8092. Если они заняты, замените их. Пароли здесь демонстрационные: задайте собственные, особенно если компьютер доступен другим пользователям.
cat > docker-compose.yml <<'EOF'
name: bitrix-old
services:
web:
build: ./docker
ports:
- "127.0.0.1:8788:80"
volumes:
- ./site:/var/www/html
- ./docker/php.ini:/usr/local/etc/php/conf.d/local.ini:ro
depends_on:
- mysql
mysql:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: change_this_local_password
MYSQL_DATABASE: bitrix
command:
- --character-set-server=utf8
- --collation-server=utf8_unicode_ci
- --sql-mode=
volumes:
- mysql_data:/var/lib/mysql
phpmyadmin:
image: phpmyadmin:5.2
ports:
- "127.0.0.1:8092:80"
environment:
PMA_HOST: mysql
depends_on:
- mysql
volumes:
mysql_data:
EOF
MySQL 5.7 выбран как пример совместимости со старой базой, а не как обязательная версия для PHP 7.4. Пустой sql_mode иногда требуется старым версиям Bitrix, например при ошибках ONLY_FULL_GROUP_BY. В новом проекте так делать без причины не следует. Если дамп получен из MySQL 8, сначала проверьте совместимость с выбранной СУБД.
Запуск и восстановление базы
docker compose config
docker compose build --progress=plain web
docker compose up -d
docker compose psДождитесь готовности MySQL. Импорт большого дампа лучше выполнять через терминал, а не через браузер. Поскольку стандартный ввод занят SQL-файлом, обычный интерактивный запрос пароля здесь неудобен.
Практичный вариант для локального окружения: команда ниже берёт пароль из переменной окружения контейнера, поэтому вводить его повторно не нужно:
docker compose exec -T mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" bitrix' < backup.sqlПосле импорта проверьте количество таблиц:
docker compose exec mysql sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" bitrix -e "SHOW TABLES" | wc -l'
В файле site/bitrix/.settings.php укажите хост mysql, имя БД bitrix, пользователя root и выбранный пароль. В старых версиях Bitrix также проверьте site/bitrix/php_interface/dbconn.php. Меняйте значения только в локальной копии.
Если сайт перенаправляет на боевой домен или HTTPS, проверьте .htaccess, настройки Bitrix и браузера. В частности, Apache на порту 8788 в нашем примере обслуживает HTTP, а не HTTPS. Для диагностики:
curl -I http://localhost:8788/
Сайт откроется по адресу http://localhost:8788/, phpMyAdmin — http://localhost:8092/. Вход в админку: http://localhost:8788/bitrix/admin/.
Как запустить и полностью остановить окружение
Начало работы
- Запустите Docker Desktop и дождитесь его готовности.
- Откройте Ubuntu.
- Перейдите в каталог нужного проекта и запустите сервисы.
- Откройте сайт в браузере.
cd ~/projects/bitrix-old
docker compose up -d
docker compose ps
Для примера выше: http://localhost:8788/ — сайт, http://localhost:8092/ — phpMyAdmin. Для другого проекта используйте его каталог и порты.
Завершение работы
Если хотите сохранить контейнеры для запуска кнопкой Start в Docker Desktop, выполните:
docker compose stopЕсли хотите убрать контейнеры из списка, но сохранить базу и файлы сайта:
docker compose downНе используйте docker compose down -v, если хотите сохранить базу: флаг -v удаляет тома проекта. После остановки всех нужных проектов закройте Docker Desktop через значок в трее Windows → Quit Docker Desktop. Затем в PowerShell Windows выполните:
wsl --shutdown
wsl -l -v
Команда wsl --shutdown завершает WSL-дистрибутивы; если Docker Desktop остаётся открытым, он может запустить свою WSL-среду снова. На следующий день достаточно открыть Docker Desktop, Ubuntu и выполнить docker compose up -d в каталоге проекта. Повторно импортировать базу или собирать образ обычно не требуется.
Краткий справочник команд Docker
docker compose ls— список существующих Compose-проектов.docker ps -a— все контейнеры, включая остановленные.docker compose ps— состояние сервисов текущего проекта.docker compose logs -f web— журнал веб-сервиса.docker compose up -d— создать и запустить сервисы.docker compose stop— остановить без удаления контейнеров.docker compose down— удалить контейнеры и сеть, сохранив именованные тома.docker compose build web— пересобрать образ веб-сервиса после изменения Dockerfile.
Официальная справка: Docker Compose CLI reference, Docker Desktop для Windows, установка WSL.
Один сайт — один каталог проекта и собственная Compose-конфигурация. Файлы сайта находятся в Ubuntu, PHP и веб-сервер работают в контейнерах, а база сохраняется в отдельном Docker-томе. Такой подход позволяет одновременно держать несколько локальных копий 1С-Битрикс с разными версиями PHP и MySQL, не смешивая их настройки.



