docker_practice/08_data_network/data/bind-mounts.md

挂载主机目录

本节涵盖了相关内容与详细描述，主要探讨以下几个方面：

什么是绑定挂载

Bind Mount (绑定挂载) 将 宿主机的目录或文件 直接挂载到容器中。容器可以读写宿主机的文件系统。

flowchart LR
    subgraph Host ["宿主机"]
        direction TB
        Dir1["/home/user/code/<br/>├── index.html<br/>├── style.css<br/>└── app.js"]
    end
    
    subgraph Container ["容器"]
        direction TB
        Dir2["/usr/share/nginx/html/<br/>(同一份文件)"]
    end
    
    Dir1 <-->|Bind Mount| Dir2

---

Bind Mount vs Volume

相关信息如下表：

特性	Bind Mount	Volume
数据位置	宿主机任意路径	Docker 管理的目录
路径指定	必须是绝对路径	卷名
可移植性	依赖宿主机路径	更好 (Docker 管理)
性能	依赖宿主机文件系统	优化的存储驱动
适用场景	开发环境、配置文件	生产数据持久化
备份	直接访问文件	需要通过 Docker

概述

总体概述了以下内容。

选择建议

相关信息如下表：

需求	推荐方案
开发时同步代码	Bind Mount
持久化数据库数据	Volume
共享配置文件	Bind Mount
容器间共享数据	Volume
备份方便	Bind Mount (直接访问)
生产环境	Volume

---

基本语法

本节涵盖了相关内容与详细描述，主要探讨以下几个方面：

使用 --mount (推荐)

运行以下命令：

$ docker run -d \
    --mount type=bind,source=/宿主机路径,target=/容器路径 \
    nginx

使用 -v (简写)

运行以下命令：

$ docker run -d \
    -v /宿主机路径:/容器路径 \
    nginx

两种语法对比

相关信息如下表：

特性	--mount	-v
语法	键值对，更清晰	冒号分隔，更简洁
路径不存在时	报错	自动创建目录
推荐程度	✅ 推荐	常用

---

使用场景

本节涵盖了相关内容与详细描述，主要探讨以下几个方面：

场景一：开发环境代码同步

运行以下命令：

## 将本地代码目录挂载到容器

$ docker run -d \
    -p 8080:80 \
    --mount type=bind,source=$(pwd)/src,target=/usr/share/nginx/html \
    nginx

## 修改本地文件，容器内立即生效（热更新）

$ echo "Hello" > src/index.html
## 浏览器刷新即可看到变化

...

场景二：配置文件挂载

运行以下命令：

## 挂载自定义 nginx 配置

$ docker run -d \
    --mount type=bind,source=/path/to/nginx.conf,target=/etc/nginx/nginx.conf,readonly \
    nginx

场景三：日志收集

运行以下命令：

## 将容器日志输出到宿主机目录

$ docker run -d \
    --mount type=bind,source=/var/log/myapp,target=/app/logs \
    myapp

场景四：共享 SSH 密钥

运行以下命令：

## 挂载 SSH 密钥（只读）

$ docker run --rm -it \
    --mount type=bind,source=$HOME/.ssh,target=/root/.ssh,readonly \
    alpine ssh user@remote

---

只读挂载

防止容器修改宿主机文件：

## --mount 语法

$ docker run -d \
    --mount type=bind,source=/config,target=/app/config,readonly \
    myapp

## -v 语法

$ docker run -d \
    -v /config:/app/config:ro \
    myapp

容器内尝试写入会报错：

$ touch /app/config/new.txt
touch: /app/config/new.txt: Read-only file system

---

挂载单个文件

运行以下命令：

## 挂载 bash 历史记录

$ docker run --rm -it \
    --mount type=bind,source=$HOME/.bash_history,target=/root/.bash_history \
    ubuntu bash

## 挂载自定义配置文件

$ docker run -d \
    --mount type=bind,source=/path/to/my.cnf,target=/etc/mysql/my.cnf \
    mysql

⚠️ 注意：挂载单个文件时，如果宿主机上的文件被编辑器替换 (而非原地修改)，容器内仍是旧文件的 inode。建议重启容器或挂载目录。

---

查看挂载信息

运行以下命令：

$ docker inspect mycontainer --format '{{json .Mounts}}' | jq

输出：

[
  {
    "Type": "bind",
    "Source": "/home/user/code",
    "Destination": "/app",
    "Mode": "",
    "RW": true,
    "Propagation": "rprivate"
  }
]

字段	说明
Type	挂载类型 (bind)
Source	宿主机路径
Destination	容器内路径
RW	是否可读写
Propagation	挂载传播模式

---

常见问题

本节涵盖了相关内容与详细描述，主要探讨以下几个方面：

Q：路径不存在报错

运行以下命令：

$ docker run --mount type=bind,source=/not/exist,target=/app nginx
docker: Error response from daemon: invalid mount config for type "bind": 
bind source path does not exist: /not/exist

解决：确保源路径存在，或改用 -v (会自动创建)

Q：权限问题

容器内用户可能无权访问挂载的文件：

## 方法1：确保宿主机文件权限允许容器用户访问

$ chmod -R 755 /path/to/data

## 方法2：以 root 运行容器

$ docker run -u root ...

## 方法3：使用相同的 UID

$ docker run -u $(id -u):$(id -g) ...

Q：macOS/Windows 性能问题

在 Docker Desktop 上，Bind Mount 性能较差 (需要跨文件系统同步)：

## 使用 :cached 或 :delegated 提高性能（macOS）

$ docker run -v /host/path:/container/path:cached myapp

选项	说明
:cached	宿主机权威，容器读取可能延迟
:delegated	容器权威，宿主机读取可能延迟
:consistent	默认，完全一致 (最慢)

---

最佳实践

本节涵盖了相关内容与详细描述，主要探讨以下几个方面：

1。开发环境使用 Bind Mount

运行以下命令：

## 代码热更新

$ docker run -v $(pwd):/app -p 3000:3000 node npm run dev

2。生产环境使用 Volume

运行以下命令：

## 数据持久化

$ docker run -v mysql_data:/var/lib/mysql mysql

3。配置文件使用只读挂载

运行以下命令：

$ docker run -v /config/nginx.conf:/etc/nginx/nginx.conf:ro nginx

4。注意路径安全

运行以下命令：

## ❌ 危险：挂载根目录或敏感目录

$ docker run -v /:/host ...

## ✅ 只挂载必要的目录

$ docker run -v /app/data:/data ...

---