您在容器中启动数据库，添加一些数据，删除容器并启动一个新容器。数据没了。几乎每个人都经历过惨痛的教训才学到这一课。 Docker 卷 和绑定挂载的存在是为了在任何一个容器的生命周期之外保持数据的活动。

本指南解释了每种方法的工作原理以及如何选择。这里的命令和文件是标准示例，基于 Docker 记录的行为，我们没有在本文中运行它们，因此请首先在一次性数据上尝试它们。 Docker 版本之间和 Docker Desktop 上的详细信息可能有所不同。如果您不熟悉容器，请从我们的 Docker 初学者教程 开始。

为什么容器数据会消失

Docker 镜像由只读层组成。当容器启动时，Docker 在顶部添加一个薄的可写层，任何更改都在那里。该层在停止和重新启动后仍然存在，但在删除容器时会被删除。

docker run -d --name db -e POSTGRES_PASSWORD=devonly postgres:17
# ... create tables and add data ...
docker rm -f db
docker run -d --name db -e POSTGRES_PASSWORD=devonly postgres:17
# The data you added is not there

这是设计使然，因为它可以让您自由更换容器。这确实意味着您需要保留的任何东西都必须位于容器之外。有三种方法可以做到这一点：

Docker 卷与并排绑定安装

命名卷

卷是由 Docker 创建和管理的存储。您可以通过名称来引用它，而无需关心它的实际位置。

docker volume create pgdata

docker run -d --name db \
  -e POSTGRES_PASSWORD=devonly \
  -v pgdata:/var/lib/postgresql/data \
  postgres:17

现在数据库文件位于 pgdata 中。删除容器并启动一个具有相同卷的新容器，您的数据仍将存在。在 Linux 上，卷通常位于 /var/lib/docker/volumes/ 下，但您不应直接编辑这些文件。在 Docker Desktop 上，它们位于虚拟机内，而不是普通文件夹中。

容器内的路径取决于图像，因此请检查图像的文档。安装到错误的路径是一个典型的错误：一切似乎都正常，但数据仍在写入容器层。映像的较新主要版本也可能会更改此路径，因此在升级之前请阅读发行说明。

如果命名卷不存在，Docker 会自动创建。没有名称创建的匿名卷也可以工作，但它有一个很长的随机ID，并且很容易丢失。始终为您的卷命名。

绑定坐骑

绑定挂载将特定主机路径直接映射到容器中。双方立即看到相同的文件。这使得它非常适合开发，因为编辑器中的编辑会在正在运行的容器中生效，而无需重建：

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

编辑site/中的文件，刷新浏览器，您将看到更改。 :ro使挂载在容器内只读，当容器不需要在那里写入时，这是一个好习惯。

绑定安装需要一些权衡：

• 它们将您与主机联系起来。 该路径必须存在于每台计算机上，因此设置的可移植性较差。
• 它们隐藏图像的内容。如果您安装在/app之上，则图像中的任何内容都会变得不可见。一个常见的例子是 node_modules 失踪。
• 它们暴露主机。具有可写挂载的容器可以更改或删除真实的主机文件。除非您完全了解风险，否则切勿安装 / 或 Docker 套接字等敏感路径。
• 性能可能会有所不同。 在适用于 macOS 和 Windows 的 Docker Desktop 上，文件共享跨越虚拟化边界，并且可能比 Linux 上慢。

tmpfs 挂载

tmpfs 挂载存在于主机内存中，并且永远不会写入容器层。当容器停止时它就会消失，因此它适合临时文件、缓存和短暂的敏感数据：

docker run -d --tmpfs /app/cache:size=64m myapp:1.0

tmpfs 可在 Linux 主机上使用。它还可以加快一次性测试环境中的数据库速度，在这种环境中您不关心保存数据。

-v 或 –mount？

两个标志都有效。 --mount 更长，但更明确，很多人更喜欢在脚本中使用它：

# Short form
docker run -v pgdata:/var/lib/postgresql/data postgres:17

# Explicit form
docker run --mount type=volume,source=pgdata,target=/var/lib/postgresql/data postgres:17

# Bind mount, read-only
docker run --mount type=bind,source="$(pwd)"/site,target=/usr/share/nginx/html,readonly nginx:1.27

有一个有意义的区别。使用 -v，会为您创建一个缺失的主机路径作为一个空文件夹，这可以隐藏拼写错误。使用 --mount 和绑定类型，Docker 会报告错误。另外，对于-v，左侧决定类型：名称表示卷，路径表示绑定安装。所以-v data:/x和-v ./data:/x做了非常不同的事情。

Docker Compose 中的卷

大多数实际项目都在 Compose 文件中声明存储。这个使用了两种类型，每种都有其正确的工作：

services:
  web:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - ./src:/app/src      # bind mount: live code
    depends_on:
      - db

  db:
    image: postgres:17
    environment:
      POSTGRES_PASSWORD: devonly
    volumes:
      - pgdata:/var/lib/postgresql/data   # named volume: data

volumes:
  pgdata:

命名卷必须在顶级 volumes 部分中声明。 Compose 在实际名称前加上项目名称作为前缀。请参阅我们的 Docker Compose 教程 以获取完整的演练。

有用的音量命令

在确认之前请检查 prune 将删除哪些内容，因为此操作无法撤消。当前没有容器使用的卷可能仍保存重要数据。

备份和恢复卷

可以通过运行安装卷和主机文件夹的短期容器来备份卷：

# Back up
docker run --rm \
  -v pgdata:/data:ro \
  -v "$(pwd)":/backup \
  alpine tar czf /backup/pgdata.tar.gz -C /data .

# Restore into a new volume
docker volume create pgdata_restored
docker run --rm \
  -v pgdata_restored:/data \
  -v "$(pwd)":/backup \
  alpine tar xzf /backup/pgdata.tar.gz -C /data

对于实时数据库，像这样复制文件可以捕获不一致的状态。首先停止容器，或者更好地使用数据库自​​己的工具，例如 PostgreSQL 的 pg_dump。而您从未恢复过的备份实际上只是一个希望，因此请测试恢复。

文件权限

“权限被拒绝”是安装时最常见的问题。文件在 Linux 上保留其数字用户和组 ID，因此如果容器以用户 1000 运行并且主机文件夹属于另一个用户，写入将会失败。解决这个问题的一些方法：

• 使用匹配的用户运行容器：docker run --user "$(id -u):$(id -g)" ...
• 按照我们的 Dockerfile 最佳实践 中所述，在映像中设置正确的所有权。
• 首选数据命名卷，因为新卷在首次使用时将承担图像文件夹的所有权。
• 在使用 SELinux 的系统上，绑定挂载可能需要 :z 或 :Z 标签。

避免 chmod 777 的诱惑，正如我们的 Linux 命令指南 所解释的那样。

你应该使用哪个？

最后一行很重要。在生产中，代码属于映像，因此您测试的就是您运行的。在集群中，数据存储的工作方式再次不同，通过持久卷，这在更广泛的 Kubernetes 文档中进行了介绍。我们的 Docker 与 Kubernetes 指南解释了两者之间的关系。

常见错误

• 挂载到错误的路径。数据仍然存在于容器层中，稍后就会消失。
• 随意运行down -v。这将删除您的命名卷。
• 将相对路径与 -v. 等形式一起使用 -v data:/x 创建卷而不是文件夹映射。
• 将机密放入可写绑定挂载中。 将它们挂载为只读，或使用机密功能。
• 将两个数据库容器指向一个卷。这可能会损坏数据。
• 没有备份。 卷不是备份。它位于同一个磁盘上。

最后的话

经验法则很简短：命名卷用于数据，绑定挂载用于您正在编辑的代码，tmpfs 用于不应该持久的东西。在一次性数据库上尝试一下。创建一个命名卷，添加一行，删除容器，启动一个新容器，然后确认您的行仍然存在。然后在需要之前练习备份和恢复。

常见问题

继续学习