docker cp 入門：ホストとコンテナ間でファイルをコピーする方法

docker cp はホストとコンテナの間でファイルをコピーするコマンドです。コンテナの実行中でも停止中でも使えます。

構文

docker cp [オプション] コンテナ:コピー元パス ホスト側のコピー先     # コンテナ → ホスト
docker cp [オプション] ホスト側のコピー元パス コンテナ:コピー先パス   # ホスト → コンテナ

コピー元またはコピー先に - を指定すると、tar 形式で標準入力から読み込んだり、標準出力に出力したりできます。

例

web という名前の nginx コンテナを操作します。

$ docker cp web:/etc/nginx/nginx.conf ./nginx.conf

$ head -n 3 nginx.conf

user  nginx;
worker_processes  auto;

$ echo "<h1>copied in</h1>" > page.html

$ docker cp page.html web:/usr/share/nginx/html/page.html

$ docker exec web cat /usr/share/nginx/html/page.html
<h1>copied in</h1>

$ docker cp web:/etc/nginx/conf.d ./confd

$ ls confd
default.conf

$ docker cp web:/no/such/file .
Error response from daemon: Could not find the file /no/such/file in container web

フォルダーをコピーするときのルール：

• コピー先が存在しない：コピー先フォルダーを作成し、コピー元フォルダーの内容をコピーします（上の例）。
• コピー先がすでに存在する：コピー元フォルダー全体をコピー先に入れ、コピー先/コピー元フォルダー名 という構成にします。
• コピー元パスの末尾に /. を付ける場合（例：web:/etc/nginx/conf.d/.）：フォルダー自体を含めず、内容だけをコピーします。

docker cp を使う場面

適している場面：

• コンテナ内の既定の設定ファイル、ログ、生成されたファイルを取り出す。
• テスト用に一時的なファイルを入れる。
• Windows PowerShell でデータベースをバックアップ、復元する：コンテナ内でファイルにエクスポートしてから docker cp で取り出すと、PowerShell が < に対応していないことや文字コードの問題を避けられます（実際の例はよくあるエラーメッセージを参照）。

適していない場面：

• 開発中にコードを同期する：Bind mount または docker compose watch を使います（Node.js アプリケーションを参照）。
• 保持する必要があるデータ：Volume を使います。

関連する章

• docker exec
• Volume とデータの保持

練習問題

練習：web コンテナ内の nginx のウェルカムページ /usr/share/nginx/html/index.html をホストにコピーし、タイトルを変更してからコンテナに戻します。ブラウザーで確認してください（コンテナは -p 8080:80 を指定して起動する必要があります）。

docker cp web:/usr/share/nginx/html/index.html ./index.html
# エディターで index.html を編集
docker cp ./index.html web:/usr/share/nginx/html/index.html

更新日 2026年10月14日