# Docker cp 命令

[Docker命令大全](/docker/manual/docker-command-manual.md)

`docker cp`

命令用于在 Docker 容器和宿主机之间复制文件或目录，支持从容器到宿主机，或从宿主机到容器的文件复制操作。

### 语法

```shell
docker cp [OPTIONS] SRC_PATH CONTAINER:DEST_PATH
docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH
```

* `SRC_PATH`: 源路径（可以是容器内的路径或宿主机的路径）。
* `CONTAINER`: 容器的名称或 ID。
* `DEST_PATH`: 目标路径（可以是容器内的路径或宿主机的路径）。

**从容器复制文件到宿主机**

例：将容器 my\_container 内的 /path/in/container 文件或目录复制到宿主机的 /path/on/host。

```shell
docker cp my_container:/path/in/container /path/on/host
```

**从宿主机复制文件到容器**

例：将宿主机上的 /path/on/host 文件或目录复制到容器 my\_container 内的 /path/in/container。

```shell
docker cp /path/on/host my_container:/path/in/container
```

**从容器复制目录到宿主机**

例：将容器内的 /path/in/container 目录及其内容复制到宿主机的 /path/on/host。

```shell
docker cp my_container:/path/in/container /path/on/host
```

**从宿主机复制目录到容器**

例：将宿主机上的 /path/on/host 目录及其内容复制到容器 my\_container 内的 /path/in/container。

```shell
docker cp /path/on/host my_container:/path/in/container
```

## 实例

### 容器复制文件到宿主机

启动一个容器并创建一个文件:

```shell
docker run -d --name my_container ubuntu bash -c "echo 'Hello, Docker!' > /hello.txt"
```

从容器复制文件到宿主机，将容器内的 /hello.txt 文件复制到当前宿主机目录下。

```shell
docker cp my_container:/hello.txt ./hello.txt
```

查看复制的文件内容:

```shell
cat hello.txt
```

输出：

```shell
Hello, Docker!
```

### 从宿主机复制文件到容器

复制一个文件到容器，将宿主机上的 hello.txt 文件复制到容器内的 /hello.txt。

```shell
docker cp ./hello.txt my_container:/hello.txt
```

进入容器查看文件内容:

```shell
docker exec -it my_container cat /hello.txt
```

输出：

```shell
Hello, Docker!
```

### 注意事项

* `docker cp` 命令不会修改源文件或目录，它仅进行复制操作。
* 目标路径必须是有效的路径，且宿主机或容器中应有足够的权限进行写入操作。
* 在处理大文件或大目录时，复制操作可能需要一些时间。

`docker cp` 命令是 Docker 提供的一个有用工具，用于在容器和宿主机之间复制文件或目录。这个命令适用于备份、配置更新、日志收集等操作，帮助用户方便地管理和操作容器中的文件。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tuonioooo-notebook.gitbook.io/docker/manual/docker-cp-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.