Computer >> Hướng Dẫn Máy Tính >  >> Hệ Thống >> Linux

Khắc phục lỗi 'Cannot Connect to Docker Daemon' nhanh chóng

Bạn đã bao giờ chạy Docker và bất ngờ gặp lỗi Cannot connect to the Docker daemon? Đây là một trong những vấn đề khó chịu nhất có thể khiến bạn dừng lại trước khi bắt đầu. Docker daemon chạy thầm lặng ở nền, xử lý mọi thứ từ khởi động/dừng container, quản lý image, xây dựng layer, và xử lý tất cả lệnh Docker như docker run, docker ps, v.v. Nếu terminal không thể kết nối tới nó, không có gì hoạt động.

Trong hướng dẫn này, tôi sẽ giải thích tại sao lỗi này xảy ra và chỉ cho bạn các sửa chữa đơn giản, thực tế để Docker chạy trơn tru trở lại.

Hiểu Docker Daemon làm gì

Docker daemon (dockerd) là dịch vụ nền chịu trách nhiệm quản lý container, image, mạng, và lưu trữ. Khi bạn chạy lệnh Docker, CLI không tự thực hiện các tác vụ này; thay vào đó, nó gửi yêu cầu đến daemon. Trên hệ thống Linux, giao tiếp này diễn ra qua Unix socket tại /var/run/docker.sock. Trên Docker Desktop hoặc môi trường WSL, CLI giao tiếp với daemon qua named pipe hoặc socket do máy ảo quản lý.

Nếu CLI không thể giao tiếp với daemon, bạn nhận được lỗi như Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?.

Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Thường xảy ra vì một trong những nguyên nhân sau:

  • Dịch vụ Docker không chạy.
  • User của bạn không có quyền truy cập Docker socket.
  • Docker dùng context sai.
  • Docker socket bị thiếu hoặc sai quyền.
  • Biến môi trường như DOCKER_HOST bị cấu hình sai.
  • Vấn đề đặc thù nền tảng (Docker Desktop, WSL, hoặc daemon từ xa).

Xác định phần nào trong chuỗi giao tiếp bị hỏng là chìa khóa để sửa đúng cách.

Kiểm tra quyền User

Trên hệ thống Linux, Docker giao tiếp qua Unix socket thuộc sở hữu user root. User phải thuộc nhóm docker để truy cập nó không cần sudo.

Để kiểm tra quyền socket, chạy lệnh:

ls -l /var/run/docker.sock
Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Kết quả cho thấy socket thuộc root, và chỉ user thuộc nhóm docker mới được đọc/ghi. Nếu tài khoản bạn không trong nhóm này, Docker sẽ từ chối truy cập và lệnh thất bại. Để sửa, thêm user vào nhóm docker:

sudo usermod -aG docker $USER

Nếu nhóm docker không tồn tại, tạo nó bằng:

sudo groupadd docker

Xác minh dịch vụ Docker đang chạy

Một vấn đề đơn giản nhưng quan trọng: Docker có thể hoàn toàn không chạy. Nếu daemon dừng, CLI không có gì để kết nối, dẫn đến lỗi nêu trên. Kiểm tra trạng thái dịch vụ Docker:

systemctl status docker

Trong trường hợp của chúng ta, Docker đang active và chạy thành công. Tuy nhiên, nếu đầu ra显示 trạng thái như inactive (dead) hoặc failed, nghĩa là dịch vụ Docker không chạy.

Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Để khởi động Docker thủ công, chạy:

sudo systemctl start docker

Nếu muốn Docker tự khởi động khi boot hệ thống, bật nó:

sudo systemctl enable docker

Khởi động Docker Daemon thủ công (dockerd)

Trên server tối giản hoặc setup Linux tùy chỉnh, Docker có thể không được quản lý bởi systemd. Trong môi trường này, daemon có thể không tự khởi động dù Docker đã cài. Để kiểm tra daemon có thể khởi động, thử chạy thủ công:

sudo dockerd

Quan sát đầu ra cẩn thận. Nếu có lỗi, Docker thường in thông báo rõ ràng giải thích vấn đề, như lỗi storage driver, lỗi quyền, hoặc xung đột mạng.

Kiểm tra và sửa Unix Socket Docker

Docker CLI tương tác với daemon qua Unix socket. Nếu socket bị thiếu, hỏng, hoặc sai quyền, Docker không kết nối. Kiểm tra socket tồn tại:

ls /var/run/docker.sock
Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Nếu file bị thiếu, thường nghĩa daemon không chạy, hoặc Docker thất bại tạo socket khi khởi động. Lúc đó, khởi động lại Docker để tạo lại:

sudo systemctl restart docker

Nếu socket tồn tại nhưng sai quyền, sửa bằng:

sudo chown root:docker /var/run/docker.sock
sudo chmod 660 /var/run/docker.sock
Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Xác minh Docker Context và Biến môi trường

Đôi khi Docker không kết nối daemon vì nó trỏ đến endpoint sai. Điều này xảy ra nếu biến môi trường DOCKER_HOST được đặt sai hoặc active Docker context trỏ đến môi trường từ xa hoặc không khả dụng.

Kiểm tra Biến môi trường

Chạy lệnh sau để xem biến môi trường liên quan Docker:

env | grep DOCKER

Nếu thấy kiểu DOCKER_HOST=tcp://localhost:2375, nghĩa là Docker trỏ đến daemon từ xa có thể không hoạt động hoặc thiếu. Sửa tạm thời bằng unset:

unset DOCKER_HOST

Để xóa vĩnh viễn, dọn nó khỏi file cấu hình shell như ~/.bashrc, ~/.zshrc, và /etc/environment.

Kiểm tra Docker Context đang active

Docker contexts quyết định CLI giao tiếp với daemon nào. Liệt kê context và xem cái nào active:

docker context ls
Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Dấu sao (*) chỉ context hiện tại. Nếu context trỏ đến môi trường không khả dụng, chuyển về default local daemon:

docker context use default

Vấn đề đặc thù nền tảng

Một số vấn đề kết nối chỉ xảy ra trên nền tảng cụ thể. Ví dụ, Docker Desktop trên Windows hoặc macOS chạy daemon trong VM nhẹ. Nếu VM không khởi động, CLI không kết nối. Sửa bằng cách restart Docker Desktop.

Tương tự, khi dùng Docker với WSL, daemon chạy trong môi trường Linux. Đảm bảo WSL cài đặt và chạy đúng:

wsl --list --running 
Khắc phục lỗi  Cannot Connect to Docker Daemon  nhanh chóng

Nếu daemon Docker không truy cập được từ WSL, restart dịch vụ Docker Desktop hoặc distro WSL cụ thể thường sửa được.

Mẹo tránh lỗi này trong tương lai

Để tránh lỗi cannot connect to Docker daemon sau này, luôn đảm bảo dịch vụ Docker chạy, đặc biệt sau cập nhật hệ thống, và thêm user vào nhóm docker để bỏ qua sudo. Kiểm tra thường xuyên active Docker context, đặc biệt sau khi chuyển máy, distro WSL, hoặc dùng Docker Desktop, và tránh đặt DOCKER_HOST trừ khi kết nối đến daemon từ xa cụ thể, vì biến sai có thể misdirect lệnh CLI. Ngoài ra, theo dõi log daemon bằng journalctl -u docker.service để bắt vấn đề sớm.