书籍定位与目标读者

本仓库是一本以 GitBook 形式组织的开源 Docker 技术书籍，项目原名为《Docker — 从入门到实践》，后更名为《Docker 实战》。全书以中文撰写，覆盖从容器基础概念到 Kubernetes、容器云、源码解析等进阶主题，旨在为开发者提供一条从零起步、循序渐进的 Docker 学习路径。资料来源：README.md:1-40

书籍的目标读者主要包括：

• 后端与运维工程师：希望在生产环境落地容器化技术的从业人员。
• DevOps 学习者：需要系统化理解 Docker 与周边生态（如 Compose、Swarm、Kubernetes）的读者。
• 计算机相关专业学生：希望通过一本书完成 Docker 入门与实战的初学者。

由于内容为中文，社区多次收到希望提供英文译版的请求，Issue #363 与 #510 均围绕 “english translation” 展开讨论，这也反映了该书在海外华人及翻译辅助学习群体中的影响力。资料来源：README.md:1-40

整体目录结构与编排思路

全书采用"章—节"两级结构，SUMMARY.md 是整本书的目录索引，决定了章节顺序与层级。整本书大体分为以下几大模块：

资料来源：SUMMARY.md:1-150

这种从"概念 → 安装 → 基础 → 进阶 → 生态 → 源码"的递进结构，使得读者可以在每一阶段巩固前序知识，再进入更高阶的主题。

推荐学习路径

第一章节的 01_introduction/README.md 为初学者提供了明确的开篇指引，建议读者按以下顺序进入：

1. 快速体验（1.1_quickstart.md）：无需安装 Docker，直接在 Play with Docker 等在线环境中跑通第一个容器，建立感性认识。资料来源：01_introduction/1.1_quickstart.md:1-60
2. 认识 Docker（1.2_what.md）：理解 Docker 的本质——一种操作系统层面的虚拟化方案，以及它与虚拟机的差异。资料来源：01_introduction/1.2_what.md:1-80
3. 理解 Docker 价值（1.3_why.md）：从交付、部署、隔离、效率等维度回答"为什么要用 Docker"。资料来源：01_introduction/1.3_why.md:1-80

完成入门篇后，应优先掌握安装与基础使用章节，因为容器、镜像、网络等概念会贯穿后续所有内容。在基础牢固后，可按需选择方向：关注应用编排的读者重点学习 Docker Compose（06 章）；关注集群与生产部署的读者应学习 Swarm（07 章）或 Kubernetes（11 章）；希望深入原理的读者可阅读源码与底层实现章节（14、15 章）。

graph TD
    A[入门篇: 概念与快速体验] --> B[安装篇: 多平台部署]
    B --> C[基础使用: 镜像/容器/网络/数据卷]
    C --> D{方向选择}
    D --> E[Compose 单机编排]
    D --> F[Swarm/K8s 集群]
    D --> G[底层原理与源码]
    E --> H[实战案例与附录]
    F --> H
    G --> H

需要注意的是，社区中曾反馈部分平台的安装指令存在拼写错误或过时问题，例如 Issue #461 指出 Ubuntu 安装步骤中的拼写错误，Issue #484 报告 macOS brew 安装指令错误。读者在按路径学习时，建议同时参考官方文档核对安装命令。资料来源：README.md:1-40

项目状态与社区反馈

截至最新公开版本 v1.11.0，书籍已经过多个版本的迭代更新，主要变化集中在 Kubernetes 章节内容扩充、Compose V2 语法更新以及新平台（如 Apple Silicon）安装说明补充。资料来源：README.md:1-40

关于许可证，社区在 Issue #394 中提问"What is the license of this repo?"，希望基于本书进行二次创作，作者随后在仓库中补充了明确的许可证声明，便于读者合法地引用与再发行内容。

综合来看，本书既可作为系统化的 Docker 入门教材，也可作为随时翻阅的工具书。读者只需按照"入门 → 安装 → 基础 → 进阶 → 生态"的路径循序渐进，即可在数十小时内建立完整的 Docker 知识体系，并具备向 Kubernetes 等容器编排平台迁移的能力。资料来源：SUMMARY.md:1-150

