basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалDockerDocker Engine

    Docker на Ubuntu: из репозитория Docker, с пределом логов

    Ставим Docker Engine и плагин Compose из репозитория Docker — не docker.io из Ubuntu и не snap — и сразу ограничиваем логи контейнеров: без предела json-file растёт, пока не кончится диск. Порты, которые публикует Docker, фаервол ufw не закрывает — это тоже здесь.

    Откуда ставить

    Откуда Что получаем Когда берём
    репозиторий Docker, docker-ce свежий Engine и Compose v2 из одного места, Buildx; обновления в день выхода почти всегда — мануал про это
    docker.io из Ubuntu версия на момент выпуска Ubuntu, только исправления безопасности; обновляется unattended-upgrades — с перезапуском контейнеров ночью нужен Docker из основного репозитория по политике
    snap docker песочница: видит не все каталоги, свои пути к данным не берём на сервер
    скрипт get.docker.com то же, что репозиторий Docker, но одной командой, без видимых шагов одноразовые машины; на свой сервер — по шагам, чтобы видеть, что добавилось

    Настройка

    1. Убираем пакеты, которые конфликтуют

      sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)
      snap list docker 2>/dev/null && sudo snap remove docker

      dpkg --get-selections оставляет в списке только то, что стоит: на свежем сервере список пустой и удалять нечего. Если Docker стоял — образы и тома в /var/lib/docker/ при remove остаются.

    2. Подключаем репозиторий Docker

      sudo apt-get update
      sudo apt-get install -y ca-certificates curl
      sudo install -m 0755 -d /etc/apt/keyrings
      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
      
      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-get update

      Источник — в формате deb822 (.sources), как и ubuntu.sources в самой Ubuntu с 24.04. Signed-By — этим ключом apt проверяет только пакеты Docker, не все подряд. Suites подставляется из /etc/os-release: noble на 24.04, resolute на 26.04.

      Команды сверены со страницей установки на docs.docker.com 2026-10-18; там же в списке поддерживаемых — 26.04 и 24.04.

    3. Ставим Engine и Compose

      sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
      sudo docker version --format '{{.Server.Version}}'
      # 29.4.1
      docker compose version
      # Docker Compose version v5.6.0

      Служба запускается и включается в автозапуск сама: systemctl is-enabled docker — enabled.

    4. Ограничиваем логи контейнеров

      sudo tee /etc/docker/daemon.json >/dev/null <<'EOF'
      {
        "log-driver": "json-file",
        "log-opts": {
          "max-size": "10m",
          "max-file": "3"
        }
      }
      EOF
      sudo systemctl restart docker

      Каждый контейнер хранит не больше трёх файлов по 10 МБ — 30 МБ на контейнер. json-file оставляем драйвером, а не меняем на local: файлы *-json.log читают vector и другие сборщики логов («Логи Traefik»).

      Предел действует на контейнеры, созданные после правки. Если стеки уже работают — docker compose up -d --force-recreate в каждом.

      systemctl restart docker перезапускает все контейнеры. На сервере с сайтами это делаем, пока сайтов нет, или в спокойное время.

    5. Решаем, кому можно docker без sudo

      Группа docker даёт доступ к docker.sock, а через него — к root на хосте: docker run -v /:/host открывает всю файловую систему («docker.sock»). Пользователь в группе docker — это root без пароля.

      Как Что получаем
      sudo docker … между украденным ключом SSH и root стоит пароль sudo
      sudo usermod -aG docker example-user команды короче; ключ SSH даёт root сразу
      rootless Docker демон под обычным пользователем, root не нужен; не работают порты ниже 1024 без настройки и часть сетевых режимов

      На сервере, где входит один человек по ключу с паролем, часто выбирают группу — решение за нами, но делаем его, зная цену.

    6. Проверяем, что всё работает

      sudo docker run --rm hello-world | head -2
      #
      # Hello from Docker!

    Что дальше на сервере

    Если не работает

    permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock

    Причина
    Пользователь не в группе docker, или его добавили, а сессия старая.
    Делаем
    sudo docker … либо usermod -aG docker example-user и новый вход — но сначала прочитать, что даёт эта группа (шаг 5).

    docker-ce : Conflicts: docker.io при установке

    Причина
    На сервере уже стоит Docker из репозитория Ubuntu.
    Делаем
    Шаг 1: удаляем docker.io и соседей. Образы и тома в /var/lib/docker при remove остаются.

    Docker из snap: docker compose не видит файлы в /opt или /srv

    Причина
    Snap работает в песочнице: Docker из snap видит файлы только в домашнем каталоге, внешние диски — после snap connect docker:removable-media. Установщик Ubuntu Server предлагает его в списке snap-пакетов.
    Делаем
    sudo snap remove docker и установка из репозитория Docker. Данные snap лежат в /var/snap/docker/ — переносим тома до удаления.

    Диск заполнили файлы /var/lib/docker/containers/*/*-json.log

    Причина
    У драйвера json-file нет предела по умолчанию. Предел из daemon.json действует только на контейнеры, созданные после его установки.
    Делаем
    Шаг 4 и пересоздание контейнеров: docker compose up -d --force-recreate в каждом стеке.

    docker: 'compose' is not a docker command

    Причина
    Не поставлен плагин docker-compose-plugin; старый docker-compose (v1, через дефис) давно не обновляется.
    Делаем
    sudo apt install docker-compose-plugin.

    Как проверить

    Docker из нужного репозитория:

    apt-cache policy docker-ce | sed -n '1,4p'
    # docker-ce:
    #   Installed: 5:29.4.1-1~ubuntu.24.04~noble
    #   Candidate: 5:29.4.1-1~ubuntu.24.04~noble
    #   Version table:

    Предел логов действует на новый контейнер:

    sudo docker run -d --name logtest alpine sh -c 'while true; do date; sleep 1; done'
    sudo docker inspect logtest --format '{{.HostConfig.LogConfig}}'
    # {json-file map[max-file:3 max-size:10m]}
    sudo docker rm -f logtest

    Порты, открытые наружу, — каждый проверяем с телефона:

    sudo docker ps --format '{{.Names}}\t{{.Ports}}' | grep '0.0.0.0'