# Установка Docker и Docker Compose на Ubuntu 26.04, 24.04 и Debian 13

> Как установить Docker Engine 29 и Docker Compose 5 на Ubuntu 26.04, 24.04 и Debian 13 из официального репозитория: команды, запуск без sudo, ограничение логов и первый compose.yaml.

Docker нужен почти для любого self-hosted сервиса: n8n, Nextcloud, Vaultwarden, ботов, мониторинга. Ниже установка из официального репозитория Docker. Она одинаково работает на Ubuntu 26.04 LTS, Ubuntu 24.04 LTS и Debian 13, все команды мы проверили на чистых системах в ноябре 2026 года.

На момент проверки репозиторий отдаёт **Docker Engine 29.9.3** и **Docker Compose 5.7.1**.

## Почему не из репозитория системы {#pochemu-ne-iz-repozitoriya}

В Ubuntu и Debian есть свой пакет `docker.io`, но он заметно отстаёт:

| Источник | Docker Engine | Docker Compose |
|---|---|---|
| Официальный репозиторий Docker | 29.9.3 | 5.7.1 |
| Ubuntu 26.04, пакет `docker.io` | 29.1.3 | 2.40 |
| Debian 13, пакет `docker.io` | 26.1.5 | 2.26 |

Многие актуальные `compose.yaml` рассчитаны на свежий Compose, а инструкции к проектам пишут под пакеты Docker. Поэтому ставьте из официального репозитория. Snap-версию Docker на сервере тоже лучше не использовать: у неё свои пути к данным и ограничения доступа к файлам.

## Что понадобится {#chto-ponadobitsya}