概述与适用范围

03_install/ 目录是仓库的核心章节之一，专门面向读者交付 Docker Engine 在不同操作系统下的安装流程。章节入口 03_install/README.md 充当导航索引，按平台聚合 Ubuntu、Debian、Fedora、CentOS、Raspberry Pi 等多个子章节，使读者可以按目标主机操作系统快速定位安装步骤。

安装章节采用统一的结构化写法：先介绍前置环境与系统要求，再给出 apt、dnf、yum 等发行版包管理命令，最后补充镜像加速、验证安装、卸载等可操作步骤。这种"一平台一文件"的拆分方式降低了章节间耦合，便于社区贡献者单独更新某一平台的安装说明。

资料来源：03_install/README.md:1-20

Linux 主流发行版安装

Ubuntu / Debian（基于 APT）

03_install/3.1_ubuntu.md 与 03_install/3.2_debian.md 描述了基于 Debian 系的安装路径，推荐流程为先卸载旧版本（如 docker、docker-engine、docker.io），然后添加 Docker 官方 GPG 密钥与 APT 源，再通过 apt-get update && apt-get install docker-ce 完成安装。两个平台共享了几乎相同的源配置模板，仅在 lsb_release -cs 输出的发行版代号（如 focal、jammy、bullseye、bookworm）上存在差异。

两个章节共同强调：若使用国内网络环境，应配置镜像仓库（如阿里云、中科大）以加速 docker-ce 及其依赖下载。这是社区高频反馈点——在 Issue #461 中，用户报告 Ubuntu 安装文档存在拼写问题，仓库维护者通过更新源配置脚本进行了修正。

资料来源：03_install/3.1_ubuntu.md:1-40、03_install/3.2_debian.md:1-40

Fedora / CentOS（基于 DNF/YUM）

03_install/3.3_fedora.md 与 03_install/3.4_centos.md 覆盖了 Red Hat 系发行版。Fedora 章节使用 dnf 包管理器，CentOS 章节考虑到 CentOS 7 / CentOS 8 共存的历史背景，分别给出了 yum（EL7）与 dnf（EL8）两条安装路径。两个文件均通过 yum-config-manager --add-repo 添加 docker-ce.repo，并利用 --setopt=install_weak_deps=False 避免安装非必要依赖。

需要特别注意：CentOS 章节明确指出 Docker 官方支持的是 CentOS Stream 或第三方维护的 RHEL 兼容发行版，而非已停止维护的 CentOS Linux 8，这与发行版生命周期密切相关。

资料来源：03_install/3.3_fedora.md:1-30、03_install/3.4_centos.md:1-30

ARM 平台：树莓派

03_install/3.5_raspberry-pi.md 面向 Raspberry Pi 系列设备，安装方式与 Debian/Ubuntu 章节高度相似，但额外强调两点：一是必须确认树莓派 CPU 架构（ARMv7 / ARMv8）以选择正确的 docker-ce 二进制包；二是官方推荐使用 Raspberry Pi OS（基于 Debian）而非其他第三方系统，以避免内核兼容性问题。

该章节还提示用户在烧录完系统镜像后，通过 uname -m 验证架构，并准备 swap 分区以应对低内存场景下的 OOM 风险。

资料来源：03_install/3.5_raspberry-pi.md:1-30

跨平台通用事项与社区反馈

安装后验证

所有平台章节末尾均包含统一的验证流程：执行 docker version 查看客户端与服务端版本，并通过 docker run hello-world 拉取并运行测试镜像以验证守护进程与网络链路可用性。03_install/README.md 在章节索引中将这一验证流程作为读者自查清单。

镜像加速与代理

考虑到国内网络环境，03_install/3.1_ubuntu.md 与 03_install/3.4_centos.md 均提供了 /etc/docker/daemon.json 的镜像加速配置模板，通过 registry-mirrors 字段写入阿里云、腾讯云等镜像地址，并要求执行 systemctl reload docker 使配置生效。

