Use a better structure

2026-03-11 12:21:17 +00:00 · 2026-02-09 09:32:05 -08:00
parent fdb879dcf2
commit e669ee0fe8
167 changed files with 2462 additions and 2462 deletions
--- a/03_install/3.10_experimental.md
+++ b/03_install/3.10_experimental.md
@@ -1,12 +1,12 @@
-# 开启实验特性
+## 开启实验特性

 一些 docker 命令或功能仅当 **实验特性** 开启时才能使用，请按照以下方法进行设置。

-## Docker CLI 的实验特性
+### Docker CLI 的实验特性

 从 `v20.10` 版本开始，Docker CLI 所有实验特性的命令均默认开启，无需再进行配置或设置系统环境变量。

-## 开启 dockerd 的实验特性
+### 开启 dockerd 的实验特性

 编辑 `/etc/docker/daemon.json`，新增如下条目

--- a/03_install/3.1_ubuntu.md
+++ b/03_install/3.1_ubuntu.md
@@ -1,10 +1,10 @@
-# Ubuntu 安装 Docker
+## Ubuntu 安装 Docker

 >警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker.

-## 准备工作
+### 准备工作

-### 系统要求
+#### 系统要求

 Docker 支持诸多版本的 [Ubuntu](https://ubuntu.com/server) 操作系统。但是较旧的版本上将不会有 Docker 新版本的持续更新，以截至 2026 年初的几个 Ubuntu LTS（Long Term Support，长期支持）版本为例：

@@ -16,7 +16,7 @@ Docker 支持诸多版本的 [Ubuntu](https://ubuntu.com/server) 操作系统。

 在 Ubuntu LTS 版本上，目前 Docker 支持 amd64、arm64、armhf、ppc64el、s390x 等 5 个平台；而非 LTS 版本支持的平台通常较少。同时，LTS 版本会获得 5 年的升级维护支持，这样的系统会获得更长期的安全保障，因此在生产环境中推荐使用 LTS 版本。

-### 卸载旧版本
+#### 卸载旧版本

 旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本：

@@ -33,7 +33,7 @@ do
 done
 ```

-## 使用 APT 安装
+### 使用 APT 安装

 由于 `apt` 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。

@@ -56,8 +56,8 @@ $ sudo apt install \
 $ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg


-# 官方源
-# $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
+## 官方源
+## $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 ```

 然后，我们需要向 `sources.list` 中添加 Docker 软件源
@@ -68,15 +68,15 @@ $ echo \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null


-# 官方源
-# $ echo \
-#   "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
-#   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+## 官方源
+## $ echo \
+##   "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
+##   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 ```

 >以上命令会添加稳定版本的 Docker APT 镜像源，如果需要测试版本的 Docker 请将 stable 改为 test。

-### 安装 Docker
+#### 安装 Docker

 更新 apt 软件包缓存，并安装 `docker-ce`：

@@ -86,29 +86,29 @@ $ sudo apt update
 $ sudo apt install docker-ce docker-ce-cli containerd.io
 ```

-## 使用脚本自动安装
+### 使用脚本自动安装

 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Ubuntu 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：

 > 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本

 ```bash
-# $ curl -fsSL test.docker.com -o get-docker.sh
+## $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
-# $ sudo sh get-docker.sh --mirror AzureChinaCloud
+## $ sudo sh get-docker.sh --mirror AzureChinaCloud
 ```

 执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 的稳定(stable)版本安装在系统中。

-## 启动 Docker
+### 启动 Docker

 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
 ```

-## 建立 docker 用户组
+### 建立 docker 用户组

 默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。

@@ -126,7 +126,7 @@ $ sudo usermod -aG docker $USER

 退出当前终端并重新登录，进行如下测试。

-## 测试 Docker 是否安装正确
+### 测试 Docker 是否安装正确

 ```bash
 $ docker run --rm hello-world
@@ -161,10 +161,10 @@ For more examples and ideas, visit:

 若能正常输出以上信息，则说明安装成功。

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。

-## 参考文档
+### 参考文档

 * [Docker 官方 Ubuntu 安装文档](https://docs.docker.com/install/linux/docker-ce/ubuntu/)
--- a/03_install/3.2_debian.md
+++ b/03_install/3.2_debian.md
@@ -1,10 +1,10 @@
-# Debian 安装 Docker
+## Debian 安装 Docker

 >警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker.

-## 准备工作
+### 准备工作

-### 系统要求
+#### 系统要求

 Docker 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统：

@@ -12,7 +12,7 @@ Docker 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作
 * Debian Bookworm 12 (oldstable)
 * Debian Bullseye 11 (LTS)

-### 卸载旧版本
+#### 卸载旧版本

 旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本：

@@ -22,7 +22,7 @@ $ sudo apt-get remove docker \
               docker.io
 ```

-## 使用 APT 安装
+### 使用 APT 安装

 由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。

@@ -45,8 +45,8 @@ $ sudo apt-get install \
 $ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg


-# 官方源
-# $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
+## 官方源
+## $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 ```

 然后，我们需要向 `sources.list` 中添加 Docker 软件源：
@@ -59,16 +59,16 @@ $ echo \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null


-# 官方源
-# $ echo \
-#   "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
-#   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+## 官方源
+## $ echo \
+##   "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
+##   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

 ```

 >以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。 Debian11可能不使用`/etc/apt/keyrings/`， 如gpg错误可以考虑更换为`/etc/apt/trusted.gpg.d`， 见[issue 15727](https://github.com/docker/docs/issues/15727)。

-### 安装 Docker
+#### 安装 Docker

 更新 apt 软件包缓存，并安装 `docker-ce`。

@@ -78,29 +78,29 @@ $ sudo apt-get update
 $ sudo apt-get install docker-ce docker-ce-cli containerd.io
 ```

-## 使用脚本自动安装
+### 使用脚本自动安装

 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：

 > 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本

 ```bash
-# $ curl -fsSL test.docker.com -o get-docker.sh
+## $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
-# $ sudo sh get-docker.sh --mirror AzureChinaCloud
+## $ sudo sh get-docker.sh --mirror AzureChinaCloud
 ```

 执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 的稳定(stable)版本安装在系统中。

-## 启动 Docker
+### 启动 Docker

 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
 ```

-## 建立 docker 用户组
+### 建立 docker 用户组

 默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。

@@ -118,7 +118,7 @@ $ sudo usermod -aG docker $USER

 退出当前终端并重新登录，进行如下测试。

-## 测试 Docker 是否安装正确
+### 测试 Docker 是否安装正确

 ```bash
 $ docker run --rm hello-world
@@ -153,10 +153,10 @@ For more examples and ideas, visit:

 若能正常输出以上信息，则说明安装成功。

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。

-## 参考文档
+### 参考文档

 * [Docker 官方 Debian 安装文档](https://docs.docker.com/install/linux/docker-ce/debian/)
--- a/03_install/3.3_fedora.md
+++ b/03_install/3.3_fedora.md
@@ -1,10 +1,10 @@
-# Fedora 安装 Docker
+## Fedora 安装 Docker

 >警告：切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker.

-## 准备工作
+### 准备工作

-### 系统要求
+#### 系统要求

 Docker 支持以下版本的 [Fedora](https://getfedora.org/) 操作系统：

@@ -12,7 +12,7 @@ Docker 支持以下版本的 [Fedora](https://getfedora.org/) 操作系统：
 * 42
 * 43

-### 卸载旧版本
+#### 卸载旧版本

 旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本：

@@ -29,7 +29,7 @@ $ sudo dnf remove docker \
                  docker-engine
 ```

-## 使用 dnf 安装
+### 使用 dnf 安装

 执行以下命令安装依赖包：

@@ -48,10 +48,10 @@ $ sudo dnf config-manager \

 $ sudo sed -i 's/download.docker.com/mirrors.aliyun.com\/docker-ce/g' /etc/yum.repos.d/docker-ce.repo

-# 官方源
-# $ sudo dnf config-manager \
-#    --add-repo \
-#    https://download.docker.com/linux/fedora/docker-ce.repo
+## 官方源
+## $ sudo dnf config-manager \
+##    --add-repo \
+##    https://download.docker.com/linux/fedora/docker-ce.repo
 ```

 如果需要测试版本的 Docker 请使用以下命令：
@@ -66,7 +66,7 @@ $ sudo dnf config-manager --set-enabled docker-ce-test
 $ sudo dnf config-manager --set-disabled docker-ce-test
 ```

-### 安装 Docker
+#### 安装 Docker

 更新 `dnf` 软件源缓存，并安装 `docker-ce`。

@@ -85,29 +85,29 @@ docker-ce.x86_64          18.06.1.ce-3.fc28                     docker-ce-stable
 $ sudo dnf -y install docker-ce-18.06.1.ce
 ```

-## 使用脚本自动安装
+### 使用脚本自动安装

 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：

 > 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本

 ```bash
-# $ curl -fsSL test.docker.com -o get-docker.sh
+## $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
-# $ sudo sh get-docker.sh --mirror AzureChinaCloud
+## $ sudo sh get-docker.sh --mirror AzureChinaCloud
 ```

 执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 最新稳定(stable)版本安装在系统中。

-## 启动 Docker
+### 启动 Docker

 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
 ```

-## 建立 docker 用户组
+### 建立 docker 用户组

 默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。

@@ -125,7 +125,7 @@ $ sudo usermod -aG docker $USER

 退出当前终端并重新登录，进行如下测试。

-## 测试 Docker 是否安装正确
+### 测试 Docker 是否安装正确

 ```bash
 $ docker run --rm hello-world
@@ -160,10 +160,10 @@ For more examples and ideas, visit:

 若能正常输出以上信息，则说明安装成功。

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。

-## 参考文档
+### 参考文档

 * [Docker 官方 Fedora 安装文档](https://docs.docker.com/install/linux/docker-ce/fedora)。
--- a/03_install/3.4_centos.md
+++ b/03_install/3.4_centos.md
@@ -1,10 +1,10 @@
-# CentOS 安装 Docker
+## CentOS 安装 Docker

 >警告：切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker.

-## 准备工作
+### 准备工作

-### 系统要求
+#### 系统要求

 > ⚠️ **重要提示**：CentOS 8 已于 2021 年 12 月 31 日停止维护，CentOS 7 已于 2024 年 6 月 30 日结束支持。建议新项目使用 **Rocky Linux** 或 **AlmaLinux** 作为替代。

@@ -12,7 +12,7 @@ Docker 支持 64 位版本 CentOS Stream 9、Rocky Linux 8/9、AlmaLinux 8/9，

 对于 Rocky Linux、AlmaLinux 或 CentOS Stream，推荐使用 `dnf` 包管理器。

-### 卸载旧版本
+#### 卸载旧版本

 旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本：

@@ -31,7 +31,7 @@ $ sudo yum remove docker \
                  containerd.io
 ```

-## 使用 yum 安装
+### 使用 yum 安装

 执行以下命令安装依赖包：

@@ -50,10 +50,10 @@ $ sudo dnf config-manager \

 $ sudo sed -i 's/download.docker.com/mirrors.aliyun.com\/docker-ce/g' /etc/dnf.repos.d/docker-ce.repo

-# 官方源
-# $ sudo dnf config-manager \
-#     --add-repo \
-#     https://download.docker.com/linux/centos/docker-ce.repo
+## 官方源
+## $ sudo dnf config-manager \
+##     --add-repo \
+##     https://download.docker.com/linux/centos/docker-ce.repo
 ```

 如果需要测试版本的 Docker 请执行以下命令：
@@ -62,7 +62,7 @@ $ sudo sed -i 's/download.docker.com/mirrors.aliyun.com\/docker-ce/g' /etc/dnf.r
 $ sudo dnf config-manager --enable docker-ce-test
 ```

-### 安装 Docker
+#### 安装 Docker

 更新 `dnf` 软件源缓存，并安装 `docker-ce`。

@@ -70,14 +70,14 @@ $ sudo dnf config-manager --enable docker-ce-test
 $ sudo dnf install docker-ce docker-ce-cli containerd.io
 ```

-## CentOS8 额外设置
+### CentOS8 额外设置

 由于 CentOS8 防火墙使用了 `nftables`，但 Docker 尚未支持 `nftables`， 我们可以使用如下设置使用 `iptables`：

 更改 `/etc/firewalld/firewalld.conf`

 ```bash
-# FirewallBackend=nftables
+## FirewallBackend=nftables
 FirewallBackend=iptables
 ```

@@ -89,29 +89,29 @@ $ firewall-cmd --permanent --zone=trusted --add-interface=docker0
 $ firewall-cmd --reload
 ```

-## 使用脚本自动安装
+### 使用脚本自动安装

 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，CentOS 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：

 > 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本

 ```bash
-# $ curl -fsSL test.docker.com -o get-docker.sh
+## $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
-# $ sudo sh get-docker.sh --mirror AzureChinaCloud
+## $ sudo sh get-docker.sh --mirror AzureChinaCloud
 ```

 执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 的稳定(stable)版本安装在系统中。

-## 启动 Docker
+### 启动 Docker

 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
 ```

-## 建立 docker 用户组
+### 建立 docker 用户组

 默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。

@@ -129,7 +129,7 @@ $ sudo usermod -aG docker $USER

 退出当前终端并重新登录，进行如下测试。

-## 测试 Docker 是否安装正确
+### 测试 Docker 是否安装正确

 ```bash
 $ docker run --rm hello-world
@@ -164,11 +164,11 @@ For more examples and ideas, visit:

 若能正常输出以上信息，则说明安装成功。

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。

-## 添加内核参数
+### 添加内核参数

 如果在 CentOS 使用 Docker 看到下面的这些警告信息：

@@ -192,7 +192,7 @@ EOF
 $ sudo sysctl -p
 ```

-## 参考文档
+### 参考文档

 * [Docker 官方 CentOS 安装文档](https://docs.docker.com/install/linux/docker-ce/centos/)。
 * https://firewalld.org/2018/07/nftables-backend
--- a/03_install/3.5_raspberry-pi.md
+++ b/03_install/3.5_raspberry-pi.md
@@ -1,8 +1,8 @@
-# 树莓派卡片电脑安装 Docker
+## 树莓派卡片电脑安装 Docker

 >警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker.

-## 系统要求
+### 系统要求

 Docker 不仅支持 `x86_64` 架构的计算机，同时也支持 `ARM` 架构的计算机，本小节内容以树莓派单片电脑为例讲解 `ARM` 架构安装 Docker。

@@ -14,7 +14,7 @@ Docker 支持以下版本的 [Raspberry Pi OS](https://www.raspberrypi.org/softw

 *注：* `Raspberry Pi OS` 由树莓派的开发与维护机构 [树莓派基金会](https://www.raspberrypi.org/) 官方支持，并推荐用作树莓派的首选系统，其基于 `Debian`。

-## 使用 APT 安装
+### 使用 APT 安装

 由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。

@@ -38,8 +38,8 @@ $ sudo apt-get install \
 $ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/raspbian/gpg | sudo apt-key add -


-# 官方源
-# $ curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo apt-key add -
+## 官方源
+## $ curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo apt-key add -
 ```

 然后，我们需要向 `sources.list` 中添加 Docker 软件源：
@@ -51,16 +51,16 @@ $ sudo add-apt-repository \
    stable"


-# 官方源
-# $ sudo add-apt-repository \
-#    "deb [arch=armhf] https://download.docker.com/linux/raspbian \
-#    $(lsb_release -cs) \
-#    stable"
+## 官方源
+## $ sudo add-apt-repository \
+##    "deb [arch=armhf] https://download.docker.com/linux/raspbian \
+##    $(lsb_release -cs) \
+##    stable"
 ```

 >以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。

-#### 报错解决办法
+##### 报错解决办法

 在 `Raspberry Pi OS Bullseye/Bookworm` 中，添加 Docker 软件源的步骤可能会出现如下报错:

@@ -83,11 +83,11 @@ aptsources.distro.NoDistroTemplateException: Error: could not find a distributio
 $ sudo echo "deb [arch=armhf] https://mirrors.aliyun.com/docker-ce/linux/raspbian $(lsb_release -cs) stable" | sudo tee -a /etc/apt/sources.list


-# 官方源
-# $ sudo echo "deb [arch=armhf] https://download.docker.com/linux/raspbian $(lsb_release -cs) stable" | sudo tee -a /etc/apt/sources.list
+## 官方源
+## $ sudo echo "deb [arch=armhf] https://download.docker.com/linux/raspbian $(lsb_release -cs) stable" | sudo tee -a /etc/apt/sources.list
 ```

-### 安装 Docker
+#### 安装 Docker

 更新 apt 软件包缓存，并安装 `docker-ce`。

@@ -97,29 +97,29 @@ $ sudo apt-get update
 $ sudo apt-get install docker-ce
 ```

-## 使用脚本自动安装
+### 使用脚本自动安装

 在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Raspberry Pi OS 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：

 > 若你想安装测试版的 Docker, 请从 test.docker.com 获取脚本

 ```bash
-# $ curl -fsSL test.docker.com -o get-docker.sh
+## $ curl -fsSL test.docker.com -o get-docker.sh
 $ curl -fsSL get.docker.com -o get-docker.sh
 $ sudo sh get-docker.sh --mirror Aliyun
-# $ sudo sh get-docker.sh --mirror AzureChinaCloud
+## $ sudo sh get-docker.sh --mirror AzureChinaCloud
 ```

 执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 的稳定(stable)版本安装在系统中。

-## 启动 Docker
+### 启动 Docker

 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
 ```

-## 建立 docker 用户组
+### 建立 docker 用户组

 默认情况下，`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑，一般 Linux 系统上不会直接使用 `root` 用户。因此，更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。

@@ -137,7 +137,7 @@ $ sudo usermod -aG docker $USER

 退出当前终端并重新登录，进行如下测试。

-## 测试 Docker 是否安装正确
+### 测试 Docker 是否安装正确

 ```bash
 $ docker run --rm hello-world
@@ -174,6 +174,6 @@ For more examples and ideas, visit:

 *注意：* ARM 平台不能使用 `x86` 镜像，查看 Raspberry Pi OS 可使用镜像请访问 [arm32v7](https://hub.docker.com/u/arm32v7/) 或者 [arm64v8](https://hub.docker.com/u/arm64v8/)。

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。
--- a/03_install/3.6_offline.md
+++ b/03_install/3.6_offline.md
@@ -1,4 +1,4 @@
-# Linux 离线安装
+## Linux 离线安装

 \[TOC]

@@ -8,15 +8,15 @@

 ![Docker-offile-install-top](../_images/image-20200412202617411.png)

-## CentOS/Rocky/AlmaLinux 离线安装Docker
+### CentOS/Rocky/AlmaLinux 离线安装Docker

 > 注意：以下命令以 CentOS 7 为例。对于 CentOS Stream 9、Rocky Linux 9 或 AlmaLinux 9，请将 `yum` 替换为 `dnf`，并将软件包后缀 `el7` 替换为 `el9`。

-### YUM本地文件安装（推荐）
+#### YUM本地文件安装（推荐）

 推荐这种方式，是因为在生产环境种一般会选定某个指定的文档软件版本使用。

-#### 查询可用的软件版本(A)
+##### 查询可用的软件版本(A)

 ```bash
 #下载清华的镜像源文件
@@ -43,7 +43,7 @@ docker-ce.x86_64            3:19.03.1-3.el7                     docker-ce-stable
 ....
 ```

-#### 下载到指定文件夹(A)
+##### 下载到指定文件夹(A)

 ```bash
 sudo yum install --downloadonly --downloaddir=/tmp/docker24_offline_install/ docker-ce-24.0.4-1.el7 docker-ce-cli-24.0.4-1.el7
@@ -78,7 +78,7 @@ Total
 exiting because "Download Only" specified
 ```

-#### 复制到目标服务器之后进入文件夹安装(C-N)
+##### 复制到目标服务器之后进入文件夹安装(C-N)

 * 离线安装时，必须使用rpm命令不检查依赖的方式安装

@@ -86,7 +86,7 @@ exiting because "Download Only" specified
 rpm -Uvh *.rpm --nodeps --force
 ```

-#### 锁定软件版本(C-N)
+##### 锁定软件版本(C-N)

 **下载锁定版本软件**

@@ -143,19 +143,19 @@ versionlock deleted: 1
 sudo yum versionlock delete all
 ```

-### YUM 本地源服务器搭建安装Docker
+#### YUM 本地源服务器搭建安装Docker

-#### 挂载 ISO 镜像搭建本地 File 源（AB）
+##### 挂载 ISO 镜像搭建本地 File 源（AB）

 ```bash
-# 删除其他网络源
+## 删除其他网络源
 rm -f /etc/yum.repo.d/*
-# 挂载光盘或者iso镜像
+## 挂载光盘或者iso镜像
 mount /dev/cdrom /mnt
 ```

 ```bash
-# 添加本地源
+## 添加本地源
 cat >/etc/yum.repos.d/local_files.repo<< EOF
 [Local_Files]
 name=Local_Files
@@ -167,69 +167,69 @@ EOF
 ```

 ```bash
-# 测试刚才的本地源,安装createrepo软件
+## 测试刚才的本地源,安装createrepo软件
 yum clean all 
 yum install createrepo -y
 ```

-#### 根据本地文件搭建BASE网络源（B）
+##### 根据本地文件搭建BASE网络源（B）

 ```bash
-# 安装apache 服务器
+## 安装apache 服务器
 yum install httpd -y
-# 挂载光盘
+## 挂载光盘
 mount /dev/cdrom /mnt
-# 新建centos目录
+## 新建centos目录
 mkdir /var/www/html/base
-# 复制光盘内的文件到刚才新建的目录
+## 复制光盘内的文件到刚才新建的目录
 cp -R /mnt/Packages/* /var/www/html/base/
 createrepo  /var/www/html/centos/
 systemctl enable httpd
 systemctl start httpd
 ```

-#### 下载Docker-CE 镜像仓库（A）
+##### 下载Docker-CE 镜像仓库（A）

 在有网络的服务器上下载Docker-ce镜像

 ```bash
-# 下载清华的镜像源文件
+## 下载清华的镜像源文件
 wget -O /etc/yum.repos.d/docker-ce.repo https://download.docker.com/linux/centos/docker-ce.repo
 sudo sed -i 's+download.docker.com+mirrors.tuna.tsinghua.edu.cn/docker-ce+' /etc/yum.repos.d/docker-ce.repo
 ```

 ```bash
-# 新建 docker-ce目录
+## 新建 docker-ce目录
 mkdir /tmp/docker-ce/
-# 把镜像源同步到镜像文件中
+## 把镜像源同步到镜像文件中
 reposync -r docker-ce-stable -p /tmp/docker-ce/
 ```

-#### 创建仓库索引（B）
+##### 创建仓库索引（B）

 把下载的 docker-ce 文件夹复制到离线的服务器

 ```bash
-# 把docker-ce 文件夹复制到/var/www/html/docker-ce
-# 重建索引
+## 把docker-ce 文件夹复制到/var/www/html/docker-ce
+## 重建索引
 createrepo  /var/www/html/docker-ce/
 ```

-#### YUM 客户端设置（C...N）
+##### YUM 客户端设置（C...N）

 ```bash
 rm -f /etc/yum.repo.d/*
 cat >/etc/yum.repos.d/local_files.repo<< EOF
 [local_base]
 name=local_base
-# 改成B服务器地址
+## 改成B服务器地址
 baseurl=http://x.x.x.x/base
 enable=1
 gpgcheck=0
 proxy=_none_
 [docker_ce]
 name=docker_ce
-# 改成B服务器地址
+## 改成B服务器地址
 baseurl=http://x.x.x.x/base
 enable=1
 gpgcheck=0
@@ -238,7 +238,7 @@ EOF

 ```

-#### Docker 安装（C...N）
+##### Docker 安装（C...N）

 ```bash
 sudo yum makecache fast
--- a/03_install/3.7_mac.md
+++ b/03_install/3.7_mac.md
@@ -1,12 +1,12 @@
-# macOS
+## macOS

-## 系统要求
+### 系统要求

 [Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS Sonora 14.0 或更高版本，建议升级到最新版本的 macOS。

-## 安装
+### 安装

-### 使用 Homebrew 安装
+#### 使用 Homebrew 安装

 [Homebrew](https://brew.sh/) 的 [Cask](https://github.com/Homebrew/homebrew-cask) 已经支持 Docker Desktop for Mac，因此可以很方便的使用 Homebrew Cask 来进行安装：

@@ -14,7 +14,7 @@
 $ brew install --cask docker
 ```

-### 手动下载安装
+#### 手动下载安装

 如果需要手动下载，请点击以下 [链接](https://desktop.docker.com/mac/main/amd64/Docker.dmg) 下载 Docker Desktop for Mac。

@@ -24,7 +24,7 @@ $ brew install --cask docker

 ![](../_images/install-mac-dmg.png)

-## 运行
+### 运行

 从应用中找到 Docker 图标并点击运行。

@@ -62,10 +62,10 @@ $ docker stop webserver
 $ docker rm webserver
 ```

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。

-## 参考链接
+### 参考链接

 * [官方文档](https://docs.docker.com/docker-for-mac/install/)
--- a/03_install/3.8_windows.md
+++ b/03_install/3.8_windows.md
@@ -1,10 +1,10 @@
-# Windows 10/11
+## Windows 10/11

-## 系统要求
+### 系统要求

 [Docker Desktop for Windows](https://docs.docker.com/docker-for-windows/install/) 支持 64 位版本的 Windows 11 或 Windows 10（需开启 Hyper-V），推荐使用 Windows 11。

-## 安装
+### 安装

 **手动下载安装**

@@ -18,11 +18,11 @@
 $ winget install Docker.DockerDesktop
 ```

-## 在 WSL2 运行 Docker
+### 在 WSL2 运行 Docker

 若你的 Windows 版本为 Windows 10 专业版或家庭版 v1903 及以上版本可以使用 WSL2 运行 Docker，具体请查看 [Docker Desktop WSL 2 backend](https://docs.docker.com/docker-for-windows/wsl/)。

-## 运行
+### 运行

 在 Windows 搜索栏输入 **Docker** 点击 **Docker Desktop** 开始运行。

@@ -36,11 +36,11 @@ Docker 启动之后会在 Windows 任务栏出现鲸鱼图标。

 > 推荐使用 [Windows Terminal](https://docs.microsoft.com/zh-cn/windows/terminal/get-started) 在终端使用 Docker。

-## 镜像加速
+### 镜像加速

-如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](mirror.md)。
+如果在使用过程中发现拉取 Docker 镜像十分缓慢，可以配置 Docker [国内镜像加速](3.9_mirror.md)。

-## 参考链接
+### 参考链接

 * [官方文档](https://docs.docker.com/docker-for-windows/install/)
 * [WSL 2 Support is coming to Windows 10 Versions 1903 and 1909](https://devblogs.microsoft.com/commandline/wsl-2-support-is-coming-to-windows-10-versions-1903-and-1909/)
--- a/03_install/3.9_mirror.md
+++ b/03_install/3.9_mirror.md
@@ -1,10 +1,10 @@
-# 镜像加速器
+## 镜像加速器

 国内从 Docker Hub 拉取镜像有时会遇到困难，此时可以配置镜像加速器。

 > ⚠️ **注意**：镜像加速器的可用性经常变化。配置前请先访问 [docker-practice/docker-registry-cn-mirror-test](https://github.com/docker-practice/docker-registry-cn-mirror-test/actions) 查看各镜像站的实时状态。

-## 推荐配置方案
+### 推荐配置方案

 1. **云服务器用户**：优先使用所在云平台提供的内部加速器（见本页末尾）
 2. **本地开发用户**：使用阿里云个人加速器或其他可用的公共加速器
@@ -16,7 +16,7 @@

 > `hub.atomgit.com` 仅包含部分官方镜像，可以满足初学者的使用。

-## Ubuntu 16.04+、Debian 8+、CentOS 7+
+### Ubuntu 16.04+、Debian 8+、CentOS 7+

 目前主流 Linux 发行版均已使用 [systemd](https://systemd.io/) 进行服务管理，这里介绍如何在使用 systemd 的 Linux 发行版中配置镜像加速器。

@@ -47,7 +47,7 @@ $ sudo systemctl daemon-reload
 $ sudo systemctl restart docker
 ```

-## Windows 10
+### Windows 10

 对于使用 `Windows 10` 的用户，在任务栏托盘 Docker 图标内右键菜单选择 `Change settings`，打开配置窗口后在左侧导航菜单选择 `Docker Engine`，在右侧像下边一样编辑 json 文件，之后点击 `Apply & Restart` 保存后 Docker 就会重启并应用配置的镜像地址了。

@@ -59,7 +59,7 @@ $ sudo systemctl restart docker
 }
 ```

-## macOS
+### macOS

 对于使用 macOS 的用户，在任务栏点击 Docker Desktop 应用图标 -> `Settings...`，在左侧导航菜单选择 `Docker Engine`，在右侧像下边一样编辑 json 文件。修改完成之后，点击 `Apply & restart` 按钮，Docker 就会重启并应用配置的镜像地址了。

@@ -71,7 +71,7 @@ $ sudo systemctl restart docker
 }
 ```

-## 检查加速器是否生效
+### 检查加速器是否生效

 执行 `$ docker info`，如果从结果中看到了如下内容，说明配置成功。

@@ -80,7 +80,7 @@ Registry Mirrors:
 https://hub.atomgit.com/
 ```

-## `k8s.gcr.io` 镜像
+### `k8s.gcr.io` 镜像

 可以登录 [阿里云 容器镜像服务](https://www.aliyun.com/product/acr?source=5176.11533457&userCode=8lx5zmtu&type=copy) **镜像中心** -> **镜像搜索** 查找。

@@ -89,12 +89,12 @@ Registry Mirrors:
 一般情况下有如下对应关系：

 ```bash
-# $ docker pull k8s.gcr.io/xxx
+## $ docker pull k8s.gcr.io/xxx

 $ docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/xxx
 ```

-## 不再提供服务的镜像
+### 不再提供服务的镜像

 某些镜像不再提供服务，添加无用的镜像加速器，会拖慢镜像拉取速度，你可以从镜像配置列表中删除它们。

@@ -106,7 +106,7 @@ $ docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/xxx

 建议 **watch（页面右上角）** [镜像测试](https://github.com/docker-practice/docker-registry-cn-mirror-test) 这个 GitHub 仓库，我们会在此更新各个镜像地址的状态。

-## 云服务商
+### 云服务商

 某些云服务商提供了 **仅供内部** 访问的镜像服务，当您的 Docker 运行在云平台时可以选择它们。

--- a/03_install/README.md
+++ b/03_install/README.md
@@ -1,4 +1,4 @@
-# 安装 Docker
+# 第三章 安装 Docker

 Docker 分为 `stable` `test` 和 `nightly` 三个更新频道。