Как настроить доступ к 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 и повторный вход в систему.
01Проверьте, что Docker установлен и сокет на месте
На сервере Docker уже должен быть установлен, отдельная установка здесь не нужна. Убедитесь, что служба docker запущена, а файл сокета существует. Команда docker version покажет версии клиента и сервера, если доступ к сокету уже есть.
systemctl is-active docker
ls -l /var/run/docker.sock
02Посмотрите на владельца и права сокета
Файл /var/run/docker.sock принадлежит пользователю root и группе docker, права обычно srw-rw----. Это значит, что читать и писать в сокет могут только root и члены группы docker. Если группы docker в выводе нет, демон настроен иначе, и дальше нужно смотреть его конфигурацию.
ls -l /var/run/docker.sock
getent group docker
03Добавьте пользователя в группу docker
Команда sudo usermod -aG docker $USER добавляет текущего пользователя в группу docker. Без -a список групп пользователя перезапишется, и вы потеряете остальные. Проверить членство можно командой id -nG.
sudo usermod -aG docker $USER
id -nG
04Войдите в систему заново
Новая группа применяется только в новом сеансе. Выйдите из SSH и подключитесь снова либо выполните newgrp docker в текущей оболочке. После этого id -nG должен показать docker в списке групп.
newgrp docker
id -nG
05Проверьте доступ к сокету без sudo
Запустите docker version и docker compose ps без sudo. Если ошибка permission denied исчезла, доступ к сокету настроен. Учтите, что членство в группе docker даёт права root на сервере: через сокет можно смонтировать любой каталог хоста в контейнер.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы