容器与云原生 / 系统课时

Bind Mount 怎样挂载本地配置

Bind Mount 怎样挂载本地配置

开发时经常希望容器直接读取宿主机上的配置、源码或脚本,而不是每次改动都重新构建镜像。本课用一个最小 Compose 项目演示 Bind Mount 的写法、只读挂载方式,以及宿主路径不存在时最容易踩到的坑。

学习目标

  • 能用 Compose 的 Bind Mount 把宿主机文件挂载到容器指定路径
  • 理解相对路径、只读挂载与宿主文件变化之间的关系
  • 能避免“源文件不存在却被创建成目录”的典型问题

Bind Mount 映射的是什么

Bind Mount 不是把文件复制进容器,而是把宿主机上的某个文件或目录映射到容器路径。容器访问目标路径时,实际读写的是宿主机对象,因此很适合开发代码、可频繁修改的配置和运维脚本。

相对源路径如 ./config/app.conf 在本地 Compose 场景中按 Compose 文件所在目录解析。配置文件通常还应设为只读,避免容器意外改写宿主配置。

Bind Mount 从宿主路径映射到容器路径

用长语法挂载一个配置文件

先创建如下 compose.yaml。这里使用长语法,因为它能明确指定挂载类型、只读属性,并通过 create_host_path: false 阻止 Compose 在源路径不存在时自动创建目录。

yaml
services:
  app:
    image: alpine:3.20
    command: ["sh", "-c", "while true; do sleep 3600; done"]
    volumes:
      - type: bind
        source: ./config/app.conf
        target: /etc/demo/app.conf
        read_only: true
        bind:
          create_host_path: false

在 compose.yaml 同级目录执行:

bash
mkdir -p config
printf 'mode=development\n' > config/app.conf
docker compose up -d >/dev/null 2>&1
docker compose exec app cat /etc/demo/app.conf

预期输出:

text
mode=development

这说明容器中的 /etc/demo/app.conf 正在读取宿主机的 config/app.conf。此时在宿主机修改文件内容,再次执行 cat 就会读取到新内容,不需要重新构建镜像。

源路径不存在时为什么容易出错

短语法也可以写成 ./config/app.conf:/etc/demo/app.conf:ro,但对 Bind Mount 来说,短语法为了兼容旧行为,会在宿主源路径不存在时创建目录。如果你原本想挂载“文件”,最终却得到一个同名目录,应用常会报“不是文件”或挂载类型不匹配。

使用前面的长语法并设置 create_host_path: false,源路径写错时会直接失败,更适合配置文件这类必须真实存在的输入。可以先验证文件,再启动服务:

bash
test -f ./config/app.conf && docker compose config --quiet && echo ready

预期输出:

text
ready

如果没有输出,先检查当前目录、文件名和 Compose 文件位置,不要先去修改容器内部路径。

什么时候适合用 Bind Mount

开发环境需要热改源码、配置或脚本时,Bind Mount 最直接;生产环境若希望部署内容不可被宿主机随意修改,通常更适合把应用代码构建进镜像,再只挂载真正需要外置的配置或数据。对于数据库业务数据,则优先考虑命名 Volume,让数据生命周期与具体宿主路径解耦。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Bind Mount 怎样挂载本地配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通