基于国内环境 在Ubuntu 上安装 Docker 指南
前言
在容器化技术主导云原生时代的今天，Docker 凭借其轻量化、高移植性和秒级部署能力，已成为开发与运维的必备工具。然而，国内用户在 Ubuntu 系统上安装 Docker 时，常因 官方镜像源访问受限、网络延迟高、依赖包安装失败 等问题陷入困境，导致效率大幅降低。
本文针对 Ubuntu 22.04 LTS（Jammy）及 24.04 LTS（Noble） 系统，结合国内网络环境特性，提供一套 开箱即用、高效稳定 的 Docker 部署方案。
一、安装前的环境准备
1. 系统要求
• 操作系统：Ubuntu 22.04 LTS（Jammy）或 24.04 LTS（Noble）
• 权限要求：sudo 权限
• 网络要求：需访问国内镜像源（如阿里云、清华源）
2. 清理旧版本（如适用）
sudo apt-get remove docker docker-engine docker.io containerd runc
二、安装 Docker CE 社区版
1. 更新系统与安装依赖
# 更新软件包索引
sudo apt-get update
# 安装基础依赖
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg lsb-release software-properties-common
2. 配置国内镜像源与密钥
（阿里云示例）
# 添加 GPG 密钥（阿里云镜像）
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 添加 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 /etc/apt/sources.list.d/docker.list > /dev/null
注意：$(lsb_release -cs) 会自动获取系统代号（如 jammy 或 noble）
3. 安装 Docker 引擎
# 更新仓库并安装 Docker
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
4. 验证安装
# 启动服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
# 运行测试容器
sudo docker run hello-world
若输出 Hello from Docker! 表示安装成功
三、国内镜像加速配置
1. 配置镜像加速器
编辑 /etc/docker/daemon.json，添加国内镜像源地址：
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.m.daocloud.io", # DaoCloud镜像
"https://docker.1ms.run" # 公益镜像（可选）
]
}
EOF
重启服务生效：
sudo systemctl daemon-reload
sudo systemctl restart docker
验证配置：
docker info | grep "Registry Mirrors"
需显示配置的镜像地址
四、权限管理与优化
1. 非 root 用户权限
将当前用户加入 docker 组，避免使用 sudo：
sudo usermod -aG docker $USER
newgrp docker # 刷新组权限
2. 存储路径优化（可选）
若需自定义 Docker 存储目录（如挂载大容量磁盘）：
# 创建存储目录并软链接
sudo mkdir -p /data/docker
sudo ln -s /data/docker /var/lib/docker
五、常见问题与解决方案
1. 安装依赖报错
• 错误示例：E: Unable to locate package docker-ce
• 原因：镜像源未正确适配系统版本或仓库未启用
• 解决：重新检查仓库配置，确保 $(lsb_release -cs) 输出与镜像源支持的版本匹配
2. 镜像拉取失败
• 原因：加速器地址失效或网络不稳定
• 解决：更换镜像源（优先使用腾讯云或阿里云），并检查防火墙规则：
# 临时关闭防火墙（仅测试用）
sudo ufw disable
3. 服务启动失败
• 错误示例：Failed to start docker.service
• 排查步骤：
# 查看详细日志
journalctl -u docker.service --no-pager
# 检查存储驱动兼容性（推荐 overlay2）
docker info | grep "Storage Driver"
六、扩展功能
1. Docker Compose 安装
sudo apt-get install -y docker-compose-plugin
验证：docker compose version
2. Portainer 可视化工具部署
docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer
访问 http:// 初始化管理界面
总结
本文基于国内网络环境，从依赖安装到镜像加速配置，完整覆盖了 Docker 在 Ubuntu 系统上的部署流程，并针对常见问题提供解决方案。通过结合阿里云、腾讯云等镜像源，可显著提升安装与镜像拉取效率，满足开发与生产环境需求
