一、Windows 系统安装 Docker
1. 系统要求
- Windows 10 64 位:家庭版或专业版 2004 或更高版本(推荐使用 WSL 2 后端)
- Windows 11:任意版本
- 开启虚拟化(通常在 BIOS 中开启 Intel VT-x 或 AMD-V,一般默认已开启)
- 至少 4GB 内存(推荐 8GB)
2. 下载 Docker Desktop
- 访问 Docker 官网下载页面:https://www.docker.com/products/docker-desktop/
- 点击Download for Windows按钮,下载 Docker Desktop Installer.exe。
3. 安装步骤
- 双击运行下载的
Docker Desktop Installer.exe。 - 如果弹出用户账户控制(UAC)提示,点击“是”。
- 勾选Use WSL 2 instead of Hyper-V(推荐)或根据需要选择。
- 点击OK开始安装,等待安装完成。
- 安装完成后,点击Close and log out注销当前用户,或点击Close and restart重启电脑(推荐重启)。
4. 启动 Docker Desktop
- 重启后,从开始菜单或桌面启动Docker Desktop。
- 首次启动会要求接受服务协议,点击Accept。
- 等待 Docker 引擎启动,直到系统托盘中的 Docker 图标显示为“Docker Desktop is running”。
5. 验证安装
打开 PowerShell 或 CMD,输入:
docker --version docker run hello-world如果看到 Docker 版本信息和 hello-world 的运行结果,说明安装成功。
问题排查:如果遇到 WSL 2 未安装或未正确配置,Docker Desktop 会提示按照向导安装 WSL 2。可以手动安装:在管理员 PowerShell 中运行
wsl --install并重启。
二、Linux 系统安装 Docker(以 Ubuntu 22.04 为例)
1. 系统要求
- 64 位系统
- 内核版本 >= 3.10(现代发行版均满足)
- 拥有 sudo 权限的用户
2. 卸载旧版本(可选)
sudo apt remove docker docker-engine docker.io containerd runc3. 更新软件源并安装依赖
sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release4. 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg5. 添加 Docker 软件源
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null6. 安装 Docker Engine
sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin7. 启动 Docker 并设置开机自启
sudo systemctl start docker sudo systemctl enable docker8. 验证安装
sudo docker --version sudo docker run hello-world如果看到欢迎信息,说明 Docker 安装成功。
9. 允许非 root 用户运行 Docker(可选但推荐)
默认情况下,只有 root 用户或使用 sudo 才能运行 Docker 命令。为避免每次加 sudo,可以将当前用户加入 docker 组:
sudo usermod -aG docker $USER然后注销并重新登录(或运行newgrp docker)使组生效。之后即可直接使用docker命令。
三、Docker 基本使用命令
| 命令 | 作用 |
|---|---|
docker version | 查看客户端和服务端版本 |
docker info | 查看 Docker 系统信息 |
docker pull 镜像名 | 下载镜像 |
docker run [选项] 镜像名 [命令] | 创建并启动容器 |
docker ps | 列出运行中的容器 |
docker ps -a | 列出所有容器(包括停止的) |
docker stop 容器ID/名 | 停止容器 |
docker start 容器ID/名 | 启动已停止的容器 |
docker rm 容器ID/名 | 删除容器 |
docker images | 列出本地镜像 |
docker rmi 镜像ID/名 | 删除镜像 |
docker logs 容器ID/名 | 查看容器日志 |
四、安装后测试:用 Docker 运行一个简单服务
运行 Nginx 测试
docker run -d --name my-nginx -p 8080:80 nginx在浏览器访问http://localhost:8080,看到 Nginx 欢迎页即成功。
停止并删除:
docker stop my-nginx docker rm my-nginx五、后续:用 Docker 快速启动 Kafka(为之前的需求做准备)
安装好 Docker 后,你就可以用一条命令启动 Kafka,无需手动下载解压:
docker run -d --name kafka \ -p 9092:9092 \ -e ALLOW_PLAINTEXT_LISTENER=yes \ -e KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://localhost:9092 \ -e KAFKA_CFG_AUTO_CREATE_TOPICS_ENABLE=true \ bitnami/kafka:latest然后你的 Spring Boot 项目就可以连接localhost:9092收发消息了。
总结
- Windows:下载 Docker Desktop 安装包,一键安装,使用 WSL 2 后端。
- Linux:使用 apt 添加官方源,安装 Docker Engine,启动并验证。
- 安装完成后,可以通过
docker run hello-world验证功能。 - 后续可以使用 Docker 快速启动 Kafka 等中间件,方便本地开发测试。