已知问题与社区讨论

• Issue #484 报告 macOS 通过 brew 安装 Docker 时存在指令错误，安装章节虽未直接覆盖 macOS（Docker Desktop），但与镜像加速思路相关。
• Issue #394 询问仓库许可证（License），虽与安装无直接关系，但反映了用户希望二次分发文档时对许可条款的关注。

资料来源：03_install/README.md:1-20、03_install/3.1_ubuntu.md:60-80、03_install/3.4_centos.md:60-80

平台速查表

资料来源：03_install/3.1_ubuntu.md:20-40、03_install/3.3_fedora.md:20-40、03_install/3.4_centos.md:20-40、03_install/3.5_raspberry-pi.md:20-40

概述与三大核心概念

Docker 的核心抽象由镜像（Image）、容器（Container）与仓库（Repository）三部分组成，三者相互配合构成了 Docker 的使用闭环。镜像是一个只读的文件系统模板，包含了运行应用所需的代码、运行时、库和配置；容器是镜像的运行实例，在镜像之上叠加一层可写层；仓库则是镜像集中存储与分发的中心。资料来源：02_basic_concept/README.md:1-30

下图给出了三者关系与典型操作流程：

flowchart LR
    R[Registry 仓库] -- docker pull --> I[Image 镜像]
    I -- docker run --> C[Container 容器]
    C -- docker commit --> I
    I -- docker push --> R

镜像采用分层结构与 Union FS，多个镜像可以共享底层，并支持通过 docker tag 添加多个标签。资料来源：02_basic_concept/2.1_image.md:1-40

容器在镜像之上增加了一层薄薄的可写层，所有运行时变更均落在该层；可通过 docker commit 将变更固化回新镜像，也可借助 Dockerfile 重新构建以保证可复现性。资料来源：02_basic_concept/2.2_container.md:1-50

镜像核心操作

镜像操作覆盖「获取—查看—删除—构建—推送」全生命周期。最常用的拉取命令是 docker pull [选项] [Docker Registry 地址[:端口号]/]仓库名[:标签]，例如 docker pull ubuntu:18.04，默认从 Docker Hub 拉取。资料来源：04_image/4.1_pull.md:1-40

常用命令速查：

资料来源：04_image/README.md:1-60

虚悬镜像（<none>:<none>）是常见的清理对象，可通过 docker image prune 一键回收。资料来源：04_image/README.md:20-50

容器核心操作

容器操作分为「创建—启动—进入—停止—删除」等阶段。典型流程为：

1. docker run -it ubuntu:18.04 /bin/bash：新建并启动一个交互式容器。
2. docker ps / docker ps -a：查看运行中或全部容器。
3. docker start / docker restart / docker stop / docker kill：控制容器生命周期。
4. docker exec -it <id> /bin/bash：在已运行的容器中执行命令（推荐方式）。
5. docker rm：删除已停止的容器；docker container prune 清理所有已退出容器。

资料来源：02_basic_concept/2.2_container.md:20-80

守护态运行常使用 -d 参数，并通过 --name 指定名称以便后续管理。导入导出场景可使用 docker export 与 docker import，与镜像的 save/load 形成对照。资料来源：02_basic_concept/2.2_container.md:40-90

仓库核心操作

Docker 仓库分为公共仓库（如 Docker Hub、Quay）与私有仓库（如 Harbor、Docker Registry）。最权威的公共仓库是 Docker Hub，可通过 docker login / docker logout 完成认证。资料来源：02_basic_concept/2.3_repository.md:1-40

推送流程为：先 docker tag 将本地镜像命名为 用户名/仓库名:标签，再执行 docker push 上传；拉取时使用 docker pull 用户名/仓库名:标签。私有仓库需在 daemon.json 中配置 --insecure-registry 或自签证书。资料来源：02_basic_concept/2.3_repository.md:30-70

常见问题与社区关注点

