Docker Compose 如何挂载宿主机的配置文件到容器内部

在 Docker Compose 中挂载宿主机配置文件到容器，最推荐的方式是在 docker-compose.yml 的 volumes 配置项中直接指定宿主机文件路径与容器内路径的映射，适合需要持久化配置、便于宿主机直接编辑的场景。

先说结论：通过 docker-compose.yml 的 volumes 字段将宿主机配置文件挂载到容器对应路径，修改宿主机文件后容器内可同步生效，但需注意编辑工具可能改变文件 Inode 导致同步失效。

命令速用版

在 docker-compose.yml 中添加 volumes 配置，示例如下：

version: '3'
services:
  myapp:
    image: nginx:latest
    volumes:
      - ./config/nginx.conf:/etc/nginx/nginx.conf
      - ./data:/var/www/html

启动容器：

docker-compose up -d

如果只需临时测试，也可用 docker run 命令直接挂载：

docker run -d -v /path/on/host:/path/in/container image_name

Docker 挂载的本质是将宿主机的文件或目录映射到容器文件系统中的一个位置。从容器内部看，这些文件就像本地存在一样，但实际数据存储在宿主机上。

这里有个关键细节：当你在宿主机用 vim、vi 等编辑器修改文件时，某些编辑器会先创建临时文件、修改后替换原文件，这个过程会改变文件的 Inode。而容器内挂载的文件仍指向原来的 Inode，导致容器内看不到最新内容。

简单来说，挂载的是文件的「位置引用」而非「文件内容」。如果宿主机上的文件被删除重建（Inode 改变），容器内的引用就会失效。

第一步：准备配置文件

在宿主机创建或确认配置文件路径，例如：

mkdir -p ./config
cp nginx.conf ./config/

第二步：编写 docker-compose.yml

在 volumes 中指定宿主机文件与容器内路径的映射：

services:
  web:
    image: nginx:latest
    volumes:
      - ./config/nginx.conf:/etc/nginx/nginx.conf

注意：挂载单个文件时，宿主机文件必须预先存在，否则 Docker 会将其创建为目录。

第三步：启动或重启容器

docker-compose up -d

如果容器已在运行，修改配置后需要重启容器使新配置生效：

docker-compose restart

第四步：检查权限

确保宿主机文件权限允许容器内进程读取，必要时调整：

chmod 644 ./config/nginx.conf

方法一：进入容器查看文件

docker-compose exec web cat /etc/nginx/nginx.conf

对比输出内容与宿主机文件是否一致。

方法二：检查文件 Inode

在宿主机和容器内分别执行：

ls -i ./config/nginx.conf
docker-compose exec web ls -i /etc/nginx/nginx.conf

正常情况下 Inode 号码应相同。如果修改文件后 Inode 改变，说明编辑器替换了原文件。

方法三：验证服务行为

修改配置文件后，观察容器内服务是否按新配置运行。例如修改 Nginx 端口后，检查容器是否监听新端口。

坑一：编辑器改变 Inode

vim 默认编辑时会创建临时文件并替换原文件，导致 Inode 改变。解决方法是在 ~/.vimrc 中添加：

set backupcopy=yes
set noswapfile

或使用不改变 Inode 的工具如 cat、tee、echo 直接写入文件内容。

坑二：挂载文件变成目录

如果宿主机上的配置文件不存在，Docker 会将挂载点创建为目录而非文件。务必先创建好宿主机文件再启动容器。

坑三：权限问题

容器内进程可能因权限不足无法读取挂载的配置文件。检查宿主机文件权限，必要时调整所有者或权限模式。

坑四：配置覆盖

挂载配置文件会覆盖容器内原有路径的内容。如果容器镜像中该路径有重要文件，挂载后会被宿主机文件替换，需提前备份或确认。

坑五：修改后未重启

部分服务读取配置后不会自动重载，修改配置文件后需要重启容器或发送重载信号。