mirror of
https://github.com/yeasy/docker_practice.git
synced 2026-08-11 00:47:38 +00:00
Refresh install guidance
# Conflicts: # 03_install/3.1_ubuntu.md # 03_install/3.2_debian.md # 03_install/3.3_fedora.md # 03_install/3.9_mirror.md
This commit is contained in:
yeasy
+36
-45
@@ -4,7 +4,7 @@ Debian 以其稳定性著称，是 Docker 的理想宿主系统。本节将指
|
||||
|
||||
### APT 源安装的必要性
|
||||
|
||||
与 Ubuntu 类似，Debian 用户在安装 Docker 时同样应该优先选择 APT 源安装。Debian 对系统稳定性的极致追求，使得通过官方仓库来管理 Docker 生命周期变得尤为重要。特别是在服务器环境，APT 源提供的版本控制和安全更新流程是不可或缺的。
|
||||
与 Ubuntu 类似，Debian 用户在安装 Docker 时同样应该优先选择 Docker 官方 APT 仓库。对于服务器环境，这种方式更利于版本控制、升级和长期维护。
|
||||
|
||||
> 警告：切勿在没有配置 Docker APT 源的情况下直接使用 apt 命令安装 Docker。
|
||||
|
||||
@@ -16,93 +16,84 @@ Debian 以其稳定性著称，是 Docker 的理想宿主系统。本节将指
|
||||
|
||||
Docker 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系统：
|
||||
|
||||
* Debian Trixie 13 (stable，2025 年 8 月发布，当前活跃版本)
|
||||
* Debian Bookworm 12 (oldstable，全面支持至 2026 年 6 月，LTS 至 2028 年 6 月）
|
||||
* Debian Bullseye 11 (LTS 长期支持，支持至 2026 年 8 月 31 日)
|
||||
* Debian Trixie 13 (stable)
|
||||
* Debian Bookworm 12 (oldstable，全面支持至 2026 年 6 月，LTS 至 2028 年 6 月)
|
||||
* Debian Bullseye 11 (oldoldstable，LTS 支持至 2026 年 8 月 31 日)
|
||||
|
||||
> **注意**：Debian Bullseye 11 将于 2026 年 8 月底结束长期支持。建议新部署使用 Bookworm 12 或 Trixie 13。
|
||||
|
||||
#### 卸载旧版本
|
||||
|
||||
旧版本的 Docker 称为 `docker` 或者 `docker-engine`，使用以下命令卸载旧版本：
|
||||
Docker 官方建议先卸载可能冲突的非官方软件包：
|
||||
|
||||
```bash
|
||||
$ sudo apt-get remove docker \
|
||||
docker-engine \
|
||||
docker.io
|
||||
$ for pkg in docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc; do
|
||||
sudo apt remove $pkg
|
||||
done
|
||||
```
|
||||
|
||||
### 3.2.2 使用 APT 安装
|
||||
|
||||
由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。
|
||||
先安装基础依赖，并准备密钥目录：
|
||||
|
||||
```bash
|
||||
$ sudo apt-get update
|
||||
$ sudo apt update
|
||||
|
||||
$ sudo apt-get install \
|
||||
apt-transport-https \
|
||||
ca-certificates \
|
||||
curl \
|
||||
gnupg \
|
||||
lsb-release
|
||||
$ sudo apt install ca-certificates curl
|
||||
$ sudo install -m 0755 -d /etc/apt/keyrings
|
||||
```
|
||||
鉴于国内网络问题，强烈建议使用国内源，官方源请在注释中查看。
|
||||
如果公司内网维护了受信任镜像站，可在后续仓库地址中替换域名；默认建议优先使用 Docker 官方仓库。
|
||||
|
||||
为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。
|
||||
|
||||
```bash
|
||||
$ 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
|
||||
$ sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
|
||||
$ sudo chmod a+r /etc/apt/keyrings/docker.asc
|
||||
```
|
||||
然后，我们需要向 `sources.list` 中添加 Docker 软件源：
|
||||
|
||||
> 在一些基于 Debian 的 Linux 发行版中 `$(lsb_release -cs)` 可能不会返回 Debian 的版本代号，例如 [Kali Linux](https://www.kali.org/docs/policy/kali-linux-relationship-with-debian/)、[BunsenLabs Linux](https://www.bunsenlabs.org/)。在这些发行版中我们需要将下面命令中的 `$(lsb_release -cs)` 替换为 https://mirrors.aliyun.com/docker-ce/linux/debian/dists/ 中支持的 Debian 版本代号，例如 `buster`。
|
||||
> 在一些基于 Debian 的 Linux 发行版中，`$(. /etc/os-release && echo "$VERSION_CODENAME")` 可能不会返回 Debian 官方仓库使用的代号，例如 [Kali Linux](https://www.kali.org/docs/policy/kali-linux-relationship-with-debian/) 等衍生发行版。此时请手动替换为对应的 Debian 代号，例如 `bookworm`。
|
||||
|
||||
```bash
|
||||
$ echo \
|
||||
"deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/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
|
||||
$ sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
|
||||
Types: deb
|
||||
URIs: https://download.docker.com/linux/debian
|
||||
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
|
||||
Components: stable
|
||||
Architectures: $(dpkg --print-architecture)
|
||||
Signed-By: /etc/apt/keyrings/docker.asc
|
||||
EOF
|
||||
```
|
||||
> 以上命令会添加稳定版本的 Docker APT 源，如果需要测试版本的 Docker 请将 stable 改为 test。Debian11 可能不使用 `/etc/apt/keyrings/`，如 gpg 错误可以考虑更换为 `/etc/apt/trusted.gpg.d`，见 [issue 15727](https://github.com/docker/docs/issues/15727)。
|
||||
> 如果使用 Kali 等衍生发行版，请把 `Suites` 对应的版本代号替换为映射到的 Debian 代号，例如 `bookworm`。如果需要测试频道，可将 `Components: stable` 改为 `test`。
|
||||
|
||||
#### 安装 Docker
|
||||
|
||||
更新 apt 软件包缓存，并安装 `docker-ce`。
|
||||
更新 APT 缓存，并安装 Docker Engine 及常用 CLI 插件。
|
||||
|
||||
```bash
|
||||
$ sudo apt-get update
|
||||
$ sudo apt update
|
||||
|
||||
$ sudo apt-get install docker-ce docker-ce-cli containerd.io
|
||||
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
|
||||
```
|
||||
|
||||
### 3.2.3 使用脚本自动安装
|
||||
|
||||
在测试或开发环境中 Docker 官方为了简化安装流程，提供了一套便捷的安装脚本，Debian 系统上可以使用这套脚本安装，另外可以通过 `--mirror` 选项使用国内源进行安装：
|
||||
在测试或开发环境中，Docker 官方提供了便捷安装脚本，但官方明确不建议把它作为生产环境的标准安装方式。
|
||||
|
||||
> 若你想安装测试版的 Docker，请从 test.docker.com 获取脚本
|
||||
在真正执行前，建议先用 `--dry-run` 预览脚本动作：
|
||||
|
||||
```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 --dry-run
|
||||
|
||||
# $ sudo sh get-docker.sh --mirror AzureChinaCloud
|
||||
# 若需要测试频道：
|
||||
# curl -fsSL https://test.docker.com -o test-docker.sh
|
||||
# sudo sh ./test-docker.sh
|
||||
```
|
||||
执行这个命令后，脚本就会自动的将一切准备工作做好，并且把 Docker 的稳定 (stable) 版本安装在系统中。
|
||||
确认无误后，再执行 `sudo sh ./get-docker.sh` 安装稳定版。
|
||||
|
||||
### 3.2.4 启动 Docker
|
||||
|
||||
```bash
|
||||
$ sudo systemctl enable docker
|
||||
$ sudo systemctl start docker
|
||||
$ sudo systemctl enable --now docker
|
||||
```
|
||||
|
||||
### 3.2.5 建立 docker 用户组
|
||||
|
||||
Reference in New Issue
Block a user