Ubuntu 22.04.5 LTS 安装 Docker 29.1.5（阿里云镜像，生产环境实战）

文章目录

[Ubuntu 22.04.5 LTS 安装 Docker（阿里云镜像，生产环境实战）](#Ubuntu 22.04.5 LTS 安装 Docker（阿里云镜像，生产环境实战）)
一、环境说明
[二、卸载系统中旧版本 Docker](#二、卸载系统中旧版本 Docker)
三、安装基础依赖
[四、（可选）替换 Ubuntu 系统源为阿里云](#四、（可选）替换 Ubuntu 系统源为阿里云)
[五、配置 Docker 官方 GPG Key（新规范）](#五、配置 Docker 官方 GPG Key（新规范）)
- [1️⃣ 创建 keyrings 目录](#1️⃣ 创建 keyrings 目录)
- [2️⃣ 下载并导入阿里云 Docker GPG Key](#2️⃣ 下载并导入阿里云 Docker GPG Key)
[六、添加 Docker CE 软件源（阿里云）](#六、添加 Docker CE 软件源（阿里云）)
[七、安装 Docker CE + Compose v2](#七、安装 Docker CE + Compose v2)
[八、Docker daemon.json 配置（重点）](#八、Docker daemon.json 配置（重点）)
- 配置项说明
[九、重载并重启 Docker](#九、重载并重启 Docker)
十、安装验证
- [1️⃣ 查看 Docker 版本](#1️⃣ 查看 Docker 版本)
- [2️⃣ 查看容器运行状态](#2️⃣ 查看容器运行状态)
- [3️⃣ 查看 Compose v2](#3️⃣ 查看 Compose v2)
十一、常见补充与优化建议
- [1️⃣ 非 root 用户使用 Docker](#1️⃣ 非 root 用户使用 Docker)
- [2️⃣ Docker 日志轮转（生产环境推荐）](#2️⃣ Docker 日志轮转（生产环境推荐）)
- [3️⃣ 容器运行异常排查](#3️⃣ 容器运行异常排查)
十二、总结

Ubuntu 22.04.5 LTS 安装 Docker（阿里云镜像，生产环境实战）

本文基于 Ubuntu 22.04.5 LTS（Jammy） ，整理了一套 生产环境可用 的 Docker 安装与优化方案，亲测可用，适合运维 / DevOps 同学直接落地。

内容包含：

旧 Docker 组件清理
使用 阿里云 Docker CE 镜像源
Docker 官方 GPG Key 新规范（/etc/apt/keyrings）
Docker CE + Compose v2 安装
daemon.json 常见生产级配置说明
安装验证与常见问题补充

非常适合 运维 / DevOps / Kubernetes 前置环境 使用。

一、环境说明

适用人群：Linux 运维 / DevOps / 后端开发

测试环境：云服务器 + 本地虚拟机

OS：Ubuntu 22.04.5 LTS
架构：x86_64（amd64）
Docker：Docker CE（官方社区版）
Compose：docker-compose-plugin（Compose v2）
用户：root

⚠️ Ubuntu 22.04 自带的 docker.io 版本偏旧，不建议直接使用系统源安装。

二、卸载系统中旧版本 Docker

在安装 Docker CE 之前，务必清理系统可能存在的旧组件，避免冲突。

bash 复制代码

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

如果是干净系统，该步骤不会报错，可放心执行。

三、安装基础依赖

Docker 官方仓库依赖 HTTPS 访问，需要提前安装必要工具。

bash 复制代码

apt-get update
apt-get install -y ca-certificates curl gnupg lsb-release

四、（可选）替换 Ubuntu 系统源为阿里云

国内环境建议替换默认源，提高 apt 速度。

bash 复制代码

sed -i 's/security.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list

执行完成后可再次更新索引：

bash 复制代码

apt-get update

五、配置 Docker 官方 GPG Key（新规范）

Ubuntu 22.04 开始，官方推荐使用 keyrings 方式 管理 GPG Key。

1️⃣ 创建 keyrings 目录

bash 复制代码

install -m 0755 -d /etc/apt/keyrings

2️⃣ 下载并导入阿里云 Docker GPG Key

bash 复制代码

curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg \
| gpg --dearmor -o /etc/apt/keyrings/docker.gpg

chmod a+r /etc/apt/keyrings/docker.gpg

六、添加 Docker CE 软件源（阿里云）

bash 复制代码

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

更新索引：

bash 复制代码

apt-get update

七、安装 Docker CE + Compose v2

bash 复制代码

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

切记这里先不要启动，接着下边看看需不需要配置呢

八、Docker daemon.json 配置（重点）

编辑 Docker 配置文件：

bash 复制代码

mkdir -p /etc/docker
vim /etc/docker/daemon.json

示例配置如下：

json 复制代码

{
  "registry-mirrors": [
    "https://docker.wctmd.us.kg",
    "https://glo2la19.mirror.aliyuncs.com",
    "https://docker.m.daocloud.io"
  ],
  "bip": "192.168.1.1/24",
  "data-root": "/data/docker-dir",
  "insecure-registries": [
    "harbor.domain.io"
  ]
}

配置项说明

参数	说明
registry-mirrors	镜像加速器，显著提升 pull 速度
bip	Docker 默认网桥地址，避免与宿主机或 VPN 网段冲突
data-root	Docker 数据目录，建议放到大磁盘（如 /data）
insecure-registries	允许使用 HTTP / 自签名 Harbor 仓库

⚠️ bip 网段一定要提前规划，避免和 Kubernetes / 物理网络冲突。

九、重载并重启 Docker

bash 复制代码

systemctl daemon-reload
systemctl enable docker # 开机自启
systemctl restart docker

查看状态：

bash 复制代码

systemctl status docker

十、安装验证

1️⃣ 查看 Docker 版本

bash 复制代码

docker version

2️⃣ 查看容器运行状态

bash 复制代码

docker ps

3️⃣ 查看 Compose v2

bash 复制代码

docker compose version
docker compose ps

Ubuntu 22.04 默认使用 docker compose（空格） ，而不是 docker-compose。

十一、常见补充与优化建议

1️⃣ 非 root 用户使用 Docker

bash 复制代码

usermod -aG docker $USER
newgrp docker

2️⃣ Docker 日志轮转（生产环境推荐）

json 复制代码

"log-driver": "json-file",
"log-opts": {
  "max-size": "100m",
  "max-file": "3"
}

3️⃣ 容器运行异常排查

bash 复制代码

docker logs <container_id>
docker inspect <container_id>

十二、总结

本文提供了一套：

适配 Ubuntu 22.04
国内网络友好
生产环境可直接使用

的 Docker 安装与优化方案。

如果你后续要：

部署 Docker Compose 项目
作为 Kubernetes Node 使用
对接 Harbor 私有仓库

这套配置可以直接作为基础环境使用。