【Docker】エラー一覧

Dockerのエラー一覧です。Docker Desktop / Docker Engine / WSL 連携などの利用中に発生する代表的なエラーをまとめています。

子ページから項目を選択してください。

Dockerのエラー大分類

種類	典型例	主な原因
デーモン接続	Cannot connect to the Docker daemon / Connection refused	Docker Desktop未起動、dockerdサービス停止
WSL関連	WSL 2 installation is incomplete	WSL2のセットアップ不完全
ビルド失敗	Failed to fetch / package not found	ネットワーク・apt/yumリポジトリ問題
イメージpull	denied: requested access to the resource is denied	認証情報・プライベートレジストリ権限
ボリューム	read-only file system	マウント設定・SELinux/AppArmor
ポート	Bind for 0.0.0.0:80 failed: port is already allocated	ポート競合
ディスク	no space left on device	Dockerディスク使用量超過

本ページの子ページ

docker.errors.DockerException: Error while fetching server API version — Docker Desktopが起動していない／soketに接続できない
WSL 2 installation is incomplete. — Windows + Docker Desktop で WSL2 未セットアップ

エラー調査の基本コマンド

# Dockerが動いているか
$ docker info
$ docker version

# コンテナの状態とログ
$ docker ps -a
$ docker logs <container_id>
$ docker logs -f <container_id> # 追尾

# システムリソース
$ docker system df
$ docker system events

# ネットワーク
$ docker network ls
$ docker network inspect bridge

ディスク不足の対処

# 不要なリソースを削除
$ docker system prune
$ docker system prune -a # イメージも含めて
$ docker volume prune

# 個別に削除
$ docker container prune
$ docker image prune
$ docker network prune

デーモン接続できないとき

# Linux: dockerサービスの状態
$ sudo systemctl status docker
$ sudo systemctl start docker

# 一般ユーザーで docker コマンドを叩けるように
$ sudo usermod -aG docker $USER
# 再ログイン後に有効

# Mac / Windows: Docker Desktopを起動

注意点

WSL2環境では wsl --status で WSL バージョン確認
Mac/Windows の Docker Desktop は VM 経由で動作するため、ファイル共有・ネットワーク設定で挙動が変わる
本番運用ではログ出力先を journald や syslog に集約する設定が必要

ページ一覧

その他