「あれ、ログを追いかけるオプションって -f だっけ -t だっけ」。
Dockerは毎日のように触るのに、こういう小さな度忘れで手が止まります。
先に答えを置くと、開発で出番が多いのは run・ps・logs・exec・stop・rm・images・build・compose up・compose down の10個です。
この記事はその10個の表から始まるチートシートです。そのあとに目的別のコマンド一覧、Composeの書き方、よく間違えるオプション、消しすぎる危ないコマンドと続きます。
各行から、もっと詳しい記事へ飛べるようにしてあります。
この記事でわかること
- よく使うDockerコマンド10個と、それぞれの一言説明
- イメージ・コンテナ・ログ・ボリューム・ネットワーク・Compose・掃除・調査の目的別一覧
docker psとdocker container ls、docker-composeとdocker composeの新旧の違い-it・-d・--rm・-p・-vのよくある勘違いdocker system prune -a --volumesとdocker compose down -vで何が消えるか
動作確認した版は、手元のMac(Rancher Desktop)に入っている Docker 27.4.1 と Docker Compose v2.32.1 です。書式はそれぞれの --help とDockerのCLIリファレンスで照らし合わせました。
PARTS LIST /目次
- Dockerでよく使うコマンド10個の早見表
- イメージを操作するコマンド一覧(pull・build・tag)
- コンテナの起動・停止・削除のコマンド
- ログを見る・コンテナの中に入るコマンド
- ボリューム・ネットワークのコマンド
- Docker Composeのコマンド一覧
- 掃除のコマンドと危ない組み合わせ
- 調べる・確かめるコマンド(inspect・stats・system df)
- まとめて操作する便利な書き方(一括停止・--format・--filter)
- 新旧の書き方:docker psとdocker container ls
- よく間違えるオプション5つ(-it・-d・--rm・-p・-v)
- うまく動かないときの確認コマンド
- よくある質問
- Dockerコマンドを覚える次の一歩
Dockerでよく使うコマンド10個の早見表
Dockerコマンドとは、Dockerのイメージやコンテナを操作するために docker に続けて打つ命令のことです。
全部で数十個ありますが、開発で毎日触るのはそのうちのひと握りで、残りは「たまに調べて打つ」ものです。
まずは頻出の10個だけ覚えて、残りはこの記事の目的別一覧を辞書として引く使い方をおすすめします。
開発の1日で出番が多い10コマンド
アプリを起動して、ログを見て、中に入って直して、止めて片付ける。開発の1日の流れで出番が多い順に並べると、次の10個です。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker compose up -d | compose.yamlのサービスをまとめて起動 | Compose入門 |
docker ps | 動いているコンテナを一覧(-a で停止中も) | この記事の「コンテナ」の節 |
docker logs -f コンテナ | ログを流しっぱなしで見る | この記事の「ログ」の節 |
docker exec -it コンテナ sh | 動いているコンテナの中でシェルを開く | コンテナに入る方法 |
docker compose down | Composeのコンテナとネットワークを止めて削除 | Compose入門 |
docker run イメージ | イメージから新しいコンテナを作って起動 | Docker入門 |
docker stop コンテナ | コンテナを止める(消さない) | この記事の「コンテナ」の節 |
docker rm コンテナ | 止まったコンテナを削除 | この記事の「コンテナ」の節 |
docker images | 手元のイメージを一覧 | Docker Hubの使い方 |
docker build -t 名前 . | Dockerfileからイメージを作る | Dockerfileの書き方 |
Composeを使うプロジェクトなら、上の2つ(compose up と compose down)だけで1日が終わる日もあります。
逆に、Composeを使わずに単体のコンテナを動かすときは run → logs → stop → rm の流れが基本です。
1日の流れで打つ順番の例
表のコマンドを、実際に打つ順番に並べ直すと次のようになります。まずは単体のコンテナでNginxを動かして片付けるまでです。
# 1. イメージを取ってきて、名前とポートを付けて裏で起動
docker run -d --name web -p 127.0.0.1:8080:80 nginx:1.27
# 2. 動いているか確かめる
docker ps
# 3. ログを追う(Ctrl+Cで抜けてもコンテナは止まらない)
docker logs -f web
# 4. 中で設定ファイルを見る
docker exec -it web sh
# 5. 止めて、消す
docker stop web
docker rm web
Composeを使うプロジェクトでは、同じ流れがもっと短くなります。サービス名(compose.yamlに書いた web など)で指定するので、コンテナ名を覚えておく必要もありません。
docker compose up -d # 起動
docker compose ps # 状態を見る
docker compose logs -f web # webのログを追う
docker compose exec web sh # webの中に入る
docker compose down # 止めて片付ける(データのボリュームは残る)
単体で動かすか、Composeで動かすか。迷ったら、コンテナが2つ以上あるならComposeを選ぶと覚えておけば足ります。
コマンドの基本の形と「対象 動詞」の書き方
Dockerのコマンドは docker [オプション] コマンド [引数] の形で書きます。
ややこしいのは、同じ操作に2通りの書き方があることです。docker ps は短い昔からの書き方で、docker container ls は「対象(container)+動詞(ls)」で書く新しい書き方です。
手元の docker ps --help を見ると、次の4つが同じコマンドの別名として並んでいます。
Aliases:
docker container ls, docker container list, docker container ps, docker ps
どちらで書いても結果は同じです。新旧の対応表は後半の「新旧の書き方」の節にまとめました。
表の「コンテナ」「イメージ」の部分
実際にはコンテナ名(--name で付けた名前)か、コンテナIDの先頭数文字を入れます。IDは他のコンテナと区別できれば、先頭の数文字だけでも通ります。
イメージを操作するコマンド一覧(pull・build・tag)
イメージとは、コンテナを作るための設計図にあたるファイル一式です。
イメージのコマンドは「取ってくる・作る・名前を付ける・送る・消す」の5種類に分かれます。
イメージそのものの考え方はDocker入門、公式イメージの選び方はDocker Hubの使い方が詳しいので、ここではコマンドの早見表に絞ります。
イメージを取得・一覧・削除する
Docker Hubなどのレジストリからイメージを取ってくるのが pull、手元の一覧が images、消すのが rmi です。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker pull nginx:1.27 | イメージをダウンロード(タグ省略で latest) | Docker Hub |
docker images | 手元のイメージを一覧 | ― |
docker image ls -q | イメージIDだけを一覧 | ― |
docker rmi イメージ | イメージを削除 | ― |
docker image history イメージ | どの命令でどれだけ増えたかを見る | Dockerfileの書き方 |
docker search キーワード | Docker Hubを検索 | Docker Hub |
タグを省略すると latest が使われます。
latest は「最新」ではなく「タグを付けなかったときの名前」なので、半年後に同じコマンドを打つと中身が変わっていることがあります。チーム開発では nginx:1.27 のように版まで書くほうが、あとで困りません。
イメージをビルド・タグ付け・pushする
自分のアプリをイメージにするのが build、別名を付けるのが tag、レジストリへ送るのが push です。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker build -t myapp:1.0 . | カレントのDockerfileからビルド | Dockerfileの書き方 |
docker build -f Dockerfile.dev -t myapp:dev . | 別名のDockerfileを指定 | 同上 |
docker build --no-cache -t myapp . | キャッシュを使わずにビルドし直す | 同上 |
docker tag myapp:1.0 ユーザー名/myapp:1.0 | 既存イメージに別名を付ける | Docker Hub |
docker login | レジストリにログイン | 同上 |
docker push ユーザー名/myapp:1.0 | レジストリへ送る | 同上 |
docker build の最後の . は「ビルドに使うフォルダ(ビルドコンテキスト)」です。
ここを忘れると、手元では次のように止まりました(docker build の中身は BuildKit の docker buildx build なので、名前がそちらで出ます)。
ERROR: "docker buildx build" requires exactly 1 argument.
See 'docker buildx build --help'.
カレントのフォルダを渡すなら .、別のフォルダなら ./app のように書きます。
docker tag はイメージをコピーするわけではありません。同じイメージに名前をもう1つ付けるだけなので、容量は増えません。push先のリポジトリ名(ユーザー名/イメージ名)に合わせるために使います。
コンテナの起動・停止・削除のコマンド
コンテナとは、イメージから作られて実際に動いているアプリの実体です。
コンテナには「作られた」「動いている」「止まっている」「消えた」の状態があり、コマンドは状態を移すスイッチだと考えると覚えやすくなります。
起動・停止・削除で迷ったら、この節の表と下の図で今どの状態かを確かめてください。
run・start・stop・restartの使い分け
run は「イメージから新しいコンテナを作って起動」、start は「止まっている既存のコンテナを起動し直す」です。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker run -d --name web -p 8080:80 nginx:1.27 | 名前とポートを付けて裏で起動 | ネットワークとポート |
docker run --rm -it ubuntu bash | 使い捨てのコンテナでシェルを開く | コンテナに入る方法 |
docker start web | 止まっているコンテナを再び起動 | ― |
docker stop web | コンテナを止める | ― |
docker restart web | 止めてから起動し直す | ― |
docker kill web | 待たずに強制終了 | ― |
docker run を打つたびに、コンテナは1つずつ増えます。
「さっきのコンテナをもう一度動かしたい」ときに run を打つと、名前の重複でエラーになるか、似たコンテナが量産されます。2回目以降は start です。
docker stop は、まず終了の合図(SIGTERM)を送り、決まった秒数待っても止まらなければ強制終了します。待つ秒数は -t で変えられます(docker stop -t 30 web)。
「Docker 再起動 コマンド」で探している人は、何を再起動したいかで打つものが変わります。
- コンテナ1つ:
docker restart コンテナ - Composeのサービス:
docker compose restart サービス - Dockerのデーモン(Linux):
sudo systemctl restart docker - Docker Desktop(Mac):アプリを終了して起動し直す(ターミナルからなら
open -a Docker)
ps・rmとコンテナの状態の流れ
一覧を見るのが ps、消すのが rm です。どちらも止まっているコンテナが絡むと引っかかりやすいので、オプションまで覚えておきます。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker ps | 動いているコンテナだけ一覧 | ― |
docker ps -a | 止まっているものも含めて一覧 | ― |
docker ps -q | コンテナIDだけ出す | ― |
docker rm web | 止まっているコンテナを削除 | ― |
docker rm -f web | 動いていても強制的に削除 | ― |
docker rename 旧名 新名 | コンテナの名前を変える | ― |
docker ps に出てこないのに名前の重複で怒られたら、止まったコンテナが残っています。docker ps -a で探して docker rm で消してください。
状態と、状態を移すコマンドの関係を図にすると次のようになります。
flowchart TD
I["イメージ"] -->|"docker create"| C["作成済み"]
I -->|"docker run"| R["実行中"]
C -->|"docker start"| R
R -->|"docker stop<br/>docker kill"| S["停止"]
S -->|"docker start"| R
R -->|"docker restart"| R
S -->|"docker rm"| D["削除"]
R -->|"docker rm -f"| D
docker stop で止めたコンテナは、消えずに残っています。中で作ったファイルも残るので、docker start すれば続きから動きます。
消えるのは docker rm したときだけです。ここを取り違えると「止めたら全部消えた」「消したはずなのに残っている」の両方が起きます。
docker runでよく足すオプション
docker run --help の出力はスクロールしないと読み切れないほど長いのですが、開発で付けるものは限られます。名前とポート以外で出番が多いのは次のあたりです。
| オプション | 何をするか | 書き方の例 |
|---|---|---|
--name | コンテナに名前を付ける | --name web |
-e | 環境変数を1つ渡す | -e TZ=Asia/Tokyo |
--env-file | ファイルから環境変数をまとめて渡す | --env-file .env |
-w | 中での作業フォルダを決める | -w /app |
-u | 実行するユーザーを決める | -u 1000:1000 |
--network | つなぐネットワークを選ぶ | --network mynet |
--restart | 落ちたときに自動で起動し直す | --restart unless-stopped |
--platform | CPUの種類を指定してイメージを選ぶ | --platform linux/amd64 |
--entrypoint | イメージの起動コマンドを差し替える | --entrypoint sh |
-m | メモリの上限を決める | -m 512m |
--restart の値は、何もしない no(既定値)、異常終了したときだけの on-failure、常に起動し直す always、手で止めたときは起動し直さない unless-stopped の4種類です。開発用のDBを「Macを再起動しても上がっていてほしい」ときは unless-stopped が扱いやすい選択です。
--platform linux/amd64 は、Apple シリコン(M1以降)のMacで、arm64版が配られていないイメージを動かすときに使います。動きはしますが、CPUの命令を変換しながら動くぶん遅くなります。
--entrypoint sh は、起動してすぐ落ちるコンテナの中を調べたいときの奥の手です。イメージ本来の起動コマンドの代わりにシェルが立ち上がるので、docker run --rm -it --entrypoint sh イメージ で中のファイルを見られます。
ログを見る・コンテナの中に入るコマンド
アプリが動かないとき、最初に打つのが logs、次に打つのが exec です。
ログで原因が分かれば中に入る必要はありません。分からなければ中に入って、設定ファイルや環境変数を直接確かめます。
ファイルをコンテナとMacの間で受け渡す cp も、この節にまとめます。
logs・exec・cpの書き方
logs は標準出力と標準エラーに出たものを表示し、exec は動いているコンテナの中で別のコマンドを実行します。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker logs web | これまでのログを全部表示 | ― |
docker logs -f web | ログを流しっぱなしで追う(Ctrl+Cで抜ける) | ― |
docker logs -n 100 web | 末尾100行だけ(--tail 100 と同じ) | ― |
docker logs --since 10m web | 直近10分のログ | ― |
docker exec -it web sh | コンテナの中でシェルを開く | コンテナに入る方法 |
docker exec web env | 中に入らず環境変数だけ見る | 同上 |
docker cp web:/etc/nginx/nginx.conf . | コンテナからMacへコピー | ― |
docker cp ./app.conf web:/tmp/ | Macからコンテナへコピー | ― |
冒頭で度忘れした「ログを追う」は -f(follow)です。-t はタイムスタンプを付けるオプションで、組み合わせて docker logs -ft web とも書けます。
exec で開くシェルは、イメージに入っているものしか使えません。軽量なalpine系のイメージには bash がないことが多いので、bash で失敗したら sh を試してください。bashとshの選び方や attach との違いはコンテナに入る方法にまとめています。
Dockerを初めて使ったとき、私は「コンテナの中に入る」という言い方で混乱しました。
いまは開発の業務で日常的にDockerを使っています。その立場から当時の自分に説明するなら、exec は「動いている箱の中で、もう1本コマンドを走らせる」ものだと言います。入る、より「中で打つ」と考えたほうが、-it や sh を付ける理由もつながって見えるはずです。
ボリューム・ネットワークのコマンド
ボリュームとは、コンテナを消しても残しておきたいデータ(DBのファイルなど)を置く場所です。
ネットワークは、コンテナ同士やMacとコンテナをつなぐ線です。どちらも普段はComposeが自動で作ってくれるので、コマンドを打つのは「中身を確かめたい」「消したい」ときが中心になります。
ボリュームの作成・一覧・削除
ボリュームのコマンドは docker volume の下にまとまっています。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker volume ls | ボリュームを一覧 | Compose volumes |
docker volume create db-data | 名前付きボリュームを作る | 同上 |
docker volume inspect db-data | 実体の場所や作成日時を見る | 同上 |
docker volume rm db-data | ボリュームを削除 | 同上 |
docker run -v db-data:/var/lib/data イメージ | ボリュームをコンテナにつなぐ | 同上 |
docker volume rm で消したデータは戻りません。DBのデータが入ったボリュームを消すと、そのDBは空からやり直しです。
Composeでの volumes: の書き方、名前付きボリュームとバインドマウントの使い分けはCompose volumesの書き方で詳しく扱っています。
ネットワークとポートの確認
ネットワークは docker network、公開しているポートの確認は docker port です。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker network ls | ネットワークを一覧 | ネットワークとポート |
docker network create mynet | ネットワークを作る | 同上 |
docker network connect mynet web | 既存コンテナをネットワークにつなぐ | 同上 |
docker network inspect mynet | つながっているコンテナとIPを見る | 同上 |
docker port web | Mac側に公開しているポートを見る | 同上 |
同じネットワークにいるコンテナ同士は、コンテナ名(Composeならサービス名)で名前解決できます。
「アプリからDBにつながらない」ときは、まず docker network inspect で2つのコンテナが同じネットワークにいるかを見ます。bridgeの仕組みと -p の関係はネットワークとポートの記事が詳しいです。
Docker Composeのコマンド一覧
Docker Composeとは、複数のコンテナの設定を compose.yaml 1つに書いて、まとめて起動・停止するための仕組みです。
コマンドは docker compose に続けて書きます。単体の docker コマンドと名前が似ていますが、対象が「コンテナ」ではなく「サービス(compose.yamlに書いた名前)」になるのが大きな違いです。
ymlの書き方から知りたい人は、先にCompose入門を読むと、この節の表がぐっと読みやすくなります。
up・down・ps・logs・exec
Composeで毎日打つのは、起動の up と片付けの down、それに状態とログを見る3つです。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker compose up -d | 全サービスを裏で起動 | Compose入門 |
docker compose up -d --build | イメージを作り直してから起動 | 同上 |
docker compose up --wait | 起動して、healthyになるまで待つ | healthcheckの書き方 |
docker compose down | コンテナとネットワークを止めて削除 | 同上 |
docker compose ps | このプロジェクトのコンテナを一覧 | ― |
docker compose logs -f web | webサービスのログを追う | ― |
docker compose exec web sh | webサービスの中でシェルを開く | コンテナに入る方法 |
docker compose run --rm web コマンド | 使い捨てのコンテナでコマンドを1回実行 | ― |
docker compose exec は、-it を付けなくても対話できます。単体の docker exec と書き方がずれるので、地味に迷うところです。
--wait の説明は、手元のヘルプでは「Wait for services to be running|healthy. Implies detached mode.」です。付けると -d も付けたものとして動きます。healthcheckを書いたサービスなら、DBが本当に受け付けられる状態になるまで待ってから戻ってきます。
build・pull・config・restart
起動と停止以外では、イメージの準備と設定の確認に使うコマンドがあります。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker compose build | Dockerfileのあるサービスをビルド | Dockerfileの書き方 |
docker compose pull | imageのサービスのイメージを取得 | ― |
docker compose config | 変数や省略を展開した最終形を表示 | ― |
docker compose restart web | サービスを再起動 | ― |
docker compose stop | 止める(コンテナは残す) | ― |
docker compose ls | 動いているComposeプロジェクトを一覧 | ― |
docker compose -f compose.dev.yaml up -d | 別のファイルを指定して起動 | ― |
docker compose config は、デーモンが止まっていても動きます。ymlの書き間違いを探すのに便利で、試しに ports を port と1文字間違えたファイルを読ませると、次のように止まりました。
validating /path/to/compose.yaml: services.web Additional property port is not allowed
正しいファイルなら、省略した書き方を展開した最終形が出ます。たとえば ports: - "127.0.0.1:8080:80" と書いたサービスは、次のように読まれていました。
ports:
- mode: ingress
host_ip: 127.0.0.1
target: 80
published: "8080"
protocol: tcp
published がMac側、target がコンテナ側です。後半の「-p の向き」で書く左右の意味が、ここではっきり見えます。試したフォルダの名前は new-docker-cmd で、ネットワーク名も new-docker-cmd_default と「フォルダ名_default」で作られていました。プロジェクト名は、何も指定しなければフォルダ名から決まります。
プロジェクト名・環境変数・profileの指定
チームのプロジェクトで手順書に出てくるのが、ファイルや名前を切り替えるオプションです。どれも docker compose の直後、up などのコマンドより前に書きます。
| 書き方 | 何をするか | 使う場面 |
|---|---|---|
docker compose -p myapp up -d | プロジェクト名を指定 | 同じymlを別名で2つ動かす |
docker compose --env-file .env.dev up -d | 読み込む環境変数のファイルを変える | 開発用と検証用の切り替え |
docker compose --profile debug up -d | profileを付けたサービスも起動 | 管理画面などを必要なときだけ |
docker compose up -d --force-recreate | 設定が同じでもコンテナを作り直す | 起動時の処理をやり直したい |
docker compose exec -T web コマンド | TTYなしで実行 | CIやスクリプトから呼ぶ |
docker compose watch | ファイルの変更でビルドや同期をやり直す | 開発中の自動反映 |
exec -T は、前の節の「docker compose exec は -it なしで対話できる」の裏返しです。
手元のヘルプにも「By default docker compose exec allocates a TTY」とあります。TTYのない環境(CIやcronから呼ぶスクリプト)では、-T を付けないと止まることがあります。
docker-composeとdocker composeの違い(v1の終了)
ハイフンありの docker-compose は Compose v1、スペース区切りの docker compose は Compose v2 の書き方です。
Docker社は2023年1月の発表で、Compose v1 のサポートを2023年6月で終えると告知しました(Docker社の発表)。いまは docker compose を使います。
| 項目 | docker-compose(v1) | docker compose(v2) |
|---|---|---|
| 書き方 | ハイフンでつなぐ | docker のサブコマンド |
| 状態 | 更新終了 | 現行 |
| コンテナ名の区切り | _(例: app_web_1) | -(例: app-web-1) |
古い記事や社内手順書に docker-compose up -d とあっても、多くは docker compose up -d に置き換えるだけで動きます。
注意したいのは、コンテナ名を決め打ちで書いたシェルスクリプトです。区切りが _ から - に変わったので、app_web_1 を探すスクリプトはv2では空振りします。
ちなみに手元のMacで docker-compose version を打つと、Docker Compose version v2.32.1 と返ってきました。ハイフン付きで打っても中身はv2、という環境もあるわけです。どちらで打っても動くので、v1が残っていると勘違いしやすいところです。
掃除のコマンドと危ない組み合わせ
Dockerを使っていると、止まったコンテナや古いイメージ、ビルドのキャッシュが少しずつ溜まります。
prune は「使われていないもの」をまとめて消すコマンドで、対象ごとに6種類あります。便利な反面、オプションの組み合わせによってはDBのデータまで消えます。
詳しい使い分けと容量を戻した手順はdocker pruneの使い方にまとめているので、ここでは一覧と危ない組み合わせだけを押さえます。
prune系と容量確認の一覧
消す前に docker system df で、どこに容量を使っているかを確かめるのが先です。
| コマンド | 何を消すか | 詳しい記事 |
|---|---|---|
docker system df | 消さない。種類ごとの使用量を表示 | docker prune |
docker container prune | 止まっているコンテナ | 同上 |
docker image prune | タグのないイメージ(dangling) | 同上 |
docker image prune -a | どのコンテナも使っていないイメージ全部 | 同上 |
docker builder prune | ビルドキャッシュ | 同上 |
docker network prune | どのコンテナも使っていないネットワーク | 同上 |
docker volume prune | 使われていない匿名ボリューム | 同上 |
docker system prune | 上のうちボリューム以外をまとめて | 同上 |
docker volume prune は、手元の27.4.1では名前のない匿名ボリュームだけが対象です。ヘルプの -a の説明は「Remove all unused volumes, not just anonymous ones」です。名前付きボリュームまで消すには -a が要ります。
system prune -a --volumesとdown -vの注意
危ないのは「全部」系のオプションを重ねたときです。何が消えるかを並べると、次のようになります。
| コマンド | 消えるもの | 戻せるか |
|---|---|---|
docker system prune | 停止中のコンテナ、未使用ネットワーク、danglingイメージ、未使用のビルドキャッシュ | イメージは取り直せる |
docker system prune -a | 上に加えて、コンテナが使っていないイメージ全部とビルドキャッシュ全部 | 取り直し・ビルドし直しに時間がかかる |
docker system prune -a --volumes | 上に加えて、使われていない匿名ボリューム | 匿名ボリュームのデータは戻らない |
docker compose down -v | そのプロジェクトのコンテナ・ネットワークと、composeに書いた名前付きボリューム | DBのデータは戻らない |
docker compose down -v の -v は、compose.yamlの volumes: に書いた名前付きボリュームまで消します。
手元のヘルプの説明も「Remove named volumes declared in the "volumes" section of the Compose file」です。
名前付きボリュームに置いたデータは、docker compose down(-v なし)や docker system prune では残ります。コンテナが消えても、up し直せば同じボリュームがつながります。消して困るのは -v を付けたときと、ボリュームの設定を書かずにDBを動かしていたとき(データが匿名ボリュームに入る)です。消したくないデータがあるときは、-v も -f も付けず、確認のプロンプトで中身を読んでから y を押してください。
-f(--force)を付けると「Are you sure you want to continue? [y/N]」の確認が出ずに、いきなり消えます。
確認を飛ばしたいのは自動化のスクリプトの中だけで、手で打つときは付けない、と決めておくのが安全です。
消す前に確かめる4ステップ
容量が足りなくなって慌てているときほど、いきなり -a --volumes を打ちたくなります。消す前に次の順で確かめると、残したいものを巻き込まずに済みます。
step
1docker system df で容量の内訳を見る
イメージ・コンテナ・ボリューム・ビルドキャッシュのどれが大きいかを見ます。RECLAIMABLE(取り戻せる量)の列が大きいところから手を付けます。
step
2docker ps -a で止まったコンテナを確かめる
止まっているコンテナは container prune で消えます。あとで start したいものが混ざっていないかを見ます。
step
3docker volume ls で残したいボリュームを確かめる
DBのデータが入ったボリュームの名前を控えます。名前付きなら system prune --volumes でも残りますが、匿名ボリュームは長い英数字の名前で並ぶので、どのコンテナのものかは docker inspect で確かめます。
step
4対象を絞ったpruneを -f なしで打つ
ビルドキャッシュが大きければ docker builder prune、イメージなら docker image prune のように、大きいところだけを消します。確認のプロンプトに出る一覧を読んでから y を押します。
1つずつ消すと手間に見えます。それでも、消す範囲が小さいほど、あとで取り直したりビルドし直したりするものも少なくて済みます。
調べる・確かめるコマンド(inspect・stats・system df)
「設定は合っているはずなのに動かない」とき、思い込みを事実で確かめるのが調査系のコマンドです。
ログ(logs)と中に入る(exec)で分からないときは、この節のコマンドでコンテナの設定とリソースの使い方を直接見ます。
| コマンド | 何をするか | 詳しい記事 |
|---|---|---|
docker inspect web | 設定を全部JSONで表示 | ― |
docker inspect -f '{{.State.Status}}' web | 必要な値だけ取り出す | ― |
docker stats | CPU・メモリの使用量をリアルタイム表示 | ― |
docker top web | コンテナの中で動いているプロセス | ― |
docker events | 起動・停止などの出来事を流して表示 | ― |
docker version | クライアントとサーバーの版 | ― |
docker info | デーモンの状態や設定 | ― |
docker system df -v | 容量の内訳を詳しく | docker prune |
docker inspect の出力はとにかく長いので、-f で必要な値だけ抜くのが実用的です。
よく抜き出すのは、状態・終了コード・環境変数の3つです。
# コンテナの状態(running / exited など)
docker inspect -f '{{.State.Status}}' web
# 終了コード(0以外なら異常終了)
docker inspect -f '{{.State.ExitCode}}' web
# 環境変数の一覧
docker inspect -f '{{.Config.Env}}' web
コンテナが勝手に止まるときは、終了コードを見ると原因の当たりが付きます。137なら強制終了(メモリ不足でOSに止められた場合も含む)、1ならアプリ自身のエラー、というように切り分けられます。
イメージの脆弱性を調べたいときは、docker の標準コマンドではなく、TrivyやGrypeといった専用のツールを使います。使い方は脆弱性診断の記事にまとめました。
まとめて操作する便利な書き方(一括停止・--format・--filter)
コマンド1つずつは覚えても、コンテナが10個並ぶと1つずつ打つのは面倒です。
Dockerのコマンドは、IDだけを出す -q、絞り込みの --filter、表示を整える --format を組み合わせると、まとめて操作できます。ここでは手で打つ機会が多い組み合わせを集めました。
全部のコンテナをまとめて止める・消す
docker ps -q はコンテナIDだけを1行ずつ出すので、$( ) で囲んで別のコマンドに渡せます。
# 動いているコンテナを全部止める
docker stop $(docker ps -q)
# 止まっている(exited の)コンテナだけ消す
docker rm $(docker ps -aq --filter status=exited)
# 名前に web を含むコンテナだけ止める
docker stop $(docker ps -q --filter name=web)
対象が1つもないと、docker stop に何も渡りません。手元で引数なしの docker stop を打つと、次のように出ました。
"docker stop" requires at least 1 argument.
See 'docker stop --help'.
エラーに見えますが、消すものが無かっただけです。
止まったコンテナを消すだけなら docker container prune でも足ります。--filter で条件を付けたいときは、上の書き方のほうが細かく選べます。
--formatで一覧を見やすくする
docker ps の既定の表示は列が多く、ターミナルの幅が狭いと折り返して読みにくくなります。--format で必要な列だけにできます。
# 名前・状態・ポートだけを表で
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
# イメージを「名前:タグ サイズ」で
docker images --format '{{.Repository}}:{{.Tag}} {{.Size}}'
# JSON で出して、ほかのツールに渡す
docker ps --format json
table を先頭に付けると、列の見出し付きの表になります。付けなければ、見出しなしで1行ずつ出ます。
毎回打つのが面倒なら、~/.docker/config.json に "psFormat" として書いておくと、docker ps の既定の表示を変えられます。
--filterで探す
--filter(-f)は、一覧系のコマンドで条件に合うものだけを出すオプションです。
| 書き方 | 何が出るか | 使う場面 |
|---|---|---|
docker ps -a -f status=exited | 止まったコンテナ | 掃除の前の確認 |
docker ps -f name=db | 名前に db を含むコンテナ | 似た名前が並ぶとき |
docker ps -f publish=8080 | 8080番を公開しているコンテナ | ポートの重複を探す |
docker images -f dangling=true | タグのないイメージ | ビルドを繰り返したあと |
docker volume ls -f dangling=true | どのコンテナも使っていないボリューム | 消す前の確認 |
-f publish=8080 は、後半の「port is already allocated」が出たときに、どのコンテナがポートを握っているかを1行で探せます。
新旧の書き方:docker psとdocker container ls
DockerのコマンドはDocker 1.13で「対象 動詞」で書く形に整理され、古い書き方も別名として残っています。
ネットで調べると両方の書き方が混ざって出てくるので、対応を知っておくと迷いません。
| 昔からの書き方 | 対象 動詞の書き方 | 何をするか |
|---|---|---|
docker ps | docker container ls | コンテナを一覧 |
docker rm | docker container rm | コンテナを削除 |
docker logs | docker container logs | ログを見る |
docker exec | docker container exec | 中でコマンド実行 |
docker images | docker image ls | イメージを一覧 |
docker rmi | docker image rm | イメージを削除 |
docker build | docker image build | イメージを作る |
どちらを使っても動作は同じです。手元の docker --help でも、run・exec・ps・build などは「Common Commands」に、container・image・volume などは「Management Commands」に分けて並んでいます。
使い分けの目安は単純です。手で打つなら短い昔の書き方、スクリプトや手順書に残すなら対象が読み取れる新しい書き方にすると、あとから読む人が迷いません。
docker volume と docker network には昔の短い書き方がありません。ボリュームとネットワークは最初から「対象 動詞」で書きます。
よく間違えるオプション5つ(-it・-d・--rm・-p・-v)
コマンドそのものより、オプションの意味の取り違えで時間を溶かすことのほうが多いものです。
ここでは、docker run で付ける頻度が高く、しかも意味を取り違えやすい5つを並べます。どれも手元の docker run --help の説明と照らし合わせて書いています。
-itは2つのオプションの組み合わせ
-it は1つのオプションではなく、-i と -t をまとめて書いたものです。
| オプション | 意味(ヘルプの説明) | 外すとどうなるか |
|---|---|---|
-i | 入力を開いたままにする(Keep STDIN open) | 打った文字がコンテナに届かない |
-t | 疑似端末を割り当てる(Allocate a pseudo-TTY) | プロンプトが出ず、表示が崩れる |
シェルで対話したいときは両方要るので -it で覚えておけば足ります。
逆に、スクリプトからパイプで入力を流し込むときは -t を付けると the input device is not a TTY で止まることがあります。そのときは -i だけにします。
-dと--rmは「あとで何が残るか」が違う
-d はコンテナを裏で動かすオプション、--rm は終了したときにコンテナを自動で消すオプションです。
-d で起動すると、ターミナルにはコンテナIDが1行出るだけでログは表示されません。動いているかどうかは docker ps、ログは docker logs -f で見ます。「起動したのに何も出ない」は、-d を付けた結果としては正常です。
--rm の説明は、手元のヘルプでは「Automatically remove the container and its associated anonymous volumes when it exits」です。コンテナと一緒に匿名ボリュームも消えます。
困るのは、--rm 付きで起動したアプリがすぐ落ちたときです。コンテナごと消えるので docker logs で原因を見られません。原因を調べたいときは --rm を外して起動し直します。
-pは「Mac側:コンテナ側」の順
-p 8080:80 は「Mac(ホスト)の8080番を、コンテナの80番につなぐ」という意味です。左がホスト、右がコンテナです。
Dockerのポート公開の説明でも、-p 8080:80 は「Map port 8080 on the Docker host to TCP port 80 in the container」です。ブラウザで開くのは http://localhost:8080 です。
-p 8080:80
Macの8080番 → コンテナの80番。全部のネットワークから届く
-p 127.0.0.1:8080:80
同じつなぎ方で、届くのはそのMacの中からだけ
IPを書かない -p 8080:80 は、ホストのすべてのアドレスに公開されます。ドキュメントの注意書きは「Publishing container ports is insecure by default」です。同じネットワークの他の機械からも届きます。
開発用のDBや管理画面のように、自分のMacから見えれば十分なものは 127.0.0.1: を付けておくと安心です。ポートとbridgeネットワークの関係はネットワークとポートの記事で図にしています。
-vと--mountは「ないフォルダ」の扱いが違う
-v と --mount は、どちらもフォルダやボリュームをコンテナにつなぐオプションです。違いが出るのは、つなぐ先のフォルダがMac側にないときです。
| 書き方 | Mac側にフォルダがないとき | 書き方の例 |
|---|---|---|
-v | フォルダを自動で作る | -v "$(pwd)"/src:/app |
--mount | エラーで止まる | --mount type=bind,src="$(pwd)"/src,dst=/app |
Dockerのバインドマウントの説明は「In general, --mount is preferred」としています。理由は、より明示的で、すべてのオプションに対応しているからです。
-v の自動作成は親切に見えて、パスを打ち間違えたときに空のフォルダが作られ、「ファイルがコンテナから見えない」と悩む原因になります。--mount なら、打ち間違いはその場でエラーとして見つかります。
もう1つの落とし穴は、-v の左側の書き方です。/ や . で始まるとMacのフォルダ(バインドマウント)、db-data のように名前だけだと名前付きボリュームとして扱われます。Macの ./data フォルダをつなぐつもりで -v data:/app と書くと、フォルダではなく data という名前のボリュームが新しく作られます。
オプションはイメージ名より前に書く
docker run の形は docker run [OPTIONS] IMAGE [COMMAND] [ARG...] です。イメージ名より後ろに書いたものは、コンテナの中で動かすコマンドの引数として渡されます。
# 正しい:-p は docker run のオプションとして効く
docker run -d -p 8080:80 nginx:1.27
# 間違い:-p 8080:80 が nginx の引数として渡され、ポートは公開されない
docker run -d nginx:1.27 -p 8080:80
エラーにならずに起動してしまうことがあるので、「ポートを付けたのにつながらない」ときは、まずオプションの位置を見直します。
うまく動かないときの確認コマンド
コマンドを打って最初に出るエラーは、だいたい決まった数種類です。
ここでは、メッセージの決め手になる言葉と、確認に打つコマンドを対応させておきます。原因の深掘りが必要なものは、各記事へ送ります。
Cannot connect to the Docker daemonと出たとき
どの docker コマンドを打っても Cannot connect to the Docker daemon と出るなら、Dockerの本体(デーモン)が動いていません。
この記事を書いている最中、手元で docker info を打ったら、同じメッセージが出ました。
Cannot connect to the Docker daemon at unix:///Users/(ユーザー名)/.rd/docker.sock. Is the docker daemon running?
Rancher DesktopやDocker Desktopを起動していないときに出るメッセージで、アプリを起動すれば直ります。Linuxなら sudo systemctl start docker です。
一方で、docker --help や docker compose config はデーモンが止まっていても動きました。ヘルプで書き方を調べる、ymlの書き間違いを探す、といった作業はDockerを起動しなくてもできます。
docker versionとdocker context lsで接続先を確かめる
アプリは起動しているのに Cannot connect が消えないときは、docker コマンドがどこにつなごうとしているかを見ます。
docker version は、手元のクライアントと、つながった先のサーバーの版を両方出すコマンドです。デーモンが止まっていた手元のMacでは、クライアントの情報だけが出て、最後にエラーが付きました。
Client:
Version: 27.4.1-rd
API version: 1.47
Go version: go1.22.10
Git commit: 1707ac7
Built: Wed Dec 18 18:47:41 2024
OS/Arch: darwin/arm64
Context: rancher-desktop
Cannot connect to the Docker daemon at unix:///Users/(ユーザー名)/.rd/docker.sock. Is the docker daemon running?
Client: が出て Server: が出ないなら、コマンドは入っていて、つなぐ先が動いていない状態です。Context: の行が、いまつなごうとしている先の名前です。
Docker DesktopとRancher Desktopを入れ替えたあとは、つなぐ先の設定(コンテキスト)が古いまま残っていることがあります。一覧は docker context ls で見られます。
NAME DESCRIPTION DOCKER ENDPOINT ERROR
default Current DOCKER_HOST based configuration unix:///var/run/docker.sock
rancher-desktop * Rancher Desktop moby context unix:///Users/(ユーザー名)/.rd/docker.sock
* が付いているのが今使っているコンテキストです。切り替えるときは docker context use default のように名前を指定します。
port is already allocated・名前の重複と出たとき
次によく見るのは、ポートと名前の重複です。
| メッセージに含まれる言葉 | 原因 | 確認するコマンド |
|---|---|---|
port is already allocated | 同じポートを別のコンテナが使っている | docker ps(PORTS列を見る) |
address already in use | Mac側の別のアプリがポートを使っている | lsof -i :8080 |
is already in use by container | 同じ名前のコンテナが残っている | docker ps -a |
requires exactly 1 argument | ビルドのフォルダ(.)などを書き忘れ | docker build --help |
exec: "bash": executable file not found | イメージにbashがない | docker exec -it コンテナ sh |
ポートが重なったら、-p 8081:80 のようにMac側の番号だけ変えれば起動できます。コンテナ側の80番は変える必要がありません。
ポート周りでつながらない原因の切り分けはネットワークとポートの記事、コンテナが起動しないときの全体の確認手順はDocker入門にまとめています。
よくある質問
Dockerコマンドについて、調べるときによく出てくる疑問をまとめました。新旧の書き方、Composeの書き方、危ないオプションの3つが中心です。手順の細かい点は、各見出しの本文もあわせて確認してください。
Q1. docker psとdocker container lsは何が違いますか?
A1. 同じコマンドです。手元の docker ps --help でも、docker container ls・docker container list・docker container ps が別名として並んでいます。手で打つなら短い docker ps、手順書に残すなら対象が読み取れる docker container ls にすると、あとから読む人が迷いません。
Q2. docker-composeとdocker composeはどちらを使えばいいですか?
A2. docker compose(スペース区切り)を使います。ハイフン付きの docker-compose はCompose v1の書き方で、Docker社は2023年6月でv1のサポートを終えると告知しました。多くはハイフンをスペースに変えるだけで動きますが、v2ではコンテナ名の区切りが _ から - に変わっています。
Q3. 止まっているコンテナも含めて一覧を出すには?
A3. docker ps -a です。docker ps だけでは動いているコンテナしか出ません。名前の重複でエラーになったのに一覧に見当たらないときは、止まったコンテナが残っているので -a で探してください。
Q4. docker run -itの-iと-tは何の意味ですか?
A4. -i は入力を開いたままにする、-t は疑似端末を割り当てるオプションです。シェルで対話するには両方必要なので -it とまとめて書きます。パイプで入力を流し込むスクリプトでは -t を外し、-i だけにします。
Q5. -p 8080:80はどちらがホスト側のポートですか?
A5. 左の8080がホスト(Mac)側、右の80がコンテナ側です。ブラウザでは http://localhost:8080 を開きます。IPを書かないとすべてのアドレスに公開されるので、自分のMacからだけ使うなら -p 127.0.0.1:8080:80 と書きます。
Q6. docker system prune -a --volumesを実行するとDBのデータは消えますか?
A6. 手元の27.4.1では、--volumes で消えるのは使われていない匿名ボリュームで、名前付きボリュームは残ります。ただし匿名ボリュームにDBのデータを置いていれば消えます。docker compose down -v はcompose.yamlに書いた名前付きボリュームも消すので、DBのデータを残したいときは付けません。
Q7. Dockerを再起動するコマンドは?
A7. コンテナなら docker restart コンテナ、Composeのサービスなら docker compose restart サービス です。Docker本体を再起動したいときは、Linuxなら sudo systemctl restart docker、MacやWindowsならDocker Desktopなどのアプリを終了して起動し直します。
Q8. コマンドの正しい書き方を手元で確かめるには?
A8. docker コマンド --help で、オプションと別名の一覧が出ます(例: docker run --help、docker compose up --help)。デーモンが止まっていても表示できるので、Dockerを起動する前に書き方だけ確かめたいときにも使えます。
Dockerコマンドを覚える次の一歩
Dockerのコマンドは数が多く見えますが、毎日打つのは冒頭の10個で、残りは「対象 動詞」の組み合わせで引けば足ります。
覚え方のコツは、状態の流れ(作る → 動かす → 止める → 消す)を頭に入れておくことです。あわせて、消えるものの範囲(stop は残す、rm は消す、-v はデータまで消す)も一緒に覚えます。オプションでは -p の左がホスト、--rm と -v で何が消えるか、の2点を押さえておくと、つながらない・消えたの事故を防ぎやすくなります。
コマンドの全体像が見えたら、自分のプロジェクトで実際に使う組み合わせを決めていく段階です。続きの記事は、動かしたいものによって分かれます。
- Javaのアプリ:DockerでJava環境構築
- Python:DockerでPython環境構築
- Tomcat:TomcatをDockerで起動する手順
Dockerを起動していなくても動きます。ポートの左右やボリューム名の付き方が、そのまま目で確かめられます。
続きを追う:X(@Tom_Java_Tech) / RSS
途中経過は、また書きます。

