docker run の引数を徹底解説：実行結果で学ぶ使い方

docker run は最もよく使われ、引数も最も多い Docker コマンドです。基本形式は次のとおりです。

docker run [引数] イメージ[:tag] [コマンド] [コマンドの引数]

イメージ名の後の部分は、イメージのデフォルトコマンド（CMD）を置き換えます。

$ docker run --rm alpine:3.23 cat /etc/alpine-release
3.23.6

--rm は Docker に渡す引数です。cat /etc/alpine-release はコンテナ内で実行するコマンドで、alpine のデフォルトの /bin/sh を置き換えます。

引数は必ずイメージ名より前に書く

イメージ名の後に書いたものはすべて、コンテナ内のコマンドとして扱われます。

$ docker run alpine:3.23 --rm echo hi
docker: Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: exec: "--rm": executable file not found in $PATH

Run 'docker run --help' for more information

Docker はコンテナ内で --rm という名前のプログラムを実行しようとしますが、当然見つかりません（executable file not found）。このエラーが表示されたら、まず引数の位置を確認してください。

実行モード

docker run -it --rm ubuntu:26.04 bash      # 対話型で入り、終了後に自動削除
docker run -d --name cache redis:8-alpine  # バックグラウンドサービス

-it は対話型シェルに入るため、ほとんどの場合セットで使います。-i だけを使うと、パイプでデータをコンテナに渡せます。

$ echo "hello" | docker run -i --rm alpine:3.23 cat
hello

ポート：-p

形式は -p ホストのポート:コンテナのポート です。次の 3 つの書き方を実際の結果で比較します。

$ docker run -d --name p1 -p 8080:80 nginx:1.30
27b89a4fae92dfe05bf051e11700033c7b9bb71f8747acc986d2a535cc1baa00

$ docker run -d --name p2 -p 127.0.0.1:8081:80 nginx:1.30
3327f3c1df4fa1e03fa3a120e5d889859fc0cb53d0aaf269826c81b25f4411c2

$ docker run -d --name p3 -P nginx:1.30
57c9a309c4758786361738b7b9a4231f404cb9bbab28f38cad39b4b6e996d9e0

$ docker port p1
80/tcp -> 0.0.0.0:8080
80/tcp -> [::]:8080

$ docker port p2
80/tcp -> 127.0.0.1:8081

$ docker port p3
80/tcp -> 0.0.0.0:32768
80/tcp -> [::]:32768

docker port コンテナ名 で実際のポート割り当てを確認できます。UDP ポートは -p 5353:53/udp のように指定します。

-p 8080:80 をクラウドホストで使うと、外部から直接接続できるようになります。また、Docker はファイアウォールルールを自動的に書き換えるため、ufw の設定では遮断できない場合があります。データベースなど外部公開すべきでないサービスは、127.0.0.1 にバインドするか、-p を使わずにカスタムネットワークでコンテナ同士を接続してください。

データ：-v と --mount

-v ホストのパス:コンテナのパス を使うと、ホスト上のフォルダーをコンテナにマウントできます（bind mount）。site フォルダーを用意し、その中に index.html を置きます。

$ ls site
index.html

$ docker run -d --name site -p 8080:80 -v "$(pwd)/site:/usr/share/nginx/html:ro" nginx:1.30
e91f46b91ff8f0f64d59d6605bfddea0ee5bca809de86d81cbd5051815e65dd1

