Як виправити помилку “Не вдалося підключитися до Docker Daemon” у Docker (посібник 2025 року)

текст перекладу
Зустріч із помилкою “Cannot connect to the Docker daemon” може бути розчаровуючою, але це поширена проблема для користувачів Docker. У цьому посібнику 2025 року ми розглянемо кроки для усунення та виправлення цієї помилки на Linux, Windows (з Docker Desktop або без нього) та macOS.

автор: Geoffroy Hauwen з unsplash

Зміст

• Поширені причини помилки Docker Daemon
• Як виправити помилки з підключенням до Docker Daemon на Linux
• Усунення помилок Docker Daemon на Windows
• Виправлення проблем з Docker Daemon на macOS
• Висновки: швидке усунення помилки Docker Daemon

Поширені причини помилки Docker Daemon

Якщо ви новачок у Docker, побачити повідомлення про помилку нижче може бути дуже неприємно:

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

Ця помилка виникає, коли Docker CLI (інтерфейс командного рядка) не може зв’язатися з Docker Daemon. Docker Daemon — це основна служба, яка керує контейнерами, а CLI виступає як клієнт. Ось короткий огляд найбільш поширених причин:

1. Docker Daemon не працює
   Docker Daemon може не бути запущений або несподівано зупинений.
2. Проблеми з правами доступу
   Docker потребує певних прав доступу для взаємодії з Docker Daemon, що часто є причиною цієї помилки.
3. Неправильна установка чи конфігурація Docker
   Неправильно налаштована інсталяція Docker може завадити нормальній роботі Daemon.
4. Проблеми інтеграції з WSL2 (Windows)
   Якщо ви використовуєте Docker з WSL2 (Windows Subsystem for Linux), проблеми інтеграції між Docker Desktop та WSL2 можуть спричинити цю помилку.

Як виправити помилки підключення до Docker Daemon на Linux

1. Переконайтесь, що Docker Daemon працює

Щоб перевірити стан служби Docker, використовуйте команду:

sudo systemctl status docker

Якщо служба не працює, запустіть її за допомогою:

sudo systemctl start docker

Щоб забезпечити автоматичний запуск Docker при завантаженні, введіть:

sudo systemctl enable docker

2. Перевірте права доступу

Docker вимагає правильних прав доступу для роботи з файлом сокету Docker за адресою /var/run/docker.sock. Додайте свого користувача до групи docker, щоб виконувати команди Docker без використання sudo:

sudo usermod -aG docker $USER

Після виконання цієї команди вийдіть із системи та увійдіть знову, щоб зміни набрали чинності.

3. Перевірте установку Docker

Якщо вищезазначені кроки не допомогли, перевірте інсталяцію Docker:

docker --version

Якщо потрібно, перезапустіть Docker Daemon:

sudo dockerd

Якщо проблема не зникла, перевстановіть Docker:

sudo apt-get remove docker docker-engine docker.io containerd runc  
sudo apt-get install docker.io

4. Діагностика додаткових проблем

Перевірте логи Docker для отримання додаткових підказок:

sudo journalctl -u docker

Усунення проблем з Docker Daemon на Windows

З Docker Desktop

1. Переконайтесь, що Docker Desktop працює
   Відкрийте Docker Desktop і запустіть його, якщо він не працює.
2. Перевірте інтеграцію з WSL2
   Виконайте наступну команду в PowerShell, щоб перевірити конфігурацію WSL2:
   wsl --list --verbose
3. Переконайтесь, що ваша за замовчуванням WSL2 дистрибуція налаштована для Docker. У Docker Desktop, в налаштуваннях General, переконайтесь, що встановлено "Use the WSL 2 based engine".
4. Перезапустіть Docker Desktop
   Якщо проблема зберігається, перезапустіть Docker Desktop, клацнувши правою кнопкою миші на значок Docker в системному треї та вибравши “Restart Docker”.

Без Docker Desktop (з WSL2)

1. Встановіть Docker Daemon у WSL2
Встановіть Docker у вашому Linux-дистрибутиві WSL2:

sudo apt-get update sudo apt-get install docker.io

2. Запустіть Docker Daemon
Запустіть Docker за допомогою:

sudo service docker start

3. Виконуйте Docker команди без sudo
Додайте свого користувача до групи docker:

sudo usermod -aG docker $USER

4. Перевірте, чи працює Docker
Перевірте роботу Docker:

docker ps

текст перекладу
## Додатково: Автоматичний запуск Docker при завантаженні

Автоматизуйте запуск Docker у WSL2, додавши це в ваш файл `.bashrc` або `.zshrc`:

echo "sudo service docker start" >> ~/.bashrc
```

Виправлення проблем з Docker Daemon на macOS

1. Переконайтесь, що Docker Desktop працює
   Відкрийте Docker Desktop і запустіть його, якщо він ще не працює.
2. Перезапустіть Docker Desktop
   Якщо Docker працює, але ви все одно стикаєтесь з проблемами, перезапустіть Docker Desktop для відновлення з’єднання.
3. Перевстановіть Docker Desktop
   Якщо помилка не зникає, перевстановіть Docker Desktop, щоб забезпечити правильну конфігурацію.

Підсумок: Усунення помилки “Cannot Connect to the Docker Daemon”

Для полегшення процесу усунення проблем, ми підготували кроки в вигляді блок-схеми. Використовуйте її як швидкий довідник для діагностики та системного вирішення проблеми:

Цей візуальний посібник охоплює наступні кроки:

1. Користувачі Docker Desktop: Якщо ви використовуєте Docker Desktop, дотримуйтесь конкретних кроків для усунення проблем.
2. Перевірка Docker Daemon: Переконайтесь, що Docker Daemon працює.
3. Перевірте права доступу: Переконайтесь, що ваш користувач має правильні права доступу.
4. Перевірка інсталяції: Переконайтесь, що Docker встановлений правильно і логи не містять помилок.
5. Перевстановлення або допомога: Якщо нічого не допомогло, спробуйте перевстановити Docker або звернутися за додатковою допомогою.

Дотримуючись цих кроків, ви зможете швидко вирішити помилку “Cannot Connect to the Docker Daemon”.

Висновки: Швидке виправлення помилки Docker Daemon

Помилка “Cannot connect to the Docker daemon” може бути розчаровуючою, але за допомогою кроків, наведених у цьому посібнику, ви зможете швидко усунути проблему. Незалежно від того, чи працюєте ви на Linux, Windows чи macOS, головне — переконатись, що Docker Daemon працює, перевірити права доступу та налаштування.

Дотримуючись цих кроків, ви знову зможете керувати своїми контейнерами без затримок. Якщо цей посібник був корисним, поділіться ним з іншими, хто стикається з тією ж проблемою. Залиште коментар із вашими думками або додатковими порадами!

Схожі статті:

Вступ до Docker: Порівняння фізичних серверів, віртуальних машин і контейнерів

Розуміння Docker: Основна архітектура контейнерів

Перекладено з: How to Fix the ‘Cannot Connect to the Docker Daemon’ Error in Docker (2025 Guide)