Установка Docker Compose на VPS

Время чтения: 9 мин. Обновлено: 18 ноября 2026

Выбирайте VPS

Если вы в поиске VPS, то смотрите подборку надежных VDS.

Перейти

Docker Compose — инструмент для запуска и управления приложениями в Docker. Он позволяет описать настройки контейнеров в одном файле, а затем запускать, останавливать и обновлять их с помощью нескольких команд. Особенно удобно использовать Compose, когда приложение состоит из нескольких контейнеров, например сайта и базы данных.

В этой инструкции установим Docker Compose на VPS с Ubuntu 24.04, создадим файл настроек и запустим веб-сервер Nginx. Затем разберём основные команды управления контейнерами.

Что понадобится для установки?

Для работы Docker Compose подойдёт VPS со следующими характеристиками:

  • Ubuntu Server 24.04 LTS;
  • 1 vCPU;
  • от 1 ГБ оперативной памяти;
  • от 10 ГБ  свободного места на диске;
  • доступ по SSH с правами администратора.

Этих ресурсов достаточно для нашего примера с Nginx. Более сложным приложениям могут потребоваться дополнительные CPU, RAM и место на диске.

Docker Compose работает вместе с Docker Engine — программой, которая запускает контейнеры. Поэтому сначала проверим, установлен ли Docker.

Подключитесь к VPS:

ssh root@203.0.113.10

Замените 203.0.113.10 на публичный IP-адрес своего сервера.

Если вы подключаетесь не под root, используйте учётную запись с правами sudo.

Установка Docker на VPS

Проверьте, установлен ли Docker:

docker --version

Если команда выводит версию Docker, переходите к следующему разделу. Если Docker уже используется для других приложений, не переустанавливайте его без необходимости.

Если появляется сообщение command not found, установим Docker из официального репозитория.

Сначала обновите список пакетов:

sudo apt update

Установите необходимые программы:

sudo apt install ca-certificates curl

Создайте папку для ключей репозитория:

sudo install -m 0755 -d /etc/apt/keyrings

Загрузите официальный ключ Docker:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

Разрешите системе читать этот файл:

sudo chmod a+r /etc/apt/keyrings/docker.asc

Теперь добавьте репозиторий Docker. Скопируйте весь блок целиком:

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Обновите список пакетов:

sudo apt update

Установите Docker Engine вместе с необходимыми компонентами:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Важно: если система сообщает о конфликтующих пакетах docker.io, containerd или других версиях Docker, не удаляйте их наугад. Сначала проверьте, нет ли на сервере работающих контейнеров.

После установки проверьте службу Docker:

sudo systemctl status docker

В строке состояния должно отображаться active (running).

Для выхода из просмотра нажмите q.

Если служба не запущена, выполните:

sudo systemctl enable --now docker

Проверьте работу Docker с помощью тестового контейнера:

sudo docker run --rm hello-world

Если установка прошла успешно, появится сообщение «Hello from Docker!».

Установка и проверка Docker Compose

При установке Docker из предыдущего раздела мы уже добавили пакет docker-compose-plugin.

Проверьте его версию:

docker compose version

Если Docker Compose установлен, команда покажет номер версии. Для работы с приложениями используется Compose V2 — плагин Docker.

Если Docker уже был установлен ранее, но Compose отсутствует, при использовании официального репозитория Docker его можно установить отдельно:

sudo apt update
sudo apt install docker-compose-plugin

После этого повторите проверку.

В Docker Compose V2 используется команда:

docker compose

Между словами docker и compose ставится пробел.

Старая команда docker-compose с дефисом относится к прежнему варианту установки и в этой инструкции не используется.

Для запуска контейнеров далее будем применять sudo docker compose. Это позволяет работать без изменения прав пользователей.

Создание файла compose.yaml

Теперь создадим первое приложение. В качестве примера используем Nginx — веб-сервер, который будет показывать страницу в браузере.

Создайте отдельную папку:

mkdir -p ~/docker-nginx/html

Перейдите в неё:

cd ~/docker-nginx

Создайте простую HTML-страницу:

echo '<h1>Docker Compose работает!</h1>' > html/index.html

Теперь создайте файл настроек:

nano compose.yaml

Если редактор Nano отсутствует, установите его командой sudo apt install nano.

Добавьте следующее содержимое:

services:
  nginx:
    image: nginx:stable-alpine
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro
    restart: unless-stopped

Сохраните файл сочетанием Ctrl + O, нажмите Enter и выйдите через Ctrl + X.

Разберём основные строки:

  • services — список приложений, которыми управляет Docker Compose.
  • nginx — название нашего приложения.
  • image — готовый образ Nginx, который Docker скачает для запуска.
  • ports — порт 8080 на VPS соединяется с портом 80 внутри контейнера.
  • volumes — папка html на VPS подключается к папке сайта внутри контейнера.
  • restart: unless-stopped — Docker будет автоматически перезапускать контейнер после сбоя или перезагрузки VPS, если контейнер не был остановлен вручную.

В строке ports указан адрес 127.0.0.1. Поэтому веб-сервер будет доступен только с самого VPS. Для первого запуска это безопаснее, чем сразу открывать порт в интернет.

Параметр :ro означает, что контейнер может читать файлы сайта, но не изменять их через эту папку.

Проверьте правильность файла:

sudo docker compose config -q

Если ошибок нет, команда завершится без сообщения.

Запуск приложения через Docker Compose

Находясь в папке ~/docker-nginx, выполните:

sudo docker compose up -d

Docker Compose скачает образ Nginx и запустит контейнер.

Параметр -d означает запуск в фоновом режиме: терминал останется доступным для других команд.

Проверьте состояние:

sudo docker compose ps

В списке должен появиться контейнер Nginx со статусом Up.

Теперь проверим веб-сервер прямо на VPS:

curl http://127.0.0.1:8080

Если всё работает, команда вернёт содержимое созданной HTML-страницы.

Как открыть страницу в браузере?

Чтобы посмотреть сайт со своего компьютера, воспользуемся SSH-подключением.

Откройте новое окно PowerShell на Windows и выполните:

ssh -N -L 8080:127.0.0.1:8080 root@203.0.113.10

Замените IP-адрес и имя пользователя на свои. Оставьте окно PowerShell открытым.

Теперь откройте в браузере компьютера:

http://127.0.0.1:8080

Должна появиться страница с надписью «Docker Compose работает!».

Таким способом можно проверить приложение, не открывая его для посторонних.

Если в дальнейшем потребуется разместить полноценный публичный сайт, нужно будет отдельно настроить домен, HTTPS и доступ через веб-сервер. Для нашего учебного примера это не требуется.

Управление контейнерами

Docker Compose позволяет управлять приложением из папки, где находится файл compose.yaml.

Для просмотра работающих контейнеров выполните:

sudo docker compose ps

Чтобы посмотреть журнал Nginx:

sudo docker compose logs --tail=50

Для просмотра новых записей в реальном времени:

sudo docker compose logs -f

Для выхода нажмите Ctrl + C. Контейнер продолжит работать.

Остановить приложение можно командой:

sudo docker compose stop

Для повторного запуска:

sudo docker compose start

Чтобы перезапустить контейнер:

sudo docker compose restart

Если необходимо остановить приложение и удалить созданный Compose контейнер, выполните:

sudo docker compose down

Файлы сайта в папке html останутся на VPS. Для повторного создания и запуска контейнера используйте:

sudo docker compose up -d

Не добавляйте параметр -v к команде down, если не хотите удалять данные из именованных томов Docker. В нашем примере такой том не используется, но в приложениях с базами данных он может содержать важную информацию.

Обновление приложения

Одно из преимуществ Docker Compose — возможность обновлять приложения без повторной настройки с нуля.

Для обновления Nginx перейдите в папку проекта:

cd ~/docker-nginx

Скачайте актуальный образ, соответствующий указанному тегу:

sudo docker compose pull

Затем пересоздайте контейнер с новым образом:

sudo docker compose up -d

Docker Compose применит обновление, если образ или конфигурация изменились.

Файл compose.yaml и содержимое папки html останутся на VPS.

Проверьте состояние приложения:

sudo docker compose ps

И убедитесь, что страница открывается:

curl http://127.0.0.1:8080

Обновление может сопровождаться кратковременной недоступностью приложения. Для рабочих проектов перед обновлением нужно создавать резервные копии важных файлов и баз данных.

Если вы изменили только содержимое HTML-страницы в нашем примере, пересоздавать контейнер не нужно: Nginx читает файлы из подключённой папки.

Возможные ошибки и их решение

Команда docker compose не найдена

Если появляется сообщение о неизвестной команде compose, проверьте установку плагина:

docker compose version

При использовании официального репозитория установите недостающий пакет:

sudo apt install docker-compose-plugin

Если пакет не найден, проверьте, правильно ли добавлен репозиторий Docker.

Ошибка permission denied

Если Docker сообщает об отсутствии прав на доступ к сокету Docker, выполните команду с sudo:

sudo docker compose ps

Для работы Docker нужны административные права. Добавлять обычного пользователя в группу docker без необходимости не стоит: участники этой группы фактически получают широкие права на сервере.

Порт 8080 уже занят

Если контейнер не запускается из-за занятого порта, проверьте:

sudo ss -lntp | grep ':8080'

Если порт используется другой программой, измените в compose.yaml строку:

- "127.0.0.1:8080:80"

Например, на:

- "127.0.0.1:8081:80"

Сохраните файл и примените настройки:

sudo docker compose up -d

После этого используйте порт 8081 в командах проверки и SSH-подключения.

Контейнер постоянно перезапускается

Посмотрите его состояние:

sudo docker compose ps

Затем проверьте последние записи журнала:

sudo docker compose logs --tail=100

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

Не открывается страница в браузере

Сначала проверьте веб-сервер на самом VPS:

curl http://127.0.0.1:8080

Если ответ есть, но страница не открывается на компьютере, проверьте SSH-подключение с перенаправлением порта.

Если ответа нет, посмотрите состояние контейнера и его журнал. Также убедитесь, что выполняете команды в папке с нужным файлом compose.yaml.

Заключение

Docker Compose упрощает запуск приложений на VPS. Вместо отдельных длинных команд Docker можно хранить настройки в файле compose.yaml и управлять контейнерами из одной папки.

В нашем примере мы установили Docker Compose на Ubuntu 24.04, запустили Nginx, подключили папку с файлами сайта и проверили работу приложения через браузер.

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

Комментарии ()

    Популярные статьи