$ curl -s http://localhost:8080 | head -n 3
<!doctype html>
<html><head><meta charset="utf-8"><title>My site</title>
<style>body{font-family:system-ui,sans-serif;max-width:640px;margin:60px auto;padding:0 16px;color:#1f2937}h1{color:#1d63ed}</style></head>

Windows での書き方（タブをクリックして切り替えます）：

docker run -d --name site -p 8080:80 -v "$(pwd)/site:/usr/share/nginx/html:ro" nginx:1.30

docker run -d --name site -p 8080:80 -v "${PWD}/site:/usr/share/nginx/html:ro" nginx:1.30

docker run -d --name site -p 8080:80 -v "%cd%/site:/usr/share/nginx/html:ro" nginx:1.30

末尾の :ro は読み取り専用を意味します。コンテナ内からこのフォルダーに書き込もうとすると拒否されます。

$ docker exec site sh -c "echo test > /usr/share/nginx/html/x.txt"
sh: 1: cannot create /usr/share/nginx/html/x.txt: Read-only file system

もう 1 つのマウント方法は、Docker が管理する Volume（-v 名前:コンテナのパス）を使う方法です。データベースなどのデータ保存に適しています。

docker run -d -v pgdata:/var/lib/postgresql postgres:18

--mount はより長く、明確に書く方法です。両者の違いや使い分けについては、Volume と Bind Mountを参照してください。

環境変数：-e と --env-file

$ docker run --rm -e GREETING=hello -e APP_ENV=dev alpine:3.23 env
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=18f035817c43
GREETING=hello
APP_ENV=dev
HOME=/root

-e 変数名（値を指定しない場合）は、ホスト上にある同名の環境変数の現在値を引き継ぎます。

$ APP_ENV=prod docker run --rm -e APP_ENV alpine:3.23 sh -c 'echo $APP_ENV'
prod

変数が多い場合は --env-file ファイル を使います。詳しくは環境変数と .env ファイルを参照してください。

ネットワーク

同じカスタムネットワーク内のコンテナは、コンテナ名を使って相互に接続できます。

$ docker network create mynet
2ecd542737519b0b8919061077814e007a72e2d07973f0840608b1b5454c678e

$ docker run -d --name myweb --network mynet nginx:1.30
9a6ca3dca3a003e28b9870f3eec436cf7023a6872e8ddd4cee971d29f845583b

$ docker run --rm --network mynet alpine:3.23 ping -c 2 myweb
PING myweb (172.19.0.2): 56 data bytes
64 bytes from 172.19.0.2: seq=0 ttl=64 time=0.094 ms
64 bytes from 172.19.0.2: seq=1 ttl=64 time=0.064 ms

--- myweb ping statistics ---
2 packets transmitted, 2 packets received, 0% packet loss
round-trip min/avg/max = 0.064/0.079/0.094 ms

$ docker run --rm alpine:3.23 ping -c 1 -W 2 myweb
ping: bad address 'myweb'

• 1つ目の ping コンテナは mynet 内にあり、myweb は Docker 内蔵 DNS によって 172.19.0.2 に名前解決されます。
• 2つ目は --network を指定していないため、デフォルトネットワークにあり、myweb を見つけられません（bad address）。

コンテナ名には web や app のような、トップレベルドメイン（TLD）と同じ単語を使わないでください。同じネットワークに参加していない場合、このような名前は外部 DNS によって奇妙なアドレス（例：127.0.53.53）に名前解決され、デバッグがさらに難しくなります。

docker run --network host nginx:1.30     # ホストネットワークを直接使用（Linux）
docker run --network none alpine:3.23    # ネットワークなし

詳しくはネットワークとコンテナの接続を参照してください。

再起動ポリシー

docker run -d --restart unless-stopped nginx:1.30

使用できる値は no、on-failure、always、unless-stopped です。実際の動作についてはコンテナのライフサイクルを参照してください。

リソース制限

$ docker run -d --name limited --memory 64m --cpus 0.5 nginx:1.30
2e65ce89f346cb7d9d57f1e6ad529d63ad53d1d914b6d3178dc3344a1d3325f0

$ docker stats --no-stream limited
CONTAINER ID   NAME      CPU %     MEM USAGE / LIMIT   MEM %     NET I/O       BLOCK I/O         PIDS
2e65ce89f346   limited   0.00%     3.922MiB / 64MiB    6.13%     736B / 126B   1.77MB / 8.19kB   2

MEM USAGE / LIMIT は 3.922MiB / 64MiB と表示され、メモリ上限が適用されています。nginx のアイドル時の使用量は 4 MB 未満です。

メモリ上限を超えたときの実際の動作については、ログの確認とデバッグの OOM の例を参照してください。

イメージのデフォルト値を上書きする

$ docker run --rm --entrypoint sh nginx:1.30 -c "nginx -v; whoami"
nginx version: nginx/1.30.5
root

$ docker run --rm -u 1000:1000 alpine:3.23 id
uid=1000 gid=1000 groups=1000

$ docker run --rm -w /tmp alpine:3.23 pwd
/tmp

$ docker run --rm -h myhost alpine:3.23 hostname
myhost

-u は、コンテナが生成するファイルの所有者を root ではなく自分にするためによく使います。

docker run --rm -u "$(id -u):$(id -g)" -v "$(pwd):/work" -w /work node:24-alpine npm install

読み取り専用ファイルシステム

$ docker run --rm --read-only alpine:3.23 touch /hello
touch: /hello: Read-only file system

--read-only を指定すると、コンテナのファイルシステム全体が読み取り専用になり、プログラムが侵入されてもファイルを変更できません。書き込みが必要な場所には --tmpfs /tmp または Volume を使って書き込みを許可してください。詳しくはセキュリティのベストプラクティスを参照してください。

その他の便利なパラメーター

その他のオプション早見表

以下は docker run --help（Docker 29）をもとに、この章では詳しく紹介していないものの、実用的なオプションをまとめたものです。全一覧は docker run --help を実行してください。

よく使う組み合わせの例

# 1. 使い捨てのツールコンテナ：現在のディレクトリでコマンドを実行
docker run --rm -v "$(pwd):/data" -w /data alpine:3.23 ls -la

# 2. ローカル開発用データベース：ローカルからの接続のみ許可
docker run -d --name devdb --restart unless-stopped \
  -p 127.0.0.1:5432:5432 \
  -e POSTGRES_PASSWORD=dev \
  -v devdb:/var/lib/postgresql \
  postgres:18

# 3. 本番サービス：リソースとログサイズを制限
docker run -d --name api --restart unless-stopped \
  --memory 1g --cpus 2 \
  --log-opt max-size=10m --log-opt max-file=3 \
  --env-file .env -p 3000:3000 \
  myorg/api:1.4.2

# 1. 使い捨てのツールコンテナ：現在のディレクトリでコマンドを実行
docker run --rm -v "${PWD}:/data" -w /data alpine:3.23 ls -la

# 2. ローカル開発用データベース：ローカルからの接続のみ許可
docker run -d --name devdb --restart unless-stopped `
  -p 127.0.0.1:5432:5432 `
  -e POSTGRES_PASSWORD=dev `
  -v devdb:/var/lib/postgresql `
  postgres:18

# 3. 本番サービス：リソースとログサイズを制限
docker run -d --name api --restart unless-stopped `
  --memory 1g --cpus 2 `
  --log-opt max-size=10m --log-opt max-file=3 `
  --env-file .env -p 3000:3000 `
  myorg/api:1.4.2

# 1. 使い捨てのツールコンテナ：現在のディレクトリでコマンドを実行
docker run --rm -v "%cd%:/data" -w /data alpine:3.23 ls -la

# 2. ローカル開発用データベース：ローカルからの接続のみ許可
docker run -d --name devdb --restart unless-stopped ^
  -p 127.0.0.1:5432:5432 ^
  -e POSTGRES_PASSWORD=dev ^
  -v devdb:/var/lib/postgresql ^
  postgres:18

# 3. 本番サービス：リソースとログサイズを制限
docker run -d --name api --restart unless-stopped ^
  --memory 1g --cpus 2 ^
  --log-opt max-size=10m --log-opt max-file=3 ^
  --env-file .env -p 3000:3000 ^
  myorg/api:1.4.2

オプションが増えると、コマンドの管理が難しくなります。長時間実行する場合や複数のコンテナを連携させる場合は、Docker Composeを使って設定をファイルに記述することをおすすめします。

まとめ

• オプションはイメージ名の前に記述し、その後ろにはコンテナ内で実行するコマンドを記述します。
• よく使う組み合わせは -d、--rm、--name、-p、-v、-e です。
• --memory、--cpus、--pids-limit でリソースを制限します。
• --entrypoint、-u、-w でイメージのデフォルト値を上書きします。

練習問題

練習 1：バックグラウンドで nginx:1.30-alpine を実行するコマンドを書いてください。名前は site、ローカルからのみ 8080 ポートに接続できるようにし、メモリ上限を 128 MB に設定して、終了後にコンテナを保持しないようにします。

docker run -d --rm --name site -p 127.0.0.1:8080:80 --memory 128m nginx:1.30-alpine

練習 2：postgres:18 イメージの ENTRYPOINT はデータベースを起動します。データベースを起動せずに、その shell だけに入るにはどうすればよいですか？

docker run --rm -it --entrypoint sh postgres:18

更新日 2026年10月14日