Fix and update

2026-03-10 11:54:37 +00:00 · 2026-02-09 11:34:35 -08:00
parent e669ee0fe8
commit 63377d0431
136 changed files with 2146 additions and 262 deletions
--- a/03_install/3.10_experimental.md
+++ b/03_install/3.10_experimental.md
@@ -4,6 +4,8 @@

 ### Docker CLI 的实验特性

+CLI 的实验特性通常包含仍在开发中的新功能。幸运的是，在较新版本中这些特性已经更加易用。
+
 从 `v20.10` 版本开始，Docker CLI 所有实验特性的命令均默认开启，无需再进行配置或设置系统环境变量。

 ### 开启 dockerd 的实验特性
--- a/03_install/3.1_ubuntu.md
+++ b/03_install/3.1_ubuntu.md
@@ -1,9 +1,17 @@
 ## Ubuntu 安装 Docker

+## Ubuntu 安装 Docker
+
+Ubuntu 是 Docker 最常用的运行环境之一。本节将介绍如何在 Ubuntu 系统上安装 Docker，并配置国内镜像加速。
+
 >警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker.

 ### 准备工作

+### 准备工作
+
+在开始安装之前，我们需要确认系统版本是否满足要求，并清理可能存在的旧版本。
+
 #### 系统要求

 Docker 支持诸多版本的 [Ubuntu](https://ubuntu.com/server) 操作系统。但是较旧的版本上将不会有 Docker 新版本的持续更新，以截至 2026 年初的几个 Ubuntu LTS（Long Term Support，长期支持）版本为例：
@@ -57,6 +65,7 @@ $ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --


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

@@ -69,9 +78,14 @@ $ echo \


 ## 官方源
+
 ## $ 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
+
+## $（lsb_release -cs） stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+
+
 ```

 >以上命令会添加稳定版本的 Docker APT 镜像源，如果需要测试版本的 Docker 请将 stable 改为 test。
@@ -94,15 +108,20 @@ $ sudo apt install docker-ce docker-ce-cli containerd.io

 ```bash
 ## $ 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
+
+
 ```

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

 ### 启动 Docker

+运行以下命令：
+
 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
@@ -128,6 +147,8 @@ $ sudo usermod -aG docker $USER

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

+运行以下命令：
+
 ```bash
 $ docker run --rm hello-world

--- a/03_install/3.2_debian.md
+++ b/03_install/3.2_debian.md
@@ -1,9 +1,17 @@
 ## Debian 安装 Docker

+## Debian 安装 Docker
+
+Debian 以其稳定性著称，是 Docker 的理想宿主系统。本节将指导你在 Debian 上完成 Docker 的安装。
+
 >警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker.

 ### 准备工作

+### 准备工作
+
+安装前请仔细检查 Debian 版本支持情况，并卸载旧版本以避免冲突。
+
 #### 系统要求

 Docker 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统：
@@ -46,7 +54,10 @@ $ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo gpg --


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

 然后，我们需要向 `sources.list` 中添加 Docker 软件源：
@@ -60,9 +71,13 @@ $ echo \


 ## 官方源
+
 ## $ 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
+
+## $（lsb_release -cs） stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+

 ```

@@ -86,15 +101,20 @@ $ sudo apt-get install docker-ce docker-ce-cli containerd.io

 ```bash
 ## $ 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
+
+
 ```

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

 ### 启动 Docker

+运行以下命令：
+
 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
@@ -120,6 +140,8 @@ $ sudo usermod -aG docker $USER

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

+运行以下命令：
+
 ```bash
 $ docker run --rm hello-world

--- a/03_install/3.3_fedora.md
+++ b/03_install/3.3_fedora.md
@@ -1,9 +1,17 @@
 ## Fedora 安装 Docker

+## Fedora 安装 Docker
+
+Fedora 作为技术前沿的 Linux 发行版，对 Docker 有着良好的支持。本节介绍在 Fedora 上的安装步骤。
+
 >警告：切勿在没有配置 Docker dnf 源的情况下直接使用 dnf 命令安装 Docker.

 ### 准备工作

+### 准备工作
+
+确保你的 Fedora 版本在支持列表中，并清理旧版本。
+
 #### 系统要求

 Docker 支持以下版本的 [Fedora](https://getfedora.org/) 操作系统：
@@ -31,6 +39,10 @@ $ sudo dnf remove docker \

 ### 使用 dnf 安装

+### 使用 dnf 安装
+
+使用 dnf 包管理器安装是推荐的方式，便于后续的更行和管理。
+
 执行以下命令安装依赖包：

 ```bash
@@ -49,9 +61,14 @@ $ 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
+
+
 ```

 如果需要测试版本的 Docker 请使用以下命令：
@@ -87,21 +104,26 @@ $ sudo dnf -y install docker-ce-18.06.1.ce

 ### 使用脚本自动安装

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

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

 ```bash
 ## $ 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
+
+
 ```

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

 ### 启动 Docker

+运行以下命令：
+
 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
@@ -127,6 +149,8 @@ $ sudo usermod -aG docker $USER

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

+运行以下命令：
+
 ```bash
 $ docker run --rm hello-world

--- a/03_install/3.4_centos.md
+++ b/03_install/3.4_centos.md
@@ -1,12 +1,20 @@
 ## CentOS 安装 Docker

+## CentOS 安装 Docker
+
+CentOS（及其替代品 Rocky Linux、AlmaLinux）是企业级服务器常用的操作系统。本节介绍在这些系统上安装 Docker 的步骤。
+
 >警告：切勿在没有配置 Docker YUM 源的情况下直接使用 yum 命令安装 Docker.

 ### 准备工作

+### 准备工作
+
+安装前请确认系统版本和内核版本满足 Docker 的运行要求。
+
 #### 系统要求

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

 Docker 支持 64 位版本 CentOS Stream 9、Rocky Linux 8/9、AlmaLinux 8/9，并且要求内核版本不低于 3.10。

@@ -33,6 +41,10 @@ $ sudo yum remove docker \

 ### 使用 yum 安装

+### 使用 yum 安装
+
+使用 yum/dnf 安装是管理 Docker 生命周期的标准方式。
+
 执行以下命令安装依赖包：

 ```bash
@@ -51,9 +63,14 @@ $ 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
+
+
 ```

 如果需要测试版本的 Docker 请执行以下命令：
@@ -78,6 +95,7 @@ $ sudo dnf install docker-ce docker-ce-cli containerd.io

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

@@ -97,15 +115,20 @@ $ firewall-cmd --reload

 ```bash
 ## $ 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
+
+
 ```

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

 ### 启动 Docker

+运行以下命令：
+
 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
@@ -131,6 +154,8 @@ $ sudo usermod -aG docker $USER

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

+运行以下命令：
+
 ```bash
 $ docker run --rm hello-world

--- a/03_install/3.5_raspberry-pi.md
+++ b/03_install/3.5_raspberry-pi.md
@@ -1,9 +1,15 @@
 ## 树莓派卡片电脑安装 Docker

+## 树莓派卡片电脑安装 Docker
+
+树莓派等 ARM 架构设备在物联网和边缘计算领域应用广泛。本节介绍如何在树莓派上安装 Docker。
+
 >警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker.

 ### 系统要求

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

 Docker 支持以下版本的 [Raspberry Pi OS](https://www.raspberrypi.org/software/operating-systems/) 操作系统：
@@ -16,6 +22,8 @@ Docker 支持以下版本的 [Raspberry Pi OS](https://www.raspberrypi.org/softw

 ### 使用 APT 安装

+推荐使用 APT 包管理器进行安装，以确保版本的稳定性和安全性。
+
 由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。

 ```bash
@@ -39,7 +47,10 @@ $ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/raspbian/gpg | sudo apt-


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

 然后，我们需要向 `sources.list` 中添加 Docker 软件源：
@@ -52,15 +63,21 @@ $ sudo add-apt-repository \


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

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

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

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

@@ -84,7 +101,10 @@ $ sudo echo "deb [arch=armhf] https://mirrors.aliyun.com/docker-ce/linux/raspbia


 ## 官方源
-## $ 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
@@ -105,15 +125,20 @@ $ sudo apt-get install docker-ce

 ```bash
 ## $ 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
+
+
 ```

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

 ### 启动 Docker

+运行以下命令：
+
 ```bash
 $ sudo systemctl enable docker
 $ sudo systemctl start docker
@@ -139,6 +164,8 @@ $ sudo usermod -aG docker $USER

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

+运行以下命令：
+
 ```bash
 $ docker run --rm hello-world

--- a/03_install/3.6_offline.md
+++ b/03_install/3.6_offline.md
@@ -10,13 +10,17 @@

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

+在无法连接外网的安全环境中，离线安装是唯一的选择。本节介绍如何在 RHEL 系发行版中进行离线安装。
+
 > 注意：以下命令以 CentOS 7 为例。对于 CentOS Stream 9、Rocky Linux 9 或 AlmaLinux 9，请将 `yum` 替换为 `dnf`，并将软件包后缀 `el7` 替换为 `el9`。

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

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

-##### 查询可用的软件版本(A)
+##### 查询可用的软件版本（A）
+
+运行以下命令：

 ```bash
 #下载清华的镜像源文件
@@ -43,7 +47,9 @@ 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 +84,7 @@ Total
 exiting because "Download Only" specified
 ```

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

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

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

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

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

@@ -147,15 +153,20 @@ sudo yum versionlock delete all

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

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

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

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

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

+运行以下命令：
+
 ```bash
 ## 安装apache 服务器
+
 yum install httpd -y
 ## 挂载光盘
+
 mount /dev/cdrom /mnt
 ## 新建centos目录
+
 mkdir /var/www/html/base
 ## 复制光盘内的文件到刚才新建的目录
+
 cp -R /mnt/Packages/* /var/www/html/base/
 createrepo  /var/www/html/centos/
 systemctl enable httpd
@@ -194,14 +212,17 @@ systemctl start httpd

 ```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目录
+
 mkdir /tmp/docker-ce/
 ## 把镜像源同步到镜像文件中
+
 reposync -r docker-ce-stable -p /tmp/docker-ce/
 ```

@@ -211,18 +232,23 @@ reposync -r docker-ce-stable -p /tmp/docker-ce/

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

 ##### 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服务器地址
+
 baseurl=http://x.x.x.x/base
 enable=1
 gpgcheck=0
@@ -230,6 +256,7 @@ proxy=_none_
 [docker_ce]
 name=docker_ce
 ## 改成B服务器地址
+
 baseurl=http://x.x.x.x/base
 enable=1
 gpgcheck=0
@@ -240,6 +267,8 @@ EOF

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

+运行以下命令：
+
 ```bash
 sudo yum makecache fast
 sudo yum install docker-ce docker-ce-cli containerd.io
--- a/03_install/3.7_mac.md
+++ b/03_install/3.7_mac.md
@@ -6,6 +6,8 @@

 ### 安装

+Docker Desktop 为 Mac 用户提供了无缝的 Docker 体验。你可以选择使用 Homebrew 或手动下载安装包进行安装。
+
 #### 使用 Homebrew 安装

 [Homebrew](https://brew.sh/) 的 [Cask](https://github.com/Homebrew/homebrew-cask) 已经支持 Docker Desktop for Mac，因此可以很方便的使用 Homebrew Cask 来进行安装：
--- a/03_install/3.8_windows.md
+++ b/03_install/3.8_windows.md
@@ -1,5 +1,7 @@
 ## Windows 10/11

+在 Windows 平台上，Docker Desktop 提供了完整的 Docker 开发环境。本节介绍在 Windows 10/11 上的安装和配置。
+
 ### 系统要求

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

 下载好之后双击 `Docker Desktop Installer.exe` 开始安装。

-**使用** [**winget**](https://docs.microsoft.com/zh-cn/windows/package-manager/) **安装**
+**使用**[**winget**](https://docs.microsoft.com/zh-cn/windows/package-manager/)**安装**

 ```powershell
 $ winget install Docker.DockerDesktop
@@ -24,7 +26,7 @@ $ winget install Docker.DockerDesktop

 ### 运行

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

 ![](../_images/install-win-docker-app-search.png)

--- a/03_install/3.9_mirror.md
+++ b/03_install/3.9_mirror.md
@@ -6,6 +6,8 @@

 ### 推荐配置方案

+针对不同的使用场景，我们推荐以下几种镜像加速配置方案，以确保最佳的拉取速度。
+
 1. **云服务器用户**：优先使用所在云平台提供的内部加速器（见本页末尾）
 2. **本地开发用户**：使用阿里云个人加速器或其他可用的公共加速器
 3. **代理方案**：如有条件，可配置 HTTP 代理直接访问 Docker Hub
@@ -82,7 +84,7 @@ Registry Mirrors:

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

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

 例如 `k8s.gcr.io/coredns:1.6.7` 镜像可以用 `registry.cn-hangzhou.aliyuncs.com/google_containers/coredns:1.6.7` 代替。

--- a/03_install/README.md
+++ b/03_install/README.md
@@ -3,3 +3,17 @@
 Docker 分为 `stable` `test` 和 `nightly` 三个更新频道。

 官方网站上有各种环境下的 [安装指南](https://docs.docker.com/get-docker/)，这里主要介绍 Docker 在 `Linux` 、`Windows 10` 和 `macOS` 上的安装。
+
+## 详细安装指南
+
+* [Ubuntu](3.1_ubuntu.md)
+* [Debian](3.2_debian.md)
+* [Fedora](3.3_fedora.md)
+* [CentOS](3.4_centos.md)
+* [Raspberry Pi](3.5_raspberry-pi.md)
+* [Linux 离线安装](3.6_offline.md)
+* [macOS](3.7_mac.md)
+* [Windows 10/11](3.8_windows.md)
+* [镜像加速器](3.9_mirror.md)
+* [开启实验特性](3.10_experimental.md)
+