Как использовать Docker Compose на VPS с Ubuntu или Debian?
Напишите файл compose.yaml, запустите WordPress и MariaDB командой docker compose up -d, затем управляйте журналами, обновлениями, резервными копиями и
Docker Compose описывает несколько контейнеров в одном файле, compose.yaml: образы, порты, тома, переменные и порядок запуска. Одна команда, docker compose up -d, создает или обновляет весь стек. Это руководство исходит из VPS, на котором Docker уже установлен, собирает конкретный пример — WordPress с MariaDB — и затем разбирает повседневные команды и частые ошибки. Оно подходит без изменений для Ubuntu 22.04 / 24.04 и Debian 12 / 13.
Пошаговая инструкция
-
Проверьте Docker и плагин Compose
Выполните docker compose version. Если ответ — docker: 'compose' is not a docker command, установите Docker из официального репозитория вместе с пакетом docker-compose-plugin, как в руководстве по установке Docker.
-
Создайте папку проекта
Создайте отдельную папку для каждого приложения, например /opt/wordpress, и перейдите в нее. Compose называет проект по имени этой папки и ищет compose.yaml в текущей папке.
-
Напишите файлы .env и compose.yaml
Сгенерируйте пароль в .env, доступный для чтения только root, затем скопируйте файл compose.yaml ниже. При запуске Compose подставляет вместо ${DB_PASSWORD} значение из .env.
-
Запустите стек
Выполните docker compose up -d. Compose скачивает образы, создает сеть и тома, ждет готовности MariaDB и затем запускает WordPress. После этого docker compose ps показывает оба сервиса в состоянии Up, с пометкой (healthy) у db.
-
Проверьте работу и прочитайте журналы
На самом VPS команда curl -I http://127.0.0.1:8080 должна вернуть перенаправление на страницу установки WordPress. Если что-то не так, docker compose logs -f --tail=100 показывает журналы всех сервисов.
-
Обновите контейнеры
Чтобы перейти на новую версию, измените тег образа в compose.yaml, затем выполните docker compose pull и docker compose up -d: пересоздаются только контейнеры, у которых изменился образ или конфигурация, а тома остаются на месте.
Создать проект и его пароль
mkdir -p /opt/wordpress
cd /opt/wordpress
echo "DB_PASSWORD=$(openssl rand -hex 24)" > .env
chmod 600 .env
Файл compose.yaml: WordPress и MariaDB
services:
db:
image: mariadb:11.4
restart: unless-stopped
environment:
MARIADB_DATABASE: wordpress
MARIADB_USER: wordpress
MARIADB_PASSWORD: ${DB_PASSWORD}
MARIADB_RANDOM_ROOT_PASSWORD: "1"
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
wordpress:
image: wordpress:6.8-apache
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
WORDPRESS_DB_HOST: db
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: ${DB_PASSWORD}
WORDPRESS_DB_NAME: wordpress
ports:
- "127.0.0.1:8080:80"
volumes:
- wp_data:/var/www/html
volumes:
db_data:
wp_data:
Запуск и проверка
docker compose up -d
docker compose ps
curl -I http://127.0.0.1:8080
docker compose logs -f --tail=100
Повседневные команды Docker Compose
docker compose ps
docker compose logs --tail=50 wordpress
docker compose restart wordpress
docker compose exec db sh
docker compose stop
docker compose start
docker compose down
docker compose config --quiet
docker compose ls
Обновить образы
cd /opt/wordpress
docker compose pull
docker compose up -d
docker image prune -f
Резервная копия базы MariaDB
cd /opt/wordpress
docker compose exec -T db sh -c 'mariadb-dump -u"$MARIADB_USER" -p"$MARIADB_PASSWORD" "$MARIADB_DATABASE"' > wordpress-$(date +%F).sql
HTTPS с Caddy: compose.override.yaml
services:
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
volumes:
caddy_data:
caddy_config:
Caddyfile
example.com {
reverse_proxy wordpress:80
}
Перед началом
Вам нужен Linux VPS с Docker Engine и плагином Compose, установленными из официального репозитория Docker: если это еще не сделано, следуйте руководству «Как установить Docker на Debian 12 или Ubuntu 24.04?». Команды выполняются от root; учетная запись из группы docker тоже может выполнять их без sudo.
- Compose v2 пишется docker compose, через пробел. Старая программа docker-compose (v1) не поддерживается с 2023 года: не устанавливайте ее ни через pip, ни через apt.
- Файл называется compose.yaml; docker-compose.yml по-прежнему читается для старых проектов. Строка version: в начале файла устарела и больше ни на что не влияет.
- WordPress и MariaDB умещаются в 1–2 ГБ RAM; закладывайте больше, как только на одном VPS работает несколько стеков.
Как устроен файл compose.yaml
Каждая запись в services становится контейнером. Compose также создает для проекта частную сеть: сервисы обращаются в ней друг к другу по имени, отсюда WORDPRESS_DB_HOST: db. Ни один порт MariaDB не публикуется, поэтому база данных не видна из интернета.
- image: образ и его тег. Фиксируйте версию (mariadb:11.4), а не latest, чтобы знать, что именно вы обновляете.
- ports: "127.0.0.1:8080:80" публикует порт 80 контейнера на порту 8080 VPS, только локально. Без 127.0.0.1 порт открыт в интернет, даже если UFW его блокирует.
- volumes: именованный том (db_data) сохраняет данные при пересоздании контейнера. Он удаляется только командой docker compose down -v или docker volume rm.
- environment и .env: секреты остаются в .env, вне файла, которым вы делитесь или который храните в системе контроля версий.
- restart: unless-stopped перезапускает контейнеры после сбоя или перезагрузки VPS, кроме тех, что вы остановили вручную.
- depends_on с condition: service_healthy ждет успешного healthcheck MariaDB, прежде чем запустить WordPress.
Публикация сайта по HTTPS
Чтобы открыть сайт по доменному имени, направьте A-запись на IPv4-адрес VPS, откройте порты 80 и 443 и добавьте Caddy в файл compose.override.yaml, который Compose автоматически читает вместе с compose.yaml. Замените example.com на свой домен в Caddyfile: Caddy сам получает и продлевает сертификат Let’s Encrypt.
Затем завершите установку WordPress по https-адресу своего домена, а не через 127.0.0.1: WordPress запоминает адрес, использованный при установке.
Резервные копии и обновления стека
Том — это не резервная копия: он исчезнет вместе с VPS или после случайно выполненного down -v. Экспортируйте базу данных через mariadb-dump (блок выше), скопируйте папку проекта и содержимое томов, затем отправьте все это за пределы VPS.
- docker compose pull скачивает новые образы для указанных тегов, docker compose up -d пересоздает затронутые контейнеры, а docker image prune -f освобождает место от старых образов.
- Перед переходом на новую основную версию MariaDB или PostgreSQL сделайте SQL-экспорт: новая версия может потребовать миграции данных.
- docker system df показывает, сколько места занимают образы, контейнеры и тома.
Какой VPS выбрать для Docker Compose?
Docker нужно настоящее ядро Linux: VPS на KVM подходит, виртуальный хостинг — нет. В ACLClouds на 16 ноября 2026 года VPS Mini (2 vCPU, 8 ГБ RAM, 40 ГБ диска) стоит 4,99 € в месяц без обязательств или 3,99 € в месяц при оплате на год: на нем работают несколько небольших стеков Compose. VPS Essentiel (4 vCPU, 16 ГБ RAM, 80 ГБ) за 9,99 € в месяц подойдет для нагруженной базы данных или для n8n рядом с сайтом.
Опция -v команды docker compose down стирает данные
docker compose down -v удаляет также именованные тома проекта, то есть базу MariaDB и файлы WordPress. Сделайте экспорт перед любой командой с -v.
Быстрая проверка
- docker compose version отвечает без ошибок.
- docker compose ps показывает db в состоянии (healthy) и wordpress в состоянии Up.
- Порт 8080 опубликован только на 127.0.0.1.
- .env имеет права 600 и не лежит ни в одном Git-репозитории.
- Свежий SQL-экспорт хранится за пределами VPS.
Часто задаваемые вопросы
Почему появляется no configuration file provided: not found?
Compose не находит в текущей папке ни compose.yaml, ни docker-compose.yml. Перейдите в папку проекта командой cd /opt/wordpress или укажите файл: docker compose -f /opt/wordpress/compose.yaml up -d.
Compose выводит «the attribute version is obsolete» — это опасно?
Нет, это просто предупреждение. Compose v2 игнорирует строку version: "3.8" в начале файла: удалите ее, чтобы предупреждение исчезло, остальная часть файла не меняется.
Почему при запуске появляется port is already allocated или address already in use?
Другой контейнер уже публикует этот порт, или его слушает сервис на VPS (nginx, Apache). Найдите его командами docker ps --filter publish=80 и ss -tlnp | grep :80, затем остановите его или измените левый порт в ports, например "8081:80".
Почему появляется docker: 'compose' is not a docker command?
Плагин Compose v2 не установлен. С официальным репозиторием Docker выполните apt install docker-compose-plugin. Пакеты docker.io и docker-compose из дистрибутивов отстают или дают только старую команду через дефис.
Почему мои изменения в compose.yaml не применяются?
docker compose restart перезапускает контейнеры, не перечитывая файл. Выполните docker compose up -d: Compose сравнит конфигурацию и пересоздаст измененные сервисы. Сначала проверьте файл командой docker compose config.
Пропали ли мои данные после docker compose down?
Нет: docker compose down удаляет контейнеры и сеть, но не именованные тома. Данные пропадают только при down -v или если они записывались внутрь контейнера без тома. docker volume ls выводит список томов с именем проекта в качестве префикса, например wordpress_db_data.
Что исправить после ошибки yaml: line 8: mapping values are not allowed in this context?
В файле YAML неверные отступы: табуляция вместо пробелов или смещенный уровень. Используйте только пробелы (по два на уровень), берите в кавычки значения с :, например порты, затем проверьте командой docker compose config.