Установка Docker Engine и Docker Compose
Установите Docker Engine и Docker Compose из официального репозитория на Debian или Ubuntu: пользователи, журналы, порты, обновления, резервные копии и рекомендации.
На этой странице
Это руководство объясняет, как установить Docker Engine и плагин Docker Compose из официального репозитория Docker, а затем подготовить сервер к промышленной эксплуатации: права пользователей, ротация журналов, публикация портов, обновления и резервное копирование.
Заказать сервер
Для размещения ваших контейнеров HostMyServers предлагает несколько вариантов:
Предварительные требования
- 64-разрядный сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04
- SSH-доступ под
rootили пользователем с правамиsudo
Порты: Docker не требует входящих портов. Открывайте только порты публикуемых вами приложений и никогда не выставляйте API Docker (2375 или 2376) в Интернет: доступ к нему равносилен контролю над сервером.
Шаг 1: удалите конфликтующие пакеты
Пакеты Docker из дистрибутива могут конфликтовать с официальными пакетами:
sudo apt update
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | cut -f1)Ваши образы и тома в /var/lib/docker, если они есть, этой командой не удаляются.
Шаг 2: добавьте официальный репозиторий
Эти команды подходят и для Debian, и для Ubuntu, так как определяют систему по /etc/os-release:
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/$ID/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt updateШаг 3: установите Docker
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker containerdШаг 4: проверьте установку
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-worldСообщение Hello from Docker! подтверждает, что движок может загрузить образ и запустить контейнер.
Шаг 5: разрешите доступ пользователю
Чтобы запускать Docker без sudo, добавьте своего пользователя в группу docker, затем выйдите из системы и войдите снова:
sudo usermod -aG docker $USERЗатем проверьте:
docker run --rm hello-worldШаг 6: настройте журналы и демон
По умолчанию драйвер json-file не ограничивает размер журналов, и они могут в итоге заполнить диск. Создайте /etc/docker/daemon.json:
sudo nano /etc/docker/daemon.json{
"log-driver": "local",
"log-opts": {
"max-size": "10m",
"max-file": "3"
},
"live-restore": true
}| Параметр | Эффект |
|---|---|
log-driver: local |
Компактный формат журнала с ротацией |
max-size, max-file |
До 3 файлов по 10 МБ на контейнер |
live-restore |
Контейнеры продолжают работать, если демон останавливается |
Проверьте файл, затем перезапустите Docker. Этот перезапуск прерывает работающие контейнеры: лучше сделать его до развёртывания приложений.
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}} {{.LiveRestoreEnabled}}'Драйвер журналов применяется только к новым контейнерам. Пересоздайте существующие контейнеры, чтобы он начал действовать, например командой docker compose up -d --force-recreate.
Шаг 7: контролируйте публикуемые порты
Если на сервере работает обратный прокси, публикуйте приложения только локально:
ports:
- "127.0.0.1:8080:80"Можно также сделать локальный адрес поведением по умолчанию, добавив эти ключи в /etc/docker/daemon.json:
{
"ip": "127.0.0.1",
"default-network-opts": {
"bridge": {
"com.docker.network.bridge.host_binding_ipv4": "127.0.0.1"
}
}
}Объедините их с файлом из шага 6, проверьте его, затем перезапустите Docker. Порт, предназначенный для публичного доступа, придётся указывать явно, например "0.0.0.0:443:443".
Шаг 8: запустите первый проект Compose
Создайте каталог для проекта:
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yamlservices:
web:
image: nginx:1.30-alpine
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- web-data:/usr/share/nginx/html
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1/"]
interval: 30s
timeout: 5s
retries: 3
volumes:
web-data:Запустите и проверьте:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080Чтобы опубликовать это приложение по HTTPS, поставьте перед ним обратный прокси. Вы можете начать с руководства Установка Nginx и PHP-FPM и руководства по Let's Encrypt.
Полезные команды
| Команда | Описание |
|---|---|
docker ps -a |
Список контейнеров |
docker compose logs -f |
Следить за журналами проекта |
docker compose restart |
Перезапустить службы |
docker compose down |
Остановить и удалить контейнеры, сохранив тома |
docker system df |
Показать занятое место |
Обновления
Docker Engine
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --versionlive-restore покрывает только корректирующие обновления. При переходе на новую основную версию предусмотрите остановку контейнеров и изучите примечания к выпуску Docker.
Образы приложений
Измените тег в compose.yaml, если вы его фиксируете, затем:
cd /opt/myapp
docker compose pull
docker compose up -d
docker image pruneРезервное копирование
Сохраняйте как минимум ваши файлы Compose, файлы .env и тома. Тома находятся в /var/lib/docker/volumes, но лучше архивировать их через временный контейнер. Настоящее имя тома можно узнать командой docker volume ls:
cd /opt/myapp
mkdir -p backups
docker compose stop web
docker run --rm -v myapp_web-data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf /backup/web-data.tar.gz -C /data .
docker compose start webЧтобы восстановить архив в том:
docker compose stop web
docker run --rm -v myapp_web-data:/data -v "$PWD/backups":/backup:ro alpine:3 tar xzf /backup/web-data.tar.gz -C /data
docker compose start webДля базы данных лучше использовать экспорт средствами самой СУБД (mariadb-dump, pg_dump и т. д.). Затем копируйте резервные копии за пределы сервера.
Рекомендации для промышленной эксплуатации
- Фиксируйте точную версию образа вместо
latest - Задавайте для служб
restart: unless-stoppedиhealthcheck - Публикуйте как можно меньше портов и, когда возможно, только локально за обратным прокси
- Храните секреты в защищённом файле
.env(chmod 600 .env), вне Git - Не используйте
privileged: trueи не монтируйте/var/run/docker.sockбез необходимости - Следите за местом на диске с помощью
docker system df - Регулярно проверяйте восстановление из резервных копий
Если что-то пошло не так
permission denied на /var/run/docker.sock
Ваш пользователь ещё не учитывается в группе docker. Проверьте командой id, затем заново подключитесь по SSH.
Conflicting values set for option Signed-By
Остался старый конфигурационный файл репозитория Docker, часто это /etc/apt/sources.list.d/docker.list. Проверив его содержимое, удалите его:
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt updateCannot connect to the Docker daemon
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.jsonСинтаксическая ошибка в daemon.json не даёт службе запуститься.
port is already allocated или address already in use
Другой контейнер или служба использует этот порт. Определите её командами sudo ss -ltnp | grep ':8080 ' и docker ps, затем смените порт на стороне сервера.
no space left on device
df -h
docker system df
docker image prune
docker builder pruneИспользуйте docker volume prune только после того, как убедитесь, что в соответствующих томах не осталось нужных данных.
toomanyrequests при загрузке
Достигнут лимит загрузок Docker Hub. Подождите или войдите в свою учётную запись командой docker login.
docker-compose: command not found
Актуальный плагин вызывается с пробелом: docker compose.
Порт остаётся доступным, несмотря на UFW
Это нормальное поведение портов, опубликованных Docker. Опубликуйте порт на 127.0.0.1 или примените ограничения из руководства Настройка UFW.