Ubuntu 24.04.3 安装 Docker 并配置国内镜像源

我爱海鲸 2026-01-10 10:07:36 暂无标签

简介乌班图

Ubuntu 24.04.3 安装 Docker 并配置国内镜像源

一、前言

Docker 是目前最流行的容器化技术，在 Ubuntu 24.04.3 系统中安装 Docker 并配置国内镜像源，能大幅提升镜像拉取速度，解决网络访问慢的问题。本文将详细讲解从环境准备、Docker 安装到国内镜像配置的完整流程，步骤清晰、可直接实操。

二、环境准备

1. 系统版本确认

首先确认当前系统为 Ubuntu 24.04.3，执行以下命令：

lsb_release -a

输出示例（确认 Release: 24.04 即可）：

No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 24.04.3 LTS
Release:        24.04
Codename:       noble

2. 卸载旧版本（可选）

如果系统中已安装旧版本 Docker，先执行卸载命令清理环境：

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

3. 更新系统包索引

更新 apt 包索引并安装依赖工具，确保后续安装顺利：

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

三、安装 Docker Engine

1. 添加 Docker 官方 GPG 密钥

为保证软件包的安全性，添加 Docker 官方密钥：

sudo mkdir -p /etc/apt/trusted.gpg.d
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

2. 添加 Docker 官方软件源

将 Docker 官方源添加到系统 apt 源列表中：

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. 安装 Docker 引擎

更新包索引后，安装最新版 Docker Engine、Containerd 和 Docker Compose：

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

4. 验证安装是否成功

启动 Docker 服务并检查状态：

# 启动 Docker 服务
sudo systemctl start docker
# 设置开机自启
sudo systemctl enable docker
# 检查 Docker 状态
sudo systemctl status docker

若输出中包含 active (running)，说明 Docker 启动成功。

额外验证：执行 hello-world 镜像测试 Docker 功能：

sudo docker run hello-world

若输出包含 Hello from Docker!，则 Docker 安装并运行正常。

四、配置国内镜像源

Docker 默认从官方仓库拉取镜像，国内访问速度慢，需配置国内镜像加速器（如阿里云、网易云、Docker 中国镜像等）。

1. 创建 Docker 配置目录

sudo mkdir -p /etc/docker

2. 编辑 daemon.json 配置文件

bash

运行

sudo vim /etc/docker/daemon.json

将以下内容粘贴到文件中（推荐阿里云镜像，也可替换为其他国内源）：

{
  "registry-mirrors": [
    "https://docker.1panel.live",        // 1Panel 官方（稳定）
    "https://docker.m.daocloud.io",     // 道客云官方（稳定）
    "https://docker.mirrors.ustc.edu.cn",// 中科大官方（HTTPS 规范版）
    "https://hub-mirror.c.163.com",     // 网易云官方（补充）
    "https://mirror.aliyuncs.com"       // 阿里云公共版（无个人 ID，通用）
  ]
}

各镜像源说明：

https://registry.docker-cn.com：Docker 中国官方镜像（基础备用）；
https://mirror.aliyuncs.com：阿里云镜像（推荐，速度稳定，可登录阿里云控制台获取专属镜像地址）；
https://hub-mirror.c.163.com：网易云镜像；
https://docker.mirrors.ustc.edu.cn：中科大镜像。

3. 重启 Docker 服务使配置生效

# 重新加载 Docker 配置
sudo systemctl daemon-reload
# 重启 Docker 服务
sudo systemctl restart docker

4. 验证镜像源配置是否生效

执行以下命令查看 Docker 信息：

bash

运行

sudo docker info

若输出中 Registry Mirrors 字段显示配置的国内镜像地址，说明配置成功：

plaintext

Registry Mirrors:
 https://registry.docker-cn.com/
 https://mirror.aliyuncs.com/
 https://hub-mirror.c.163.com/
 https://docker.mirrors.ustc.edu.cn/

五、可选优化：免 sudo 使用 Docker

默认情况下，执行 Docker 命令需要 sudo，可将当前用户加入 docker 组，实现免 sudo 操作：

bash

运行

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
# 刷新组权限（无需重启，立即生效）
newgrp docker

验证：执行 docker ps，若无需 sudo 且无权限报错，说明配置成功。

六、常见问题解决

安装时提示 “找不到 docker-ce 包”：
- 检查是否正确添加 Docker 官方源，确认 lsb_release -cs 输出的 codename 为 noble；
- 重新执行 sudo apt-get update 刷新包索引。
镜像源配置后拉取镜像仍慢：
- 优先使用阿里云专属镜像地址（登录阿里云 -> 容器镜像服务 -> 镜像加速器，获取个人专属地址）；
- 检查网络是否正常，可更换其他国内镜像源测试。
Docker 启动失败：
- 查看日志：sudo journalctl -u docker，根据日志提示排查；
- 确认 containerd 服务正常：sudo systemctl status containerd。

总结

Ubuntu 24.04.3 安装 Docker 需先清理旧版本、添加官方 GPG 密钥和软件源，再通过 apt 安装核心组件；
配置国内镜像源的核心是修改 /etc/docker/daemon.json 文件，添加镜像加速器地址并重启 Docker；
可选优化将用户加入 docker 组，可避免每次执行 Docker 命令都加 sudo，提升使用体验。

通过以上步骤，即可在 Ubuntu 24.04.3 中完成 Docker 的安装和国内镜像配置，大幅提升容器镜像的拉取效率。

你好：我的2025

上一篇：react入门