К содержимому

Как настроить доступ к docker sock на Ubuntu 24.04

Сокет /var/run/docker.sock это файл, через который клиент docker общается с демоном. Ошибка permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock значит, что у вашего пользователя нет прав на этот файл. Настройка занимает одну команду usermod и повторный вход в систему.

Руководство Docker 2 мин чтения

01Проверьте, что Docker установлен и сокет на месте

На сервере Docker уже должен быть установлен, отдельная установка здесь не нужна. Убедитесь, что служба docker запущена, а файл сокета существует. Команда docker version покажет версии клиента и сервера, если доступ к сокету уже есть.

bash
systemctl is-active docker
ls -l /var/run/docker.sock

02Посмотрите на владельца и права сокета

Файл /var/run/docker.sock принадлежит пользователю root и группе docker, права обычно srw-rw----. Это значит, что читать и писать в сокет могут только root и члены группы docker. Если группы docker в выводе нет, демон настроен иначе, и дальше нужно смотреть его конфигурацию.

bash
ls -l /var/run/docker.sock
getent group docker

03Добавьте пользователя в группу docker

Команда sudo usermod -aG docker $USER добавляет текущего пользователя в группу docker. Без -a список групп пользователя перезапишется, и вы потеряете остальные. Проверить членство можно командой id -nG.

bash
sudo usermod -aG docker $USER
id -nG

04Войдите в систему заново

Новая группа применяется только в новом сеансе. Выйдите из SSH и подключитесь снова либо выполните newgrp docker в текущей оболочке. После этого id -nG должен показать docker в списке групп.

bash
newgrp docker
id -nG

05Проверьте доступ к сокету без sudo

Запустите docker version и docker compose ps без sudo. Если ошибка permission denied исчезла, доступ к сокету настроен. Учтите, что членство в группе docker даёт права root на сервере: через сокет можно смонтировать любой каталог хоста в контейнер.

bash
docker version
docker compose ps

Частые ошибки

  • После sudo usermod -aG docker $USER команда docker всё равно выдаёт permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Группа применилась только к новым сеансам. Выйдите из SSH и войдите снова или выполните newgrp docker, затем проверьте id -nG.

  • Пользователь добавлен в группу без флага -a, и usermod убрал его из остальных групп.

    Верните нужные группы командой sudo usermod -aG docker,sudo $USER и войдите заново.

  • Сокет есть, но права на него изменены вручную через chmod 666, и любой пользователь сервера получает root.

    Верните права srw-rw---- и владельца root:docker: sudo chown root:docker /var/run/docker.sock и sudo chmod 660 /var/run/docker.sock.

  • Демон Docker не запущен, и docker version не показывает сервер.

    Запустите службу sudo systemctl start docker и проверьте systemctl is-active docker.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Что такое /var/run/docker.sock?

Это Unix-сокет, через который клиент docker и приложения обращаются к демону Docker. Права на файл определяют, кто может управлять контейнерами на сервере.

Безопасно ли добавлять пользователя в группу docker?

Членство в группе docker равно правам root: через сокет можно запустить контейнер с доступом к файлам хоста. Добавляйте только тех, кому доверяете управление сервером.

Почему после usermod всё ещё permission denied?

Текущая сессия сохраняет старый набор групп. Нужен новый вход по SSH или команда newgrp docker в открытой оболочке.

Можно ли подключиться к Docker по TCP вместо сокета?

Да, демон можно перевести на TCP, но открытый порт Docker API без защиты даёт полный доступ к серверу. Настройка TCP описана в отдельной инструкции по Docker API.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.