style(docs): standardize heading formats and numbering

- Enforce Level 1-3 structural numbering based on SUMMARY.md hierarchy
- Remove structural numbering from Level 4+ headings
- Eliminate single child headings by converting to bold text
- Auto-inject summary text for headings with multiple children missing intro text
- Exclude Appendix chapters from structural numbering
- Avoid modifying code block contents
- Add script to detect non-standard English usage in headers
This commit is contained in:
Baohua Yang
2026-02-21 22:40:33 -08:00
parent 33af380be1
commit 175aaae48a
136 changed files with 1015 additions and 766 deletions

View File

@@ -2,13 +2,13 @@
一些 docker 命令或功能仅当 **实验特性** 开启时才能使用请按照以下方法进行设置
### Docker CLI 的实验特性
### 3.10.1 Docker CLI 的实验特性
CLI 的实验特性通常包含仍在开发中的新功能幸运的是在较新版本中这些特性已经更加易用
`v20.10` 版本开始Docker CLI 所有实验特性的命令均默认开启无需再进行配置或设置系统环境变量
### 开启 dockerd 的实验特性
### 3.10.2 开启 dockerd 的实验特性
编辑 `/etc/docker/daemon.json`新增如下条目

View File

@@ -4,7 +4,7 @@ Ubuntu 是 Docker 最常用的运行环境之一。本节将介绍如何在 Ubun
>警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
### 准备工作
### 3.1.1 准备工作
在开始安装之前我们需要确认系统版本是否满足要求并清理可能存在的旧版本
@@ -37,7 +37,7 @@ do
done
```
### 使用 APT 安装
### 3.1.2 使用 APT 安装
由于 `apt` 源使用 HTTPS 以确保软件下载过程中不被篡改因此我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书
@@ -100,7 +100,7 @@ $ sudo apt update
$ sudo apt install docker-ce docker-ce-cli containerd.io
```
### 使用脚本自动安装
### 3.1.3 使用脚本自动安装
在测试或开发环境中 Docker 官方为了简化安装流程提供了一套便捷的安装脚本Ubuntu 系统上可以使用这套脚本安装另外可以通过 `--mirror` 选项使用国内源进行安装
@@ -117,7 +117,7 @@ $ sudo sh get-docker.sh --mirror Aliyun
执行这个命令后脚本就会自动的将一切准备工作做好并且把 Docker 的稳定 (stable) 版本安装在系统中
### 启动 Docker
### 3.1.4 启动 Docker
运行以下命令
@@ -126,7 +126,7 @@ $ sudo systemctl enable docker
$ sudo systemctl start docker
```
### 建立 docker 用户组
### 3.1.5 建立 docker 用户组
默认情况下`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。
@@ -144,7 +144,7 @@ $ sudo usermod -aG docker $USER
退出当前终端并重新登录进行如下测试
### 测试 Docker 是否安装正确
### 3.1.6 测试 Docker 是否安装正确
运行以下命令
@@ -181,10 +181,10 @@ For more examples and ideas, visit:
若能正常输出以上信息则说明安装成功
### 镜像加速
### 3.1.7 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)
### 参考文档
### 3.1.8 参考文档
* [Docker 官方 Ubuntu 安装文档](https://docs.docker.com/engine/install/ubuntu/)

View File

@@ -4,7 +4,7 @@ Debian 以其稳定性著称,是 Docker 的理想宿主系统。本节将指
>警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
### 准备工作
### 3.2.1 准备工作
安装前请仔细检查 Debian 版本支持情况并卸载旧版本以避免冲突
@@ -26,7 +26,7 @@ $ sudo apt-get remove docker \
docker.io
```
### 使用 APT 安装
### 3.2.2 使用 APT 安装
由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改因此我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书
@@ -91,7 +91,7 @@ $ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io
```
### 使用脚本自动安装
### 3.2.3 使用脚本自动安装
在测试或开发环境中 Docker 官方为了简化安装流程提供了一套便捷的安装脚本Debian 系统上可以使用这套脚本安装另外可以通过 `--mirror` 选项使用国内源进行安装
@@ -108,7 +108,7 @@ $ sudo sh get-docker.sh --mirror Aliyun
执行这个命令后脚本就会自动的将一切准备工作做好并且把 Docker 的稳定 (stable) 版本安装在系统中
### 启动 Docker
### 3.2.4 启动 Docker
运行以下命令
@@ -117,7 +117,7 @@ $ sudo systemctl enable docker
$ sudo systemctl start docker
```
### 建立 docker 用户组
### 3.2.5 建立 docker 用户组
默认情况下`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。
@@ -135,7 +135,7 @@ $ sudo usermod -aG docker $USER
退出当前终端并重新登录进行如下测试
### 测试 Docker 是否安装正确
### 3.2.6 测试 Docker 是否安装正确
运行以下命令
@@ -172,10 +172,10 @@ For more examples and ideas, visit:
若能正常输出以上信息则说明安装成功
### 镜像加速
### 3.2.7 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)
### 参考文档
### 3.2.8 参考文档
* [Docker 官方 Debian 安装文档](https://docs.docker.com/engine/install/debian/)

View File

@@ -4,7 +4,7 @@ Fedora 作为技术前沿的 Linux 发行版,对 Docker 有着良好的支持
>警告切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker
### 准备工作
### 3.3.1 准备工作
确保你的 Fedora 版本在支持列表中并清理旧版本
@@ -33,7 +33,7 @@ $ sudo dnf remove docker \
docker-engine
```
### 使用 dnf 安装
### 3.3.2 使用 dnf 安装
使用 dnf 包管理器安装是推荐的方式便于后续的更行和管理
@@ -99,7 +99,7 @@ docker-ce.x86_64 18.06.1.ce-3.fc28 docker-ce-stable
$ sudo dnf -y install docker-ce-18.06.1.ce
```
### 使用脚本自动安装
### 3.3.3 使用脚本自动安装
在测试或开发环境中 Docker 官方为了简化安装流程提供了一套便捷的安装脚本Fedora 系统上可以使用这套脚本安装另外可以通过 `--mirror` 选项使用国内源进行安装
@@ -116,7 +116,7 @@ $ sudo sh get-docker.sh --mirror Aliyun
执行这个命令后脚本就会自动的将一切准备工作做好并且把 Docker 最新稳定 (stable) 版本安装在系统中
### 启动 Docker
### 3.3.4 启动 Docker
运行以下命令
@@ -125,7 +125,7 @@ $ sudo systemctl enable docker
$ sudo systemctl start docker
```
### 建立 docker 用户组
### 3.3.5 建立 docker 用户组
默认情况下`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。
@@ -143,7 +143,7 @@ $ sudo usermod -aG docker $USER
退出当前终端并重新登录进行如下测试
### 测试 Docker 是否安装正确
### 3.3.6 测试 Docker 是否安装正确
运行以下命令
@@ -180,10 +180,10 @@ For more examples and ideas, visit:
若能正常输出以上信息则说明安装成功
### 镜像加速
### 3.3.7 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)
### 参考文档
### 3.3.8 参考文档
* [Docker 官方 Fedora 安装文档](https://docs.docker.com/engine/install/fedora/)。

View File

@@ -4,7 +4,7 @@ CentOS (及其替代品 Rocky Linux、AlmaLinux) 是企业级服务器常用的
>警告切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker
### 准备工作
### 3.4.1 准备工作
安装前请确认系统版本和内核版本满足 Docker 的运行要求
@@ -35,7 +35,7 @@ $ sudo yum remove docker \
containerd.io
```
### 使用 yum 安装
### 3.4.2 使用 yum 安装
使用 yum/dnf 安装是管理 Docker 生命周期的标准方式
@@ -84,7 +84,7 @@ $ sudo dnf config-manager --set-enabled docker-ce-test
$ sudo dnf install docker-ce docker-ce-cli containerd.io
```
### CentOS8 额外设置
### 3.4.3 CentOS8 额外设置
CentOS 8/Stream 默认使用 `nftables`Docker 在新版本中已提供 `nftables` 实验支持但在一些环境下仍可能遇到兼容性问题若你遇到容器网络异常可以先切换回 `iptables` 后端
@@ -104,7 +104,7 @@ $ firewall-cmd --permanent --zone=trusted --add-interface=docker0
$ firewall-cmd --reload
```
### 使用脚本自动安装
### 3.4.4 使用脚本自动安装
在测试或开发环境中 Docker 官方为了简化安装流程提供了一套便捷的安装脚本CentOS 系统上可以使用这套脚本安装另外可以通过 `--mirror` 选项使用国内源进行安装
@@ -121,7 +121,7 @@ $ sudo sh get-docker.sh --mirror Aliyun
执行这个命令后脚本就会自动的将一切准备工作做好并且把 Docker 的稳定 (stable) 版本安装在系统中
### 启动 Docker
### 3.4.5 启动 Docker
运行以下命令
@@ -130,7 +130,7 @@ $ sudo systemctl enable docker
$ sudo systemctl start docker
```
### 建立 docker 用户组
### 3.4.6 建立 docker 用户组
默认情况下`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。
@@ -148,7 +148,7 @@ $ sudo usermod -aG docker $USER
退出当前终端并重新登录进行如下测试
### 测试 Docker 是否安装正确
### 3.4.7 测试 Docker 是否安装正确
运行以下命令
@@ -185,11 +185,11 @@ For more examples and ideas, visit:
若能正常输出以上信息则说明安装成功
### 镜像加速
### 3.4.8 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)
### 添加内核参数
### 3.4.9 添加内核参数
如果在 CentOS 使用 Docker 看到下面的这些警告信息
@@ -213,7 +213,7 @@ EOF
$ sudo sysctl -p
```
### 参考文档
### 3.4.10 参考文档
* [Docker 官方 CentOS 安装文档](https://docs.docker.com/engine/install/centos/)。
* https://firewalld.org/2018/07/nftables-backend

View File

@@ -4,7 +4,7 @@
>警告切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker
### 系统要求
### 3.5.1 系统要求
Docker ARM 架构有着良好的支持
@@ -18,7 +18,7 @@ Docker 支持以下版本的 [Raspberry Pi OS](https://www.raspberrypi.org/softw
**`Raspberry Pi OS` 由树莓派的开发与维护机构[树莓派基金会](https://www.raspberrypi.org/)官方支持,并推荐用作树莓派的首选系统,其基于 `Debian`。
### 使用 APT 安装
### 3.5.2 使用 APT 安装
推荐使用 APT 包管理器进行安装以确保版本的稳定性和安全性
@@ -114,7 +114,7 @@ $ sudo apt-get update
$ sudo apt-get install docker-ce
```
### 使用脚本自动安装
### 3.5.3 使用脚本自动安装
在测试或开发环境中 Docker 官方为了简化安装流程提供了一套便捷的安装脚本Raspberry Pi OS 系统上可以使用这套脚本安装另外可以通过 `--mirror` 选项使用国内源进行安装
@@ -131,7 +131,7 @@ $ sudo sh get-docker.sh --mirror Aliyun
执行这个命令后脚本就会自动的将一切准备工作做好并且把 Docker 的稳定 (stable) 版本安装在系统中
### 启动 Docker
### 3.5.4 启动 Docker
运行以下命令
@@ -140,7 +140,7 @@ $ sudo systemctl enable docker
$ sudo systemctl start docker
```
### 建立 docker 用户组
### 3.5.5 建立 docker 用户组
默认情况下`docker` 命令会使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 与 Docker 引擎通讯。而只有 `root` 用户和 `docker` 组的用户才可以访问 Docker 引擎的 Unix socket。出于安全考虑一般 Linux 系统上不会直接使用 `root` 用户。因此,更好地做法是将需要使用 `docker` 的用户加入 `docker` 用户组。
@@ -158,7 +158,7 @@ $ sudo usermod -aG docker $USER
退出当前终端并重新登录进行如下测试
### 测试 Docker 是否安装正确
### 3.5.6 测试 Docker 是否安装正确
运行以下命令
@@ -197,6 +197,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/)。
### 镜像加速
### 3.5.7 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)

View File

@@ -8,11 +8,11 @@
![Docker-offile-install-top](../_images/image-20200412202617411.png)
### 概述
### 3.6.1 概述
总体概述了以下内容
### CentOS/Rocky/AlmaLinux 离线安装 Docker
### 3.6.2 CentOS/Rocky/AlmaLinux 离线安装 Docker
在无法连接外网的安全环境中离线安装是唯一的选择本节介绍如何在 RHEL 系发行版中进行离线安装

View File

@@ -2,11 +2,11 @@
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 系统要求
### 3.7.1 系统要求
[Docker Desktop for Mac](https://docs.docker.com/docker-for-mac/) 要求系统最低为 macOS Sonora 14.0 或更高版本,建议升级到最新版本的 macOS。
### 安装
### 3.7.2 安装
Docker Desktop Mac 用户提供了无缝的 Docker 体验你可以选择使用 Homebrew 或手动下载安装包进行安装
@@ -28,7 +28,7 @@ $ brew install --cask docker
![](../_images/install-mac-dmg.png)
### 运行
### 3.7.3 运行
从应用中找到 Docker 图标并点击运行
@@ -66,10 +66,10 @@ $ docker stop webserver
$ docker rm webserver
```
### 镜像加速
### 3.7.4 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)
### 参考链接
### 3.7.5 参考链接
* [官方文档](https://docs.docker.com/desktop/setup/install/mac-install/)

View File

@@ -2,11 +2,11 @@
Windows 平台上Docker Desktop 提供了完整的 Docker 开发环境本节介绍在 Windows 10/11 上的安装和配置
### 系统要求
### 3.8.1 系统要求
[Docker Desktop for Windows](https://docs.docker.com/desktop/setup/install/windows-install/) 支持 64 位版本的 Windows 11 或 Windows 10 (需开启 Hyper-V),推荐使用 Windows 11。
### 安装
### 3.8.2 安装
**手动下载安装**
@@ -20,11 +20,11 @@
$ winget install Docker.DockerDesktop
```
### WSL2 运行 Docker
### 3.8.3 WSL2 运行 Docker
若你的 Windows 版本为 Windows 10 专业版或家庭版 v1903 及以上版本可以使用 WSL2 运行 Docker具体请查看 [Docker Desktop WSL 2 backend](https://docs.docker.com/docker-for-windows/wsl/)。
### 运行
### 3.8.4 运行
Windows 搜索栏输入 **Docker** 点击 **Docker Desktop** 开始运行
@@ -38,11 +38,11 @@ Docker 启动之后会在 Windows 任务栏出现鲸鱼图标。
> 推荐使用 [Windows Terminal](https://docs.microsoft.com/zh-cn/windows/terminal/get-started) 在终端使用 Docker。
### 镜像加速
### 3.8.5 镜像加速
如果在使用过程中发现拉取 Docker 镜像十分缓慢可以配置 Docker [国内镜像加速](3.9_mirror.md)
### 参考链接
### 3.8.6 参考链接
* [官方文档](https://docs.docker.com/desktop/setup/install/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/)

View File

@@ -4,7 +4,7 @@
> **注意**镜像加速器的可用性经常变化配置前请先访问 [docker-practice/docker-registry-cn-mirror-test](https://github.com/docker-practice/docker-registry-cn-mirror-test/actions) 查看各镜像站的实时状态。
### 推荐配置方案
### 3.9.1 推荐配置方案
针对不同的使用场景我们推荐以下几种镜像加速配置方案以确保最佳的拉取速度
@@ -18,7 +18,7 @@
> `hub.atomgit.com` 仅包含部分官方镜像可以满足初学者的使用
### Ubuntu 22.04+Debian 12+Rocky/Alma/CentOS Stream 9+
### 3.9.2 Ubuntu 22.04+Debian 12+Rocky/Alma/CentOS Stream 9+
目前主流 Linux 发行版均已使用 [systemd](https://systemd.io/) 进行服务管理,这里介绍如何在使用 systemd 的 Linux 发行版中配置镜像加速器。
@@ -49,7 +49,7 @@ $ sudo systemctl daemon-reload
$ sudo systemctl restart docker
```
### Windows 10/11
### 3.9.3 Windows 10/11
对于使用 `Windows 10/11` 的用户在任务栏托盘 Docker 图标内右键菜单选择 `Change settings`打开配置窗口后在左侧导航菜单选择 `Docker Engine`在右侧像下边一样编辑 json 文件之后点击 `Apply & Restart` 保存后 Docker 就会重启并应用配置的镜像地址了
@@ -61,7 +61,7 @@ $ sudo systemctl restart docker
}
```
### macOS
### 3.9.4 macOS
对于使用 macOS 的用户在任务栏点击 Docker Desktop 应用图标 -> `Settings...`在左侧导航菜单选择 `Docker Engine`在右侧像下边一样编辑 json 文件修改完成之后点击 `Apply & restart` 按钮Docker 就会重启并应用配置的镜像地址了
@@ -73,7 +73,7 @@ $ sudo systemctl restart docker
}
```
### 检查加速器是否生效
### 3.9.5 检查加速器是否生效
执行 `$ docker info`如果从结果中看到了如下内容说明配置成功
@@ -82,7 +82,7 @@ Registry Mirrors:
https://hub.atomgit.com/
```
### Kubernetes 官方镜像地址迁移
### 3.9.6 Kubernetes 官方镜像地址迁移
可以登录[阿里云容器镜像服务](https://www.aliyun.com/product/acr?source=5176.11533457&userCode=8lx5zmtu&type=copy)**镜像中心**->**镜像搜索** 查找。
@@ -94,7 +94,7 @@ Kubernetes 社区已将官方镜像地址从 `k8s.gcr.io` 迁移到 `registry.k8
$ docker pull registry.k8s.io/xxx
```
### 不再提供服务的镜像
### 3.9.7 不再提供服务的镜像
某些镜像不再提供服务添加无用的镜像加速器会拖慢镜像拉取速度你可以从镜像配置列表中删除它们
@@ -106,7 +106,7 @@ $ docker pull registry.k8s.io/xxx
建议 **watch (页面右上角)** [镜像测试](https://github.com/docker-practice/docker-registry-cn-mirror-test)这个 GitHub 仓库,我们会在此更新各个镜像地址的状态。
### 云服务商
### 3.9.8 云服务商
某些云服务商提供了 **仅供内部** 访问的镜像服务当您的 Docker 运行在云平台时可以选择它们