docker『Cannot Connect to the Docker Daemon』の原因と対処法

# 1) クライアントと接続先の現在値を確認
docker context ls
docker context show
echo "DOCKER_HOST=$DOCKER_HOST  DOCKER_CONTEXT=$DOCKER_CONTEXT"

# 2) デーモンの起動状態をOS別に確認
# Linux
sudo systemctl status docker
# macOS / Windows は Docker Desktop のUI起動を確認

# 3) ソケット/ポートに触れるか
ls -l /var/run/docker.sock 2>/dev/null || echo "no unix socket"
nc -vz 127.0.0.1 2375 2>/dev/null || echo "no tcp 2375 (if using tcp)"

# 4) 権限・グループ
id -nG | tr ' ' '\n' | grep -x docker || echo "not in docker group"

# デーモン起動・自動起動設定
sudo systemctl enable --now docker

# 起動ログの要点を確認（直近）
journalctl -u docker -n 200 --no-pager

# 設定変更後はリロード→再起動
sudo systemctl daemon-reload
sudo systemctl restart docker

# CLI からの強制再起動（macOS）
osascript -e 'quit app "Docker"' ; sleep 2 ; open -a Docker
# エンジン再起動は Docker Desktop の Troubleshoot → Restart でも可

# WSL2 側でのサービス確認（dockerd を使う構成の場合）
wsl -l -v
wsl.exe -d Ubuntu -- sh -lc "ps aux | grep dockerd"

# Docker Desktop のエンジン再起動
"%ProgramFiles%\\Docker\\Docker\\DockerCli.exe" -SwitchLinuxEngine
"%ProgramFiles%\\Docker\\Docker\\DockerCli.exe" -SwitchWindowsEngine

# WSL ネットワーク/ディストリ再起動
wsl --shutdown
wsl --unregister <不要なDistro名>   # ※注意：消えるので通常は不要

# 自ユーザーを docker グループへ追加（Linux）
sudo usermod -aG docker "$USER"
# 反映（ログインし直す／新しいログインシェル）
newgrp docker
# 確認
id -nG | tr ' ' '\n' | grep -x docker && docker ps

# 環境変数を無効化
unset DOCKER_HOST DOCKER_CONTEXT

# default コンテキストに戻す
docker context use default

# 現在の接続先を明示確認
docker context inspect --format '{{json .Endpoints.docker}}' | jq .

# ソケットの存在と所有権
ls -l /var/run/docker.sock
# 期待値：srw-rw---- 1 root docker ... /var/run/docker.sock

# おかしい場合は dockerd を再起動（直接 chmod での調整は最小限に）
sudo systemctl restart docker

# どうしても必要な緊急回避（再起動後は元に戻すこと）
sudo chgrp docker /var/run/docker.sock
sudo chmod 660 /var/run/docker.sock

# rootless が有効なユーザー側で環境を再ロード
systemctl --user status docker
systemctl --user restart docker

# 必要な環境変数を再読み込み（インストール時のメッセージ参照）
grep -E 'DOCKER_HOST|XDG_RUNTIME_DIR' ~/.bashrc ~/.profile ~/.zshrc

# daemon 側のプロキシ設定（Linux /etc/systemd/system/docker.service.d/proxy.conf）
[Service]
Environment="HTTP_PROXY=http://proxy:8080" "HTTPS_PROXY=http://proxy:8080" "NO_PROXY=localhost,127.0.0.1,::1,registry.local"
# 反映
sudo systemctl daemon-reload && sudo systemctl restart docker

# データ消去を伴うため事前にイメージ/ボリュームのバックアップを検討
# macOS/Windows: Docker Desktop → Troubleshoot → Clean / Reset to factory defaults

# Linux
journalctl -u docker --since "1 hour ago" --no-pager
# Desktop
# 画面右上 Troubleshoot → Support → "Get Support" から診断バンドルを取得

# 連携をリセット
wsl --shutdown
# Docker Desktop → Settings → Resources → WSL Integration で対象Distroのチェックを入れ直す
# Distro から docker へ PATH が通っているか確認
wsl.exe -d Ubuntu -- sh -lc "which docker && docker version"

# 自動起動
sudo systemctl enable docker

# 簡易ヘルスチェック（CIなどで）
docker version || exit 1
docker info    || exit 1