Use a better structure

2026-03-10 20:04:36 +00:00 · 2026-02-09 09:32:05 -08:00
parent fdb879dcf2
commit e669ee0fe8
167 changed files with 2462 additions and 2462 deletions
--- a/07_data_network/data/volume.md
+++ b/07_data_network/data/volume.md
@@ -1,6 +1,6 @@
-# 数据卷
+## 数据卷

-## 为什么需要数据卷
+### 为什么需要数据卷

 容器的存储层有一个关键问题：**容器删除后，数据就没了**。

@@ -15,7 +15,7 @@ flowchart LR

 ---

-## 数据卷的特性
+### 数据卷的特性

 | 特性 | 说明 |
 |------|------|
@@ -27,9 +27,9 @@ flowchart LR

 ---

-## 数据卷 vs 容器存储层
+### 数据卷 vs 容器存储层

-#### 容器存储层（不推荐存储重要数据）
+##### 容器存储层（不推荐存储重要数据）

 ```mermaid
 graph TD
@@ -43,7 +43,7 @@ graph TD
    Delete[容器删除] -->|导致| DataLost[数据丢失 ❌]
 ```

-#### 数据卷（推荐）
+##### 数据卷（推荐）

 ```mermaid
 graph TD
@@ -61,15 +61,15 @@ graph TD

 ---

-## 数据卷基本操作
+### 数据卷基本操作

-### 创建数据卷
+#### 创建数据卷

 ```bash
 $ docker volume create my-vol
 ```

-### 列出所有数据卷
+#### 列出所有数据卷

 ```bash
 $ docker volume ls
@@ -79,7 +79,7 @@ local     postgres_data
 local     redis_data
 ```

-### 查看数据卷详情
+#### 查看数据卷详情

 ```bash
 $ docker volume inspect my-vol
@@ -102,9 +102,9 @@ $ docker volume inspect my-vol

 ---

-## 挂载数据卷
+### 挂载数据卷

-### 方式一：--mount（推荐）
+#### 方式一：--mount（推荐）

 ```bash
 $ docker run -d \
@@ -121,7 +121,7 @@ $ docker run -d \
 | `target` | 容器内挂载路径 |
 | `readonly` | 可选，只读挂载 |

-### 方式二：-v（简写）
+#### 方式二：-v（简写）

 ```bash
 $ docker run -d \
@@ -132,7 +132,7 @@ $ docker run -d \

 **格式**：`-v 数据卷名:容器路径[:选项]`

-### 两种方式对比
+#### 两种方式对比

 | 特性 | --mount | -v |
 |------|---------|-----|
@@ -140,15 +140,15 @@ $ docker run -d \
 | 自动创建卷 | source 不存在会报错 | 自动创建 |
 | 推荐程度 | ✅ 推荐（更明确） | 常用（更简洁） |

-### 只读挂载
+#### 只读挂载

 ```bash
-# --mount 方式
+## --mount 方式
 $ docker run -d \
    --mount source=my-vol,target=/data,readonly \
    nginx

-# -v 方式
+## -v 方式
 $ docker run -d \
    -v my-vol:/data:ro \
    nginx
@@ -156,25 +156,25 @@ $ docker run -d \

 ---

-## 使用场景示例
+### 使用场景示例

-### 场景一：数据库持久化
+#### 场景一：数据库持久化

 ```bash
-# 创建数据卷
+## 创建数据卷
 $ docker volume create postgres_data

-# 启动 PostgreSQL，数据存储在数据卷中
+## 启动 PostgreSQL，数据存储在数据卷中
 $ docker run -d \
    --name postgres \
    -e POSTGRES_PASSWORD=secret \
    -v postgres_data:/var/lib/postgresql/data \
    postgres:16

-# 即使删除容器，数据仍然保留
+## 即使删除容器，数据仍然保留
 $ docker rm -f postgres

-# 重新启动，数据还在
+## 重新启动，数据还在
 $ docker run -d \
    --name postgres \
    -e POSTGRES_PASSWORD=secret \
@@ -182,27 +182,27 @@ $ docker run -d \
    postgres:16
 ```

-### 场景二：多容器共享数据
+#### 场景二：多容器共享数据

 ```bash
-# 创建共享数据卷
+## 创建共享数据卷
 $ docker volume create shared-data

-# 容器 A 写入数据
+## 容器 A 写入数据
 $ docker run -d --name writer \
    -v shared-data:/data \
    alpine sh -c "while true; do date >> /data/log.txt; sleep 5; done"

-# 容器 B 读取数据
+## 容器 B 读取数据
 $ docker run --rm \
    -v shared-data:/data \
    alpine cat /data/log.txt
 ```

-### 场景三：配置文件持久化
+#### 场景三：配置文件持久化

 ```bash
-# 将 nginx 配置存储在数据卷中
+## 将 nginx 配置存储在数据卷中
 $ docker run -d \
    -v nginx-config:/etc/nginx/conf.d \
    -v nginx-logs:/var/log/nginx \