社区中反复出现的请求包括英文翻译、跨平台安装指令（如 macOS brew 安装）以及 Ubuntu 安装文档的拼写错误，间接反映出新手对「先装好 Docker、再使用镜像/容器/仓库」这条主线的强烈需求。资料来源：GitHub Issues #363, #510, #484, #461

掌握上述三类核心操作，即可在本地完成绝大多数 Docker 使用场景，并为进一步学习网络、数据卷与编排打下基础。

概述

在掌握镜像与容器的基础操作后，学习者通常需要进一步深入四大进阶主题：持久化数据管理、容器网络配置、多容器编排与云原生生态工具。这些主题构成了从单机 Docker 使用迈向生产环境部署的关键桥梁，也是社区讨论度最高的核心章节。

资料来源：08_data/README.md:1-15

1. 数据持久化机制

Docker 提供三种主要的数据持久化方案，分别面向不同的使用场景。

Volume（数据卷）

Volume 由 Docker 统一管理，默认存储于 /var/lib/docker/volumes/ 目录下，其优势在于与容器生命周期解耦、支持跨平台使用以及便于备份迁移。

docker volume create my-vol
docker run -d -v my-vol:/app/data nginx

资料来源：08_data/8.1_volume.md:1-30

Bind Mounts（绑定挂载）

Bind Mounts 直接将宿主机上的任意文件或目录挂载到容器中，适合开发调试场景，能实现宿主机与容器之间的实时同步。但其依赖宿主机的目录结构，可移植性较差。

资料来源：08_data/8.2_bind-mounts.md:1-20

tmpfs 挂载

tmpfs 仅存在于内存中，容器停止后数据随即消失，适合存放敏感凭证或临时状态文件，可有效避免敏感信息落入磁盘。

资料来源：08_data/8.3_tmpfs.md:1-25

三种方式对比

2. 容器网络与 DNS

Docker 网络允许容器之间以及容器与外部网络之间进行通信。09_network/README.md 介绍了 bridge、host、overlay、macvlan 等多种网络驱动，分别对应单机、跨主机以及混合云等不同部署需求。

资料来源：09_network/README.md:1-20

自定义 DNS 配置

在 09_network/9.1_dns.md 中，详细说明了如何通过 --dns、--dns-search 与 --dns-opt 参数为容器自定义 DNS 服务器与搜索域，以满足企业内网或混合云场景下的域名解析需求。

docker run -d --dns 8.8.8.8 --dns-search example.com nginx

资料来源：09_network/9.1_dns.md:1-35

3. 容器编排

当应用拆分为多个容器后，需要统一的编排工具进行集中管理。10_orchestration 章节系统覆盖了 Docker Compose、Docker Swarm 与 Kubernetes 等主流方案。

Docker Compose

Docker Compose 通过 docker-compose.yml 文件定义多容器应用，实现一键启动、停止与扩缩容。典型结构包含 services、networks 与 volumes 三个顶层字段，分别用于描述服务依赖、网络拓扑与数据卷声明。

资料来源：10_orchestration/10.1_compose.md:1-40

Swarm 与 Kubernetes

对于更大规模的集群场景，文档进一步介绍了 Swarm 模式下的 Service 与 Stack 概念，以及 Kubernetes 中的 Pod、Deployment 与 Service 等核心抽象。Swarm 与 Docker 引擎深度集成，适合中小型集群；Kubernetes 功能更丰富，是大型生产环境的首选。

资料来源：10_orchestration/README.md:1-25

4. 云原生生态进阶

在 Docker 基础之上，生态中涌现出大量互补工具，可按职责划分为以下几类：

• 镜像构建：BuildKit、Buildx 提供更高效的并行构建与多架构支持
• 镜像仓库：Harbor、Distribution 提供企业级镜像管理与权限控制
• 监控日志：Prometheus、cAdvisor、ELK 构成可观测性体系
• 安全扫描：Trivy、Anchore 用于镜像漏洞扫描与合规审计

这些工具共同构成了完整的容器化技术栈，帮助用户从单一容器走向完整的云原生平台。社区中关于中文翻译请求（#363、#510）以及 macOS 安装问题（#484）等讨论也反映出，用户在接触这些进阶生态工具时，往往希望获得系统化的入门指引与排错支持。

