ひとことで言うと
# 実行中のコンテナ一覧
docker ps
# 停止中も含めた全コンテナ一覧
docker ps -a
やりたかったこと / 現象
「今どのコンテナが動いているか確認したい」「さっき停止したコンテナの名前を思い出せない」「特定のイメージから起動したコンテナだけ絞り込みたい」——こうした場面で最初に使うのが docker ps です。
デフォルトでは実行中のコンテナしか表示されないため、「コンテナが消えた」と勘違いしてしまうことがよくあります。オプションの使い分けを押さえておくと、コンテナ管理が一気に楽になります。
環境
- Docker: 20.10以降で動作確認
- OS: Linux / macOS / Windows（WSL2）
解決策
1. 実行中のコンテナを確認する
docker ps
CONTAINER ID IMAGE COMMAND STATUS PORTS NAMES
a1b2c3d4e5f6 nginx "/docker-entrypoint.…" Up 2 hours 0.0.0.0:80->80/tcp my-nginx
デフォルトでは 実行中（Up状態）のコンテナのみ が表示されます。
2. 停止中のコンテナも含めて全件表示する
docker ps -a
Exited になっているコンテナも一覧に含まれます。「コンテナが見つからない」と思ったら、まず -a を付けて確認しましょう。
3. 表示件数を絞り込む
# 直近作成した1件だけ表示
docker ps -l
# 直近作成した3件を表示
docker ps -n 3
4. コンテナIDだけを取得する
docker ps -aq
スクリプトで一括削除・一括停止する際によく使う書き方です。
# 停止中のコンテナをまとめて削除
docker rm $(docker ps -aq -f status=exited)
5. --filter で条件を絞り込む
# 特定イメージから起動したコンテナだけ表示
docker ps -a --filter "ancestor=nginx"
# 名前で絞り込む
docker ps -a --filter "name=my-nginx"
# 状態で絞り込む
docker ps -a --filter "status=exited"
6. --format で出力項目をカスタマイズする
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
NAMES STATUS PORTS
my-nginx Up 2 hours 0.0.0.0:80->80/tcp
Goテンプレート形式で必要な列だけを表示できるため、横に長くなりがちな docker ps の出力を見やすく整理できます。
7. コンテナのディスクサイズを表示する
docker ps -s
SIZE 列にコンテナが使用しているディスク容量が追加されます。ディスク圧迫の調査に便利です。
よくあるエラーと対処
コンテナが一覧に出てこない
docker ps は実行中のコンテナしか表示しません。停止済みの場合は -a を付けて確認してください。
docker ps -a
docker: command not found
Dockerがインストールされていないか、PATHが通っていません。インストール状況を確認しましょう。
docker --version
Cannot connect to the Docker daemon
Dockerデーモンが起動していません。OSに応じて起動します。
# Linux (systemd)
sudo systemctl start docker
# macOS / Windows
# Docker Desktopを起動する
--filter の条件を指定しても結果が0件になる
フィルタのキーやスペルミスが原因のことが多いです。ancestor はイメージ名、name はコンテナ名、status は running / exited / paused などの状態を指定します。指定値が正しいか再確認してください。
よくある質問
Q: docker ps と docker container ls の違いは何ですか？
どちらも同じ結果を返します。docker container ls は新しいサブコマンド体系の呼び方で、docker ps は従来からのエイリアスです。
Q: 停止中のコンテナだけを表示するには？
docker ps -a --filter "status=exited" を使います。
Q: コンテナ名だけをリスト表示したい場合は？
docker ps --format "{{.Names}}" で名前だけを1行ずつ出力できます。
Q: docker ps の出力が横に長くて見づらいときは？
--format オプションでtable形式のテンプレートを指定すると、必要な列だけに絞って見やすくできます。
Q: 複数の条件でフィルタできますか？
--filter を複数回指定すると、AND条件として絞り込まれます。例: docker ps -a --filter "status=exited" --filter "ancestor=nginx"
Q: docker compose で立ち上げたコンテナも同じように確認できますか？
docker ps でも表示されますが、docker compose ps を使うとプロジェクト単位で見やすく整理されます。
関連記事
この記事は errsolved.com にも掲載しています。