1. Главная
  2. Блог
  3. Полезные статьи
  4. Как развернуть сайт на 1С-Битрикс в Docker на Windows

Как развернуть сайт на 1С-Битрикс в Docker на Windows

31 октября 2026
78

Потребовалось развернуть сайт на 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
EOF

Docker 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/.

Как запустить и полностью остановить окружение

Начало работы

  1. Запустите Docker Desktop и дождитесь его готовности.
  2. Откройте Ubuntu.
  3. Перейдите в каталог нужного проекта и запустите сервисы.
  4. Откройте сайт в браузере.
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.

Docker и 1С-Битрикс интеграция контейнеров

Один сайт — один каталог проекта и собственная Compose-конфигурация. Файлы сайта находятся в Ubuntu, PHP и веб-сервер работают в контейнерах, а база сохраняется в отдельном Docker-томе. Такой подход позволяет одновременно держать несколько локальных копий 1С-Битрикс с разными версиями PHP и MySQL, не смешивая их настройки.

Понравилась статья?

Поддержать нас рублями:
​

Нужна помощь? Обращайтесь!

Комментарии
Name
Email
Phone
Ваше имя
Ваш email
Оставить комментарий
+7 (499) 341-00-19
Есть вопросы?
Обращайтесь любым удобным способом и мы ответим в ближайшее время!
Max
Телефон
Email
Telegram