Pitfall Log / 踩坑日志

项目：yeasy/docker_practice

摘要：发现 14 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：安装坑 - 依赖 Docker 环境。

1. 安装坑 · 依赖 Docker 环境

• 严重度：medium
• 证据强度：runtime_trace
• 发现：安装/运行入口包含 Docker 命令：docker run -it --rm -p 4000:80 ccr.ccs.tencentyun.com/dockerpracticesig/docker_practice:vuepress
• 对用户的影响：非工程用户可能没有 Docker，启动成本明显增加。
• 复现命令：docker run -it --rm -p 4000:80 ccr.ccs.tencentyun.com/dockerpracticesig/docker_practice:vuepress
• 证据：identity.distribution | https://github.com/yeasy/docker_practice | docker run -it --rm -p 4000:80 ccr.ccs.tencentyun.com/dockerpracticesig/docker_practice:vuepress

2. 安装坑 · 来源证据：CNCF Meshery Playground - free training resource for docker_practice community

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：CNCF Meshery Playground - free training resource for docker_practice community
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/547 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

3. 安装坑 · 来源证据：English translation for docker practice book

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：English translation for docker practice book
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/510 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

4. 安装坑 · 来源证据：There are several image cannot be displayed in PDF book

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：There are several image cannot be displayed in PDF book
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/568 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

5. 安装坑 · 来源证据：docker compose中关于deploy描述有误

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：docker compose中关于deploy描述有误
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/550 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

6. 安装坑 · 来源证据：文档错误：5.2_daemon.md 中交互模式调试的命令示例错误

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：文档错误：5.2_daemon.md 中交互模式调试的命令示例错误
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/566 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

7. 安装坑 · 来源证据：静态资源文件失效

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：静态资源文件失效
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/562 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

8. 能力坑 · 能力判断依赖假设

• 严重度：medium
• 证据强度：source_linked
• 发现：README/documentation is current enough for a first validation pass.
• 对用户的影响：假设不成立时，用户拿不到承诺的能力。
• 证据：capability.assumptions | https://github.com/yeasy/docker_practice | README/documentation is current enough for a first validation pass.

9. 维护坑 · 维护活跃度未知

• 严重度：medium
• 证据强度：source_linked
• 发现：未记录 last_activity_observed。
• 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
• 证据：evidence.maintainer_signals | https://github.com/yeasy/docker_practice | last_activity_observed missing

• 严重度：medium
• 证据强度：source_linked
• 发现：no_demo
• 证据：downstream_validation.risk_items | https://github.com/yeasy/docker_practice | no_demo; severity=medium

11. 安全/权限坑 · 存在评分风险

• 严重度：medium
• 证据强度：source_linked
• 发现：no_demo
• 对用户的影响：风险会影响是否适合普通用户安装。
• 证据：risks.scoring_risks | https://github.com/yeasy/docker_practice | no_demo; severity=medium

12. 安全/权限坑 · 来源证据：Security: Insecure HTTP script loading enables MITM code injection on site visitors

• 严重度：medium
• 证据强度：source_linked
• 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Security: Insecure HTTP script loading enables MITM code injection on site visitors
• 对用户的影响：可能增加新用户试用和生产接入成本。
• 证据：community_evidence:github | https://github.com/yeasy/docker_practice/issues/560 | 来源类型 github_issue 暴露的待验证使用条件。

13. 维护坑 · issue/PR 响应质量未知

• 严重度：low
• 证据强度：source_linked
• 发现：issue_or_pr_quality=unknown。
• 对用户的影响：用户无法判断遇到问题后是否有人维护。
• 证据：evidence.maintainer_signals | https://github.com/yeasy/docker_practice | issue_or_pr_quality=unknown

14. 维护坑 · 发布节奏不明确

• 严重度：low
• 证据强度：source_linked
• 发现：release_recency=unknown。
• 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
• 证据：evidence.maintainer_signals | https://github.com/yeasy/docker_practice | release_recency=unknown