Docker 系列 (一)：在 Debian 13 上搭建 Docker 基础环境-🤖赛博牛马🐴

1. 为什么选择 Debian 13 与 Docker？

Debian 以其无与伦比的稳定性著称，而最新的 Debian 13（开发代号 Trixie）带来了非常现代的内核支持，能够充分发挥 Docker 的容器化性能。无论是自建笔记、部署个人博客，还是运行各类实验性项目，Docker 都能让你的服务器保持干净整洁，避免依赖冲突。

本教程将带你一步步完成从系统清理、官方源安装到 Docker Compose 配置的全过程，帮助你快速搭建一个生产级别的 Docker 基础环境。

2. 准备工作：清理旧版本

如果你的系统之前曾尝试安装过旧版 Docker（如 docker.io、docker-engine 等），请先彻底卸载它们，确保环境纯净：

sudo apt-get remove docker docker-engine docker.io containerd runc

提示：如果系统提示某些软件包未安装，属正常现象，继续下一步即可。

3. 核心步骤：安装 Docker Engine

第一步：更新系统并安装必要依赖

首先更新软件包索引，并安装后续步骤所需的工具：

sudo apt update && sudo apt upgrade -y
sudo apt install ca-certificates curl gnupg lsb-release -y

第二步：添加 Docker 官方 GPG 密钥

创建用于存放密钥的目录，并下载 Docker 官方的 GPG 密钥，用于验证软件包签名：

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

第三步：添加 Docker 官方软件源

根据你的系统架构和 Debian 版本（Trixie）添加 Docker 的 APT 源：

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

注意：目前 Docker 官方可能尚未正式支持 Debian 13 (Trixie)，若后续 apt update 提示找不到仓库，可将上述命令中的 $(. /etc/os-release && echo "$VERSION_CODENAME") 临时替换为 bookworm（Debian 12 的代号），绝大多数情况下兼容性良好。

添加完成后，更新软件源列表：

sudo apt update

第四步：安装 Docker 核心组件

安装 Docker 引擎、客户端、容器运行时以及常用的插件（包括新版 Compose 插件）：

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

4. 关键配置：优化使用体验

免 sudo 运行（可选但推荐）

默认情况下，运行 Docker 命令需要 root 权限。为了安全与便利，将你的普通用户加入 docker 组：

sudo usermod -aG docker $USER

重要：执行完此命令后，必须注销并重新登录，或者运行 newgrp docker 命令，使组成员变更生效。

配置镜像加速（国内服务器强烈推荐）

国内访问 Docker Hub 速度较慢，建议配置镜像加速器。编辑（或创建）Docker 守护进程配置文件 /etc/docker/daemon.json：

{
    "registry-mirrors": [
        "https://your-mirror-address.com"
    ]
}

你可以从阿里云、腾讯云、中科大等云服务商获取免费的专属镜像加速地址。例如，阿里云容器镜像服务（需登录后查看）形如 https://<your-code>.mirror.aliyuncs.com。

保存文件后，重新加载配置并重启 Docker：

sudo systemctl daemon-reload
sudo systemctl restart docker

5. 验证安装

运行经典的 hello-world 容器，确认一切工作正常：

docker run hello-world

如果看到欢迎信息，说明 Docker 已成功安装并运行。现在你的 Debian 服务器已经拥有了一套完美的 Docker 基础环境，可以开始部署你的应用了！

目录CONTENT

Docker 系列 (一)：在 Debian 13 上搭建 Docker 基础环境