Ubuntu24安装Docker详细教程
目录
Ubuntu 安装 Docker 详细教程
一、安装环境说明
二、卸载旧版 Docker(若存在)
三、安装必要的依赖
四、添加 Docker 的 GPG 密钥
五、配置 Docker 的软件源
六、安装 Docker
docker-compose离线安装
七、验证 Docker 是否安装成功
八、配置镜像加速器
Ubuntu 安装 Docker 详细教程
一、安装环境说明
本教程适用于 Ubuntu 系统,建议使用 Ubuntu 20.04 或更高版本,并且系统已更新至最新状态。在安装之前,请确保你的机器满足以下条件:
操作系统:64 位的 Ubuntu 系统。
硬件要求:具备足够的磁盘空间和内存来安装 Docker 及其相关组件,以及后续运行容器所需的资源。
二、卸载旧版 Docker(若存在)
如果你的系统之前安装过旧版本的 Docker,例如 docker
、docker-engine
、docker.io
、containerd
、runc
等,为避免安装冲突,需要先将它们卸载。在终端中执行以下命令:
sudo apt-get remove docker docker-engine docker.io containerd runc
执行该命令后,系统会自动卸载相关的旧版本软件包。但需要注意的是,此操作不会删除 /var/lib/docker/
目录及其包含的镜像、容器、卷和网络等数据。如果希望以全新的状态安装 Docker 且不需要保留这些旧数据,可以手动删除该目录。不过请谨慎操作,确保你确实不需要这些历史数据。
三、安装必要的依赖
在安装 Docker 之前,需要先安装一些必要的依赖包,这些依赖包用于支持通过 HTTPS 协议访问软件仓库等功能。依次在终端执行以下命令:
sudo apt-get update sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y
sudo apt-get update
:该命令用于更新系统的软件包索引,从软件源服务器获取最新的软件包信息,确保后续安装的软件包是最新版本。
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y
:安装一系列依赖包,其中 apt-transport-https
允许 apt
通过 HTTPS 协议访问软件仓库;ca-certificates
用于管理 SSL 证书,确保网络通信的安全;curl
是一个常用的命令行工具,用于在命令行中进行网络请求;gnupg-agent
是 GNU Privacy Guard 的一部分,用于管理 GPG 密钥,在软件包验证等方面发挥作用;software-properties-common
提供了一些通用的软件源管理工具和功能。-y
参数表示在安装过程中自动回答 “yes”,同意所有安装提示,避免手动交互确认。
四、添加 Docker 的 GPG 密钥
为了确保从软件源下载的 Docker 软件包的完整性和安全性,需要添加 Docker 官方的 GPG 密钥。在终端中执行以下命令:
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
此命令通过 curl
工具从阿里云镜像源(这里使用阿里云镜像源来加快下载速度,你也可以使用官方源 https://download.docker.com/linux/ubuntu/gpg
)下载 Docker 的 GPG 密钥,并将其通过管道传递给 gpg
命令进行处理。gpg --dearmor
命令将二进制格式的 GPG 密钥转换为 ASCII 装甲格式,最后将转换后的密钥保存到 /usr/share/keyrings/docker-archive-keyring.gpg
文件中。这样,系统在后续从该软件源下载 Docker 相关软件包时,就可以使用这个密钥来验证软件包的签名,确保其未被篡改。
五、配置 Docker 的软件源
将 Docker 的软件源添加到系统的软件源列表中,以便通过 apt-get
命令从该源安装 Docker。在终端执行以下命令:
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 -a /etc/apt/sources.list.d/docker.list
该命令中,echo
部分构建了一个描述 Docker 软件源的字符串,其中:
arch=$(dpkg --print-architecture)
:通过 dpkg --print-architecture
命令获取当前系统的架构信息(如 amd64
等),确保下载的软件包与系统架构匹配。
signed-by=/usr/share/keyrings/docker-archive-keyring.gpg
:指定使用前面下载并保存的 GPG 密钥来验证软件包签名。
https://mirrors.aliyun.com/docker-ce/linux/ubuntu
:这是阿里云提供的 Docker 软件源地址,使用国内镜像源可以加快下载速度。你也可以使用官方源 https://download.docker.com/linux/ubuntu
。
$(lsb_release -cs)
:通过 lsb_release -cs
命令获取当前 Ubuntu 系统的版本代号(如 jammy
等),以便软件源提供与系统版本匹配的软件包。
stable
:表示使用稳定版本的软件源。
| sudo tee -a /etc/apt/sources.list.d/docker.list
部分将前面构建的软件源字符串追加到 /etc/apt/sources.list.d/docker.list
文件中。sudo
用于获取管理员权限,tee
命令用于将标准输入的数据输出到指定文件,同时也输出到标准输出(终端),-a
参数表示追加模式,即不覆盖原文件内容,而是将新内容添加到文件末尾。
六、安装 Docker
完成上述配置后,就可以安装 Docker 了。在终端中依次执行以下命令:
sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
再次执行 sudo apt-get update
:由于前面添加了新的软件源,再次更新软件包索引,确保获取到最新的 Docker 软件包信息。
sudo apt-get install docker-ce docker-ce-cli ``containerd.io`` docker-buildx-plugin docker-compose-plugin -y
:安装 Docker 相关的一系列组件,其中:
docker-ce
:Docker 社区版,是 Docker 的核心运行时引擎,用于创建、运行和管理容器。
docker-ce-cli
:Docker 社区版的命令行工具,通过它可以与 docker-ce
守护进程进行交互,执行各种容器管理操作。
containerd.io
:一个工业级的容器运行时,负责运行和管理容器的生命周期,是 Docker 架构中的重要组成部分。
docker-buildx-plugin
:这是一个 Docker 的插件,为 docker build
命令提供了更强大的构建功能,例如多平台构建等。
docker-compose-plugin
:用于定义和运行多容器的 Docker 应用程序,通过一个 docker-compose.yml
文件就可以管理多个相关联的容器服务。-y
参数同样是自动同意所有安装提示,加快安装过程。
笔者在安装后发现docker-compose无法正常使用,所以单独重新安装docker-compose
docker-compose离线安装
docker-compose文件需要提前手动下载或者下面的链接 放在脚本同目录
最新发行的版本地址:https://github.com/docker/compose/releases
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-(uname−s)−•(uname -m)" -o /usr/local/bin/docker-compose
nano install_docker-compose.sh
cp docker-compose-linux-x86_64 /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose sudo rm -rf /usr/bin/docker-compose sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose docker --version docker-compose --version
授权运行
chmod +x install_docker-compose.sh sh ./install_docker-compose.sh
七、验证 Docker 是否安装成功
安装完成后,可以通过多种方式验证 Docker 是否成功安装。
查看 Docker 版本:在终端执行以下命令:
sudo docker --version
如果安装成功,你会看到类似以下的输出,显示 Docker 的具体版本号:
运行测试容器:运行一个简单的 hello-world
容器来进一步验证 Docker 的运行状态。在终端执行以下命令:
sudo docker run hello-world
该命令会从 Docker Hub 上下载一个名为 hello-world
的测试镜像(如果本地不存在该镜像),然后在容器中运行它。如果一切正常,容器启动后会输出一段欢迎信息,类似如下内容:
这表明 Docker 已经成功安装并能够正常运行容器。
八、配置镜像加速器
在国内使用 Docker 时,由于网络原因,从官方镜像源下载镜像的速度可能较慢。为了提高镜像下载速度,可以配置镜像加速器。这里以阿里云镜像加速器为例,其他常见的镜像加速器还有网易云镜像加速器、腾讯云镜像加速器等,配置方法类似。
创建或编辑 Docker 配置文件:在终端执行以下命令:
sudo mkdir -p /etc/docker sudo nano /etc/docker/daemon.json
mkdir -p /etc/docker
命令用于创建 /etc/docker
目录,如果该目录已经存在则不会报错。nano /etc/docker/daemon.json
命令使用 nano
文本编辑器打开或创建 /etc/docker/daemon.json
文件,这个文件用于存储 Docker 守护进程的配置信息。
2. 添加镜像加速器地址:在打开的 daemon.json
文件中添加或修改如下内容:
{ "registry-mirrors": ["https://docker.1panel.live"] }
请将 https://你的镜像加速器地址
替换为你实际使用的镜像加速器地址,例如阿里云镜像加速器地址在配置时可能类似 https://xxxxxxx.mirror.aliyuncs.com
(具体地址需在阿里云容器镜像服务控制台获取)。添加完成后,按 Ctrl+X
组合键,然后按 Y
键确认保存,最后按 Enter
键退出 nano
编辑器。
3. 重新加载 Docker 配置并重启服务:在终端执行以下命令使配置生效:
sudo systemctl daemon-reload sudo systemctl enable docker sudo systemctl restart docker
sudo systemctl daemon-reload
命令通知 systemd 重新加载服务配置文件,这样它才能识别到 /etc/docker/daemon.json
文件的更改。sudo systemctl restart docker
命令则用于重启 Docker 服务,使新的镜像加速器配置生效。