Ubuntu 24.04 安装 Docker 完整指南

前言

Docker 作为当下最流行的容器化平台，已经成为开发者必备的工具之一。本文基于 Ubuntu 24.04 LTS (Noble) 系统，详细介绍 Docker 的安装、配置及常见问题，帮助读者快速上手。

系统环境确认

在开始安装前，首先确认系统版本：

lsb_release -a

输出示例：

Distributor ID: Ubuntu
Description:    Ubuntu 24.04.4 LTS
Release:        24.04
Codename:       noble

Ubuntu 24.04 完全符合 Docker 官方支持要求，可以放心安装。

安装方式对比

方式一：一键安装脚本（推荐个人开发环境）

这是最简单快捷的方式，适合个人学习、开发和测试环境：

curl -fsSL https://get.docker.com | sudo sh

这条命令会自动完成以下操作：

  • 检测系统类型和版本
  • 添加 Docker 官方 GPG 密钥和软件源
  • 安装 Docker Engine、containerd、Compose 插件等核心组件
  • 启动 Docker 服务并设置为开机自启

优点：一行命令搞定，无需手动配置
缺点：不便进行版本锁定，适合个人环境而非生产环境

方式二：APT 官方源安装（推荐生产环境）

这种方式更适合生产环境或需要版本精确控制的场景：

# 安装依赖
sudo apt update
sudo apt install ca-certificates curl

# 添加 GPG 密钥
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# 添加软件源
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

优点：版本可控、便于审计和管理
缺点：步骤较多，配置相对复杂

两种方式对比

特性一键脚本APT 官方源
便捷性⭐⭐⭐⭐⭐⭐⭐⭐
版本控制⭐⭐⭐⭐⭐⭐
生产环境推荐❌✅
可重复性❌✅

安装后配置

1. 用户组配置（重要）

Docker 默认需要 root 权限才能运行。为了让普通用户免 sudo 使用 Docker，需要将用户加入 docker 组：

sudo usermod -aG docker $USER

重要：执行后需要重新登录或执行 newgrp docker 使配置生效。

安全提示：docker 组的权限与 root 用户等效，加入该组的用户可以挂载宿主机目录、运行特权容器等，请谨慎授权。

2. 验证安装

# 查看 Docker 版本
docker --version

# 查看 Compose 版本
docker compose version

# 运行测试容器
docker run hello-world

3. 配置镜像加速（可选）

如果拉取镜像速度较慢，可配置国内镜像加速器。编辑 /etc/docker/daemon.json：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

重启 Docker 使配置生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

安装成功示例

以下是一次成功的安装输出摘要：

Client: Docker Engine - Community
 Version:           29.7.2
 API version:       1.55
 Go version:        go1.26.5
 Git commit:        a7dcaa6
 Built:             Wed Aug  5 18:28:53 2026
 OS/Arch:           linux/amd64

Server: Docker Engine - Community
 Engine:
  Version:          29.7.2
  API version:      1.55
  Go version:       go1.26.5
  Git commit:       6a43e3d
  Built:            Wed Aug  5 18:28:53 2026

权限说明

操作是否需要 sudo
安装 Docker✅ 需要
添加用户到 docker 组✅ 需要
加入组后运行 docker 命令❌ 不需要
未加入组时运行 docker 命令✅ 需要

注意事项

  1. 关于重复安装：一键安装脚本已包含 Docker Compose 插件，无需额外执行 apt install docker-compose-plugin
  2. 关于 sudo：安装时 curl 无需 sudo，但 sh 执行脚本时必须加 sudo
  3. 组权限生效：加入 docker 组后需要重新登录，否则当前会话仍需要 sudo
  4. 版本选择：个人开发环境可用一键脚本，生产环境建议使用 APT 方式以便版本管理

结语

通过以上步骤，你可以在 Ubuntu 24.04 上快速完成 Docker 的安装与配置。无论是选择一键脚本还是 APT 方式，都可根据实际场景灵活决定。对于个人开发者而言，一键安装脚本无疑是最快捷的选择；而对于生产环境，建议采用更严谨的 APT 安装方式以确保系统的稳定与安全。

作者

老丹

关注我
其他文章