Ubuntu 22.04 系统下 Docker 安装与配置全指南_ubuntu 22.04 docker

技术文档

Ubuntu 22.04 系统下 Docker 安装与配置全指南

一、前言

Docker 作为现代开发中不可或缺的容器化工具，能极大提升应用部署和环境管理的效率。本文将详细介绍在 Ubuntu 22.04 系统上安装与配置 Docker 的完整流程，包括环境准备、安装步骤、权限配置及镜像加速优化等关键环节。

二、安装前的环境准备

1. 卸载旧版本 Docker（如有）

在安装新版本 Docker 前，需先卸载系统中可能存在的旧版本：

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

2. 安装必要的支持组件

安装依赖包以确保 Docker 正常运行：

sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release

三、Docker 安装核心步骤

1. 添加 Docker 官方 GPG 密钥（推荐使用国内镜像源）

国内用户建议使用阿里云镜像源的 GPG 密钥（避免网络问题）：

# 阿里源 GPG 密钥curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

2. 配置软件源（官方源与阿里源二选一）

方案一：使用 Docker 官方源（国外源，可能较慢）

echo \"deb [arch=$(dpkg --print-architecture) 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

方案二：使用阿里云镜像源（推荐国内用户）

echo \"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable\" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. 更新软件包索引并安装 Docker

# 更新系统软件源sudo apt update# 安装 Docker 最新稳定版sudo apt install docker-ce docker-ce-cli containerd.io# 验证 Docker 安装版本sudo docker version# 检查 Docker 服务运行状态sudo systemctl status docker

四、优化 Docker 使用体验

1. 安装 Docker 命令补全工具

# 安装 bash 补全工具sudo apt-get install bash-completion# 下载 Docker 补全脚本sudo curl -L https://raw.githubusercontent.com/docker/docker-ce/master/components/cli/contrib/completion/bash/docker -o /etc/bash_completion.d/docker.sh# 加载补全配置source /etc/bash_completion.d/docker.sh

2. 允许非 Root 用户执行 Docker 命令

默认情况下，Docker 命令需要 root 权限，可通过以下步骤赋予普通用户权限：

# 创建 docker 用户组（若不存在）sudo groupadd docker# 将当前用户添加到 docker 组sudo usermod -aG docker $USER# 使权限立即生效newgrp docker# 测试权限（无需 sudo 执行 Docker 命令）docker ps -a

3. 持久化权限配置（避免重启终端后失效）

编辑 .bashrc 文件，添加以下内容以确保每次登录时自动配置权限：

vi ~/.bashrc# 在文件末尾添加groupadd -f docker

保存后执行 source ~/.bashrc 使配置生效。

五、配置 Docker 镜像加速器（解决拉取慢问题）

国内访问 Docker 官方镜像仓库可能会遇到网络问题，需配置镜像加速器：

# 创建或修改 Docker 配置文件sudo vi /etc/docker/daemon.json

在文件中添加以下内容（可选择部分国内镜像源）：

{ \"registry-mirrors\": [ \"https://docker.registry.cyou\", \"https://mirror.aliyuncs.com\", \"https://dockerproxy.com\", \"https://mirror.baidubce.com\", \"https://docker.m.daocloud.io\", \"https://docker.mirrors.ustc.edu.cn\" ]}

修改完成后，重启 Docker 服务使配置生效：

sudo systemctl daemon-reloadsudo systemctl restart docker

六、验证 Docker 完整功能

完成所有配置后，可通过运行测试容器验证 Docker 是否正常工作：

# 运行一个测试用的 Docker 容器（输出 \"Hello from Docker!\"）sudo docker run hello-world

若看到类似以下输出，则表示 Docker 安装与配置成功：

Hello from Docker!This message shows that your installation appears to be working correctly....

七、总结

通过以上步骤，我们在 Ubuntu 22.04 系统上完成了 Docker 的安装、权限配置及镜像加速优化。Docker 的容器化技术能帮助开发者更高效地管理应用环境，后续可进一步学习 Docker Compose、容器编排等进阶功能，提升开发与部署效率。

注意事项：

国内用户务必配置镜像加速器，避免拉取镜像时出现网络超时
新增用户到 docker 组后，需重新登录或执行 newgrp docker 使权限生效
若遇到权限问题，可检查 /var/run/docker.sock 文件的用户组归属

Ubuntu 22.04 系统下 Docker 安装与配置全指南_ubuntu 22.04 docker