ehlxr/docker_practice
1
0
Fork 0
mirror of https://github.com/yeasy/docker_practice.git synced 2026-03-11 20:31:18 +00:00
Code Issues Projects Releases Wiki Activity

style(docs): standardize heading formats and numbering

Browse Source 
- 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
Download Patch File Download Diff File Expand all files Collapse all files

46
08_data_network/network/README.md
View File

@@ -2,7 +2,7 @@
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
## Docker 网络概述
## 8.6 Docker 网络概述
Docker 容器需要网络来：
@@ -12,7 +12,7 @@ Docker 容器需要网络来：
Docker 在安装时会自动配置网络基础设施，大多数情况下开箱即用。
## 默认网络架构
## 8.6 默认网络架构
Docker 启动时自动创建以下网络组件：
@@ -39,7 +39,7 @@ graph TD
Internet((互联网)) <--> eth0
```
### 核心组件
### 8.6.1 核心组件
相关信息如下表：
@@ -50,7 +50,7 @@ graph TD
| **容器 eth0** | 容器内的网卡 |
| **IP 地址** | 自动从 172.17.0.0/16 网段分配 |
### 数据流向
### 8.6.2 数据流向
如下代码块所示，展示了相关示例：
@@ -74,7 +74,7 @@ flowchart LR
---
## Docker 网络类型
## 8.6 Docker 网络类型
查看默认网络：
@@ -96,11 +96,11 @@ ghi789... none null local
---
## 用户自定义网络 (推荐)
## 8.6 用户自定义网络 (推荐)
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
### 为什么要用自定义网络
### 8.6.1 为什么要用自定义网络
默认 bridge 网络的局限：
@@ -110,7 +110,7 @@ ghi789... none null local
| 所有容器在同一网络 | 更好的隔离性 |
| 需要 --link (已废弃)| 原生支持服务发现 |
### 创建自定义网络
### 8.6.2 创建自定义网络
运行以下命令：
@@ -124,7 +124,7 @@ $ docker network create mynet
$ docker network inspect mynet
```
### 使用自定义网络
### 8.6.3 使用自定义网络
运行以下命令：
@@ -141,7 +141,7 @@ PING db (172.18.0.3): 56 data bytes
64 bytes from 172.18.0.3: seq=0 ttl=64 time=0.083 ms
```
### 容器名 DNS 解析
### 8.6.4 容器名 DNS 解析
自定义网络自动提供 DNS 服务：
@@ -155,11 +155,11 @@ flowchart LR
---
## 容器互联
## 8.6 容器互联
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
### 同一网络内的容器
### 8.6.1 同一网络内的容器
同一自定义网络内的容器可以直接通信：
@@ -178,7 +178,7 @@ $ docker run -d --name app --network app-net myapp
...
```
### 连接到多个网络
### 8.6.2 连接到多个网络
一个容器可以连接到多个网络：
@@ -196,7 +196,7 @@ $ docker network connect backend multi-net-container
$ docker inspect multi-net-container --format '{{json .NetworkSettings.Networks}}'
```
### ⚠️ --link 已废弃
### 8.6.3 ⚠️ --link 已废弃
运行以下命令：
@@ -214,11 +214,11 @@ $ docker run --network mynet --name app myapp
---
## 端口映射
## 8.6 端口映射
容器默认只能在 Docker 网络内访问。要从外部访问容器，需要端口映射：
### 基本语法
### 8.6.1 基本语法
运行以下命令：
@@ -228,7 +228,7 @@ $ docker run --network mynet --name app myapp
$ docker run -d -p 8080:80 nginx
```
### 映射方式
### 8.6.2 映射方式
相关信息如下表：
@@ -240,7 +240,7 @@ $ docker run -d -p 8080:80 nginx
| `-p 127.0.0.1:8080:80` | 只绑定本地 | 仅本机可访问 |
| `-p 8080:80/udp` | UDP 端口 | UDP 协议 |
### 查看端口映射
### 8.6.3 查看端口映射
运行以下命令：
@@ -249,7 +249,7 @@ $ docker port mycontainer
80/tcp -> 0.0.0.0:8080
```
### 端口映射示意图
### 8.6.4 端口映射示意图
如下代码块所示，展示了相关示例：
@@ -261,7 +261,7 @@ flowchart TD
---
## 网络隔离
## 8.6 网络隔离
不同网络之间默认隔离：
@@ -289,7 +289,7 @@ ping: db: Name or service not known
---
## 常用命令
## 8.6 常用命令
运行以下命令：
@@ -325,7 +325,7 @@ $ docker network prune
---
## 本章小结
## 8.6 本章小结
相关信息如下表：
@@ -337,7 +337,7 @@ $ docker network prune
| **网络隔离** | 不同网络默认隔离，增强安全性 |
| **--link** | 已废弃，使用自定义网络替代 |
## 延伸阅读
## 8.6 延伸阅读
- [配置 DNS](dns.md)：自定义 DNS 设置
- [端口映射](port_mapping.md)：高级端口配置

12
08_data_network/network/dns.md
View File

@@ -1,8 +1,8 @@
## 配置 DNS
## 8.7 配置 DNS
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
### 容器的 DNS 机制
### 8.7.1 容器的 DNS 机制
Docker 容器的 DNS 配置有两种情况：
@@ -11,7 +11,7 @@ Docker 容器的 DNS 配置有两种情况：
---
### 嵌入式 DNS
### 8.7.2 嵌入式 DNS
这是 Docker 网络最强大的功能之一。在自定义网络中，容器可以通过 “名字” 找到彼此，而不需要知道对方的 IP (因为 IP 可能会变)。
@@ -36,7 +36,7 @@ Docker 守护进程在 `127.0.0.11` 运行了一个 DNS 服务器。容器内的
---
### 配置 DNS 参数
### 8.7.3 配置 DNS 参数
如果你需要手动配置容器的 DNS (例如使用内网 DNS 服务器)，可以在 `docker run` 中使用以下参数：
@@ -67,7 +67,7 @@ $ docker run -h myweb nginx
---
### 全局 DNS 配置
### 8.7.4 全局 DNS 配置
如果希望所有容器都使用特定的 DNS 服务器 (而不是继承宿主机)，可以修改 `/etc/docker/daemon.json`：
@@ -84,7 +84,7 @@ $ docker run -h myweb nginx
---
### 常见问题
### 8.7.5 常见问题
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：

12
08_data_network/network/port_mapping.md
View File

@@ -1,8 +1,8 @@
## 外部访问容器
## 8.8 外部访问容器
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
### 为什么要映射端口
### 8.8.1 为什么要映射端口
容器运行在自己的隔离网络环境中 (通常是 Bridge 模式)。这意味着：
@@ -21,7 +21,7 @@ flowchart TD
---
### 端口映射方式
### 8.8.2 端口映射方式
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
@@ -72,7 +72,7 @@ abc123456 0.0.0.0:49153->80/tcp
---
### 查看端口映射
### 8.8.3 查看端口映射
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
@@ -101,7 +101,7 @@ abc123456 nginx 0.0.0.0:8080->80/tcp web
---
### 最佳实践与安全
### 8.8.4 最佳实践与安全
本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
@@ -139,7 +139,7 @@ $ docker run -d -p 53:53/udp dns-server
---
### 实现原理
### 8.8.5 实现原理
Docker 使用 `docker-proxy` 进程 (用户态) 或 `iptables` DNAT 规则 (内核态) 来实现端口转发。

6
08_data_network/network/summary.md
View File

@@ -1,4 +1,4 @@
## 本章小结
## 8.9 本章小结
相关信息如下表：
@@ -8,7 +8,7 @@
| **自定义网络** | Docker 嵌入式 DNS | ✅ 支持容器名解析 |
| **手动指定** | 使用 `--dns` | 覆盖默认配置 |
### 延伸阅读
### 8.9.1 延伸阅读
- [网络模式](README.md)：Docker 网络概览
- [端口映射](port_mapping.md)：外部访问
@@ -20,7 +20,7 @@
| **安全性** | 默认监听所有 IP，敏感服务应绑定 `127.0.0.1` |
| **查看** | 使用 `docker port` 或 `docker ps` |
### 延伸阅读
### 8.9.2 延伸阅读
- [EXPOSE 指令](../../07_dockerfile/7.9_expose.md)：在 Dockerfile 中声明端口
- [网络模式](README.md)：Host 模式不需要端口映射