📑 目录
- 一、版本与平台支持
- 二、Ubuntu 安装 Docker
- 三、CentOS 安装 Docker
- 四、Windows 11 安装 Docker Desktop
- 五、常见报错处理
- 六、实战经验:镜像源修改
- 七、实战经验:存储目录修改
一、版本与平台支持
Docker 分为Server 版本(在 Linux 服务器上以命令行方式运行)和桌面版本(Docker Desktop,带 GUI)。本篇覆盖三种典型安装场景:Ubuntu、CentOS、Windows 11。各平台最新安装步骤以 Docker 官方安装文档 为准,本篇记录实测可用的流程。
二、Ubuntu 安装 Docker
以华为云 Ubuntu 20.04 为例。安装前需确认环境依赖:操作系统支持 Ubuntu Kinetic 22.10、Jammy 22.04 (LTS)、Focal 20.04 (LTS)、Bionic 18.04 (LTS);CPU 支持 ARM 和 X86_64。完整依赖与官方仓库配置详见 Ubuntu 安装指南。
1. 确认 CPU 架构
uname-a# 输出含 x86_64 表示支持;若是 arm 一般显示 aarch642. 确认操作系统版本
cat/etc/*release*3. 卸载旧版本
sudoapt-getremovedockerdocker-engine docker.io containerd runc4. 卸载历史版本(彻底清理)
# 卸载软件包sudoapt-getpurge docker-ce docker-ce-cli containerd.io\docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras-y# 删除数据目录sudorm-rf/var/lib/dockersudorm-rf/var/lib/containerdsudorm-rf/etc/docker/daemon.json5. 配置 Docker 下载源
# 安装 curlsudoaptinstallcurl-y# 创建 gpg key 目录sudomkdir-m0755-p/etc/apt/keyrings# 下载 gpg keycurl-fsSLhttps://download.docker.com/linux/ubuntu/gpg|\sudogpg--dearmor--yes-o/etc/apt/keyrings/docker.gpg# 写入 apt 源echo\"deb [arch=$(dpkg --print-architecture)signed-by=/etc/apt/keyrings/docker.gpg] \ https://download.docker.com/linux/ubuntu \$(lsb_release-cs)stable"|\sudotee/etc/apt/sources.list.d/docker.list>/dev/null6. 安装 Docker
sudoapt-getupdatesudoapt-getinstalldocker-ce docker-ce-cli containerd.io\docker-buildx-plugin docker-compose-plugin-y7. 配置开机自启
sudosystemctl daemon-reload# 加载配置sudosystemctl startdocker# 启动服务sudosystemctlenabledocker# 开机自启sudosystemctl statusdocker# 查看状态8. 验证安装
# 查看版本(应显示 Client 和 Server,版本如 23.0.1)dockerversion# 查看详细信息(含存储驱动、Cgroup 版本、插件等)dockerinfo# 运行 hello-world,看到 "Hello from Docker!" 即表示正常sudodockerrun hello-world📌
docker info关键信息:Storage Driver 为 overlay2,Cgroup Version 为 2,Docker Root Dir 为/var/lib/docker,Default Runtime 为 runc。
三、CentOS 安装 Docker
支持的操作系统:CentOS 7 已停止更新不再支持,CentOS 8 (stream) 和 CentOS 9 (stream) 支持;CPU 支持 ARM/X86_64。步骤与 Ubuntu 类似,详见 CentOS 安装指南。
1. 确认环境
cat/etc/*release*# 确认操作系统uname-a# 确认 CPU 架构(x86_64)2. 卸载旧版本与历史版本
# 卸载旧版本sudoyum removedockerdocker-client docker-client-latest\docker-common docker-latest docker-latest-logrotate\docker-logrotate docker-engine# 卸载历史版本sudoyum remove docker-ce docker-ce-cli containerd.io\docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extrassudorm-rf/var/lib/dockersudorm-rf/var/lib/containerdsudorm-rf/etc/docker/daemon.json3. 配置仓库
sudoyuminstall-yyum-utilssudoyum-config-manager --add-repo\https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo4. 安装并启动
# 安装sudoyuminstall-ydocker-ce# 启动并设为开机自启sudosystemctl daemon-reloadsudosystemctl startdockersudosystemctlenabledockersudosystemctl statusdocker5. 验证安装
dockerversion# 查看版本(如 23.0.3)dockerinfo# 查看详细信息sudodockerrun hello-world# 运行测试镜像四、Windows 11 安装 Docker Desktop
1. 安装依赖
首先确定开启虚拟化:按Win + I进入"启用或关闭 Windows 功能",勾选"Windows 子系统"(WSL)和"虚拟机平台",重启电脑完成系统设置。
2. 安装 WSL2
以管理员权限运行 PowerShell:
wsl--status# 查看版本,若不是 2 需更新wsl--update# 更新 wsl 到最新版本wsl--set-default-version 2# 设置 wsl 默认版本为 23. 安装 Ubuntu 子系统
通过微软应用商店安装 Ubuntu 18.04.5,启动后按提示创建 UNIX 用户名和密码。
4. 安装 Docker Desktop
下载 Docker Desktop for Windows,双击Docker Desktop Installer.exe安装,点击桌面快捷方式运行 Docker。在 PowerShell 中验证:
docker version# 应显示 Client(windows/amd64)和 Server(linux/amd64)⚠️ 因 Docker 源在 Windows 下可能不可用,需配置 registry-mirrors 代理(见下文镜像源修改)。
五、常见报错处理
Docker 启动时报错时,按以下步骤排查:
# 1. 查看系统日志(-e 从末尾看,-u 指定 docker 组件)journalctl-eudocker# 2. 修复命令systemctl daemon-reload systemctl startdocker六、镜像源修改
对于使用 systemd 的系统(Ubuntu 16.04+、Debian 8+、CentOS 7),在配置文件/etc/docker/daemon.json中配置registry-mirrors。该文件支持的全部配置项见 daemon.json 配置参考。
腾讯云(可使用腾讯内置源):
{"registry-mirrors":["https://mirror.ccs.tencentyun.com"]}阿里云 / 其他环境(因阿里云只对企业开放海外代理,需找私人开放源):
{"registry-mirrors":["https://docker.m.daocloud.io","https://dockerhub.timeweb.cloud","https://huecker.io"]}配置后重启 Docker 生效:
sudosystemctl daemon-reloadsudosystemctl restartdocker七、存储目录修改
Docker 默认安装目录为/var/lib/docker,会存放大量镜像,安装时需考虑该目录空间。三种解决方案:
| 方案 | 适用场景 |
|---|---|
| 挂载大磁盘到 /var/lib/docker | 能控制挂载目录,如云厂商安装 K8s 节点时提供挂载选项 |
| 安装前挂载大磁盘 + 软链接 | 安装前规划好,创建软链接到/var/lib/docker |
| 修改 daemon.json 的># 创建目标目录(假设大磁盘挂载在 /data)mkdir-p/data/var/lib/docker# 编辑配置文件vi/etc/docker/daemon.json 写入以下内容:
|