@@ -212,28 +212,28 @@ $ docker run -d \

 ---

-## 数据卷管理
+### 数据卷管理

-### 删除数据卷
+#### 删除数据卷

 ```bash
-# 删除指定数据卷
+## 删除指定数据卷
 $ docker volume rm my-vol

-# 删除容器时同时删除数据卷
+## 删除容器时同时删除数据卷
 $ docker rm -v container_name
 ```

-### 清理未使用的数据卷
+#### 清理未使用的数据卷

 ```bash
-# 查看未被任何容器使用的数据卷
+## 查看未被任何容器使用的数据卷
 $ docker volume ls -f dangling=true

-# 删除所有未使用的数据卷
+## 删除所有未使用的数据卷
 $ docker volume prune

-# 强制删除（不提示确认）
+## 强制删除（不提示确认）
 $ docker volume prune -f
 ```

@@ -241,12 +241,12 @@ $ docker volume prune -f

 ---

-## 数据卷备份与恢复
+### 数据卷备份与恢复

-### 备份数据卷
+#### 备份数据卷

 ```bash
-# 使用临时容器挂载数据卷，打包备份
+## 使用临时容器挂载数据卷，打包备份
 $ docker run --rm \
    -v my-vol:/source:ro \
    -v $(pwd):/backup \
@@ -259,24 +259,24 @@ $ docker run --rm \
 3. 挂载当前目录到 `/backup`
 4. 使用 tar 打包

-### 恢复数据卷
+#### 恢复数据卷

 ```bash
-# 创建新数据卷
+## 创建新数据卷
 $ docker volume create my-vol-restored

-# 解压备份到新数据卷
+## 解压备份到新数据卷
 $ docker run --rm \
    -v my-vol-restored:/target \
    -v $(pwd):/backup:ro \
    alpine tar xzf /backup/my-vol-backup.tar.gz -C /target
 ```

-### 备份脚本示例
+#### 备份脚本示例

 ```bash
 #!/bin/bash
-# backup-volume.sh
+## backup-volume.sh

 VOLUME_NAME=$1
 BACKUP_DIR=${2:-/backups}
@@ -292,7 +292,7 @@ echo "Backed up ${VOLUME_NAME} to ${BACKUP_DIR}/${VOLUME_NAME}_${TIMESTAMP}.tar.

 ---

-## 数据卷 vs 绑定挂载
+### 数据卷 vs 绑定挂载

 Docker 有两种主要的数据持久化方式：

@@ -305,10 +305,10 @@ Docker 有两种主要的数据持久化方式：
 | **备份** | 需要工具 | 直接访问文件 |

 ```bash
-# 数据卷
+## 数据卷
 $ docker run -v mydata:/app/data nginx

-# 绑定挂载
+## 绑定挂载
 $ docker run -v /host/path:/app/data nginx
 ```

@@ -316,27 +316,27 @@ $ docker run -v /host/path:/app/data nginx

 ---

-## 常见问题
+### 常见问题

-### Q: 如何知道容器使用了哪些数据卷？
+#### Q: 如何知道容器使用了哪些数据卷？

 ```bash
 $ docker inspect container_name --format '{{json .Mounts}}' | jq
 ```

-### Q: 数据卷的数据在哪里？
+#### Q: 数据卷的数据在哪里？

 ```bash
-# 查看数据卷详情
+## 查看数据卷详情
 $ docker volume inspect my-vol

-# Mountpoint 字段显示实际路径
+## Mountpoint 字段显示实际路径
 "Mountpoint": "/var/lib/docker/volumes/my-vol/_data"
 ```

 > ⚠️ **注意**：不建议直接修改 Mountpoint 中的文件，应通过容器操作。

-### Q: 如何在不同机器间迁移数据卷？
+#### Q: 如何在不同机器间迁移数据卷？

 1. 在源机器备份：`docker run --rm -v mydata:/data -v $(pwd):/backup alpine tar czf /backup/data.tar.gz -C /data .`
 2. 传输 tar.gz 文件
@@ -344,7 +344,7 @@ $ docker volume inspect my-vol

 ---

-## 本章小结
+### 本章小结

 | 操作 | 命令 |
 |------|------|
@@ -355,8 +355,8 @@ $ docker volume inspect my-vol
 | 清理未用 | `docker volume prune` |
 | 挂载数据卷 | `-v name:/path` 或 `--mount source=name,target=/path` |

-## 延伸阅读
+### 延伸阅读

 - [绑定挂载](bind-mounts.md)：挂载宿主机目录
 - [tmpfs 挂载](tmpfs.md)：内存中的临时存储
- [存储驱动](../13_implementation/ufs.md)：Docker 存储的底层原理
+- [存储驱动](../13_implementation/13.4_ufs.md)：Docker 存储的底层原理