- VPS с Ubuntu 26.04, 24.04 или Debian 13 и доступ по SSH под root. Как подключиться, описано в статье [Подключение по SSH](https://oblako.sh/wiki/ru/upravlenie/podklyuchenie-po-ssh).
- Хотя бы 1 ГБ памяти для пары лёгких контейнеров. Для нескольких сервисов с базой данных берите от 2 ГБ.

> **Сервер под Docker.** На OBLAKO Ubuntu 26.04, 24.04 и Debian 13 выбираются прямо при [заказе VPS](https://oblako.sh/wiki/ru/nachalo-raboty/kak-zakazat-vps), сервер готов через пару минут. Серверы стоят в Германии, поэтому Docker Hub, GitHub и реестры образов открываются напрямую, без зеркал и прокси. Тарифы от $2.99 в месяц, оплата через СБП или криптовалютой: [VPS в Германии](https://oblako.sh/ru/vps).

Если вы работаете не под root, добавляйте `sudo` перед командами.

## Шаг 1. Удалите конфликтующие пакеты {#shag-1}

На чистом сервере этот шаг ничего не найдёт. Но если раньше ставили `docker.io` или Podman, их нужно убрать:

```bash
apt remove -y $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc 2>/dev/null | cut -f1)
```

Образы и тома в `/var/lib/docker` при этом не удаляются.

## Шаг 2. Подключите репозиторий Docker {#shag-2}

Этот блок сам определит, Ubuntu у вас или Debian, и подставит нужную версию системы:

```bash
apt update
apt install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
curl -fsSL https://download.docker.com/linux/$ID/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
```

Для Ubuntu 26.04 в файле окажется `resolute`, для 24.04 `noble`, для Debian 13 `trixie`. Проверить можно командой `cat /etc/apt/sources.list.d/docker.sources`.

## Шаг 3. Установите Docker и Compose {#shag-3}

```bash
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

Служба Docker запускается сама и включается в автозагрузку. Проверьте версии:

```bash
docker --version
docker compose version
```

И запустите тестовый контейнер:

```bash
docker run --rm hello-world
```

Если в выводе есть строка `Hello from Docker!`, всё работает.

> **docker compose, а не docker-compose.** Compose давно встроен в Docker как плагин и вызывается через пробел: `docker compose up -d`. Старая отдельная утилита `docker-compose` с дефисом больше не развивается. Если инструкция к проекту использует дефис, просто замените его на пробел.

## Шаг 4. Ограничьте размер логов {#shag-4}

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

```bash
tee /etc/docker/daemon.json <<EOF
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}
EOF

systemctl restart docker
```

Теперь на каждый контейнер приходится не больше 30 МБ логов. Настройка действует для новых контейнеров. Уже запущенные пересоздайте командой `docker compose up -d --force-recreate` в папке проекта.

## Шаг 5. Docker без sudo {#shag-5}

Если работаете не под root, добавьте своего пользователя в группу `docker`:

```bash
usermod -aG docker $USER
```

Выйдите из SSH и зайдите снова, чтобы группа применилась. После этого `docker ps` работает без `sudo`.

Учтите: участник группы `docker` фактически получает права root на сервере. Добавляйте в неё только тех, кому доверяете сервер целиком.

## Шаг 6. Первый compose.yaml {#shag-6}

Проверим Compose на простом веб-сервере. Создайте папку проекта и файл:

```bash
mkdir -p /opt/hello && cd /opt/hello

tee compose.yaml <<EOF
services:
  web:
    image: nginx:alpine
    ports:
      - "127.0.0.1:8080:80"
    restart: unless-stopped
EOF

docker compose up -d
curl -s localhost:8080 | head -n 4
```

`restart: unless-stopped` поднимет контейнер после перезагрузки сервера. Остановить и удалить проект можно командой `docker compose down` в той же папке.

## Docker и файрвол {#docker-i-fajrvol}

Обратите внимание на `127.0.0.1:` в примере выше. Порт, опубликованный в Docker без адреса, например `"8080:80"`, открыт для всего интернета, **даже если UFW его запрещает**. Docker прописывает свои правила iptables раньше правил UFW, поэтому UFW такой трафик просто не видит.

Отсюда простое правило:

- сервисы, которые нужны только на самом сервере или за обратным прокси (базы данных, админки, Redis), публикуйте как `127.0.0.1:ПОРТ:ПОРТ`;
- наружу открывайте только то, что действительно должно быть доступно из интернета, обычно это 80 и 443 у обратного прокси.

Остальная базовая защита сервера описана в статье [Как защитить свой VPS](https://oblako.sh/wiki/ru/upravlenie/bezopasnost-servera).

## Как обновлять Docker {#obnovlenie}

Docker из официального репозитория обновляется вместе с системой:

```bash
apt update && apt upgrade -y
```

Во время обновления служба перезапускается, и контейнеры с `restart: unless-stopped` поднимаются сами. Образы контейнеров обновляются отдельно, в папке проекта:

```bash
docker compose pull && docker compose up -d
```

## Частые ошибки {#oshibki}

- **`permission denied while trying to connect to the Docker daemon socket`.** Пользователь не в группе `docker`, или вы не перезашли по SSH после `usermod`.
- **`Cannot connect to the Docker daemon`.** Служба не запущена. Проверьте `systemctl status docker` и логи `journalctl -u docker -n 50`.
- **`docker-compose: command not found`.** Используйте `docker compose` через пробел.
- **`no space left on device`.** Закончился диск. Посмотрите, что занимает место, командой `docker system df` и удалите лишнее: `docker system prune`. Если не ограничили логи, сделайте шаг 4.

Если Docker нужно убрать с сервера целиком, вместе с образами и томами, смотрите [Как полностью удалить Docker](https://oblako.sh/wiki/ru/upravlenie/udalenie-docker).

## Кратко

- Ставьте Docker из официального репозитория: пакеты систем отстают на несколько версий.
- Один и тот же блок команд работает на Ubuntu 26.04, 24.04 и Debian 13.
- Сразу ограничьте размер логов в `/etc/docker/daemon.json`.
- Публикуйте внутренние порты на `127.0.0.1`: Docker обходит UFW.
- Compose вызывается как `docker compose`, через пробел.
