Docker Engine 在 Debian 系统上的安装指南

Docker Engine 在 Debian 系统上的安装指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

Docker Engine 是 Docker 的核心组件，它允许用户在隔离的容器中运行应用程序。本文将详细介绍如何在 Debian 系统上安装 Docker Engine，包括系统要求、安装方法以及卸载步骤。

系统要求

操作系统版本要求

Docker Engine 支持以下 64 位 Debian 版本：

• Debian Trixie 13 (测试版)
• Debian Bookworm 12 (稳定版)
• Debian Bullseye 11 (旧稳定版)

架构支持

Docker Engine 兼容以下架构：

• x86_64 (amd64)
• armhf
• arm64
• ppc64le (ppc64el)

防火墙注意事项

在安装 Docker 前，需注意以下防火墙相关问题：

1. 使用 ufw 或 firewalld 时，Docker 容器端口会绕过防火墙规则
2. Docker 仅兼容 iptables-nft 和 iptables-legacy
3. 不支持使用 nft 创建的防火墙规则

准备工作

卸载冲突软件包

安装前需卸载以下可能冲突的软件包：

for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do
    sudo apt-get remove $pkg
done

注意：此操作不会删除 /var/lib/docker/ 下的数据，如需全新安装需手动清理。

安装方法

方法一：使用 apt 仓库安装（推荐）

1. 设置 Docker 的 apt 仓库：

# 添加 Docker 官方 GPG 密钥
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
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

# 添加仓库到 apt 源列表
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

2. 安装 Docker 组件：

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

3. 验证安装：

sudo docker run hello-world

方法二：手动安装 deb 包

1. 下载所需的 deb 包：

   • containerd.io
   • docker-ce
   • docker-ce-cli
   • docker-buildx-plugin
   • docker-compose-plugin

2. 使用 dpkg 安装：

sudo dpkg -i ./containerd.io_<version>_<arch>.deb \
  ./docker-ce_<version>_<arch>.deb \
  ./docker-ce-cli_<version>_<arch>.deb \
  ./docker-buildx-plugin_<version>_<arch>.deb \
  ./docker-compose-plugin_<version>_<arch>.deb

3. 启动服务并验证：

sudo service docker start
sudo docker run hello-world

升级 Docker Engine

通过 apt 仓库升级

sudo apt-get update
sudo apt-get upgrade

手动升级

下载新版 deb 包并重复安装步骤。

卸载 Docker Engine

1. 卸载软件包：

sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

2. 删除数据：

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

3. 清理配置：

sudo rm /etc/apt/sources.list.d/docker.list
sudo rm /etc/apt/keyrings/docker.asc

安装后配置

安装完成后，建议进行以下配置：

1. 将用户加入 docker 组以避免使用 sudo
2. 配置 Docker 开机自启
3. 设置日志轮转策略
4. 配置存储驱动

常见问题

1. 权限问题：如果遇到权限错误，尝试将用户加入 docker 组：

   sudo usermod -aG docker $USER
   

2. 服务启动失败：检查日志获取详细信息：

   journalctl -u docker.service
   

3. 网络问题：如果容器无法访问外部网络，检查 iptables 配置。

总结

本文详细介绍了在 Debian 系统上安装 Docker Engine 的多种方法，包括推荐的 apt 仓库安装和手动 deb 包安装。同时提供了升级和卸载的完整指南。安装完成后，建议进行适当的配置以确保 Docker 的最佳性能和安全性。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs