Содержание:
Выбирайте 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 <<EOFTypes: 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 updatesudo 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 -dDocker 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 -dDocker 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, подключили папку с файлами сайта и проверили работу приложения через браузер.
По такому же принципу можно запускать другие сервисы. Для каждого приложения потребуется собственный файл настроек с подходящими портами, папками и дополнительными параметрами.
Предыдущая статья:
Установка n8n через DockerСледующая статья:
Установка Django на VPS с Ubuntu
Комментарии ()