Windows 下安装 Docker 完整指南

Windows 下安装 Docker 完整指南

_

Docker 是目前最流行的容器化技术,可以让你在任何系统上运行相同的应用环境。本文介绍在 Windows 下安装 Docker 的两种方式。

一、什么是 Docker?

Docker 是一个开源的应用容器引擎,让开发者可以打包应用及其依赖包到一个轻量级、可移植的容器中。

简单理解

传统方式

Docker 方式

在自己电脑上运行

在任何电脑上运行

"我电脑上能跑"

"哪里都能跑"

环境配置麻烦

一个命令搞定

为什么要用 Docker?

  • 环境一致性:开发、测试、生产环境完全相同

  • 快速部署:秒级启动应用

  • 资源隔离:每个容器独立运行

  • 便于管理:一条命令安装/删除整个应用栈


二、Windows 下安装 Docker 的两种方式

方式

说明

适合人群

Docker Desktop

包含 GUI 的完整套件

新手,想快速上手

WSL2 + Docker Engine

在 WSL2 中安装纯命令行

喜欢命令行,追求 Linux 体验


方案一:安装 Docker Desktop(推荐新手)

1. 下载 Docker Desktop

访问 Docker 官网:https://www.docker.com/products/docker-desktop/

点击「Download for Windows」下载安装包(约 500MB)。

2. 安装

  1. 双击 Docker Desktop Installer.exe

  2. 安装选项建议:

    • ✅ Use WSL 2 instead of Hyper-V(推荐,性能更好)

    • ✅ Add shortcut to desktop(添加桌面快捷方式)

  3. 点击「Ok」开始安装

  4. 安装完成后重启电脑

3. 启动 Docker Desktop

  1. 重启后从开始菜单启动 Docker Desktop

  2. 等待启动完成(托盘图标停止动画)

  3. 接受服务协议

4. 验证安装

打开 PowerShell 或 CMD,执行:

docker --version

成功输出:

Docker version 27.3.1, build xxx

运行测试容器:

docker run hello-world

成功输出:

Hello from Docker!
This message shows that your installation appears to be working correctly.

方案二:WSL2 安装 Docker(推荐进阶用户)

这种方式在 WSL2 的 Linux 环境中运行 Docker,纯命令行体验。

步骤 1:安装 WSL2

管理员身份打开 PowerShell,执行:

# 启用 WSL
wsl --install

执行后重启电脑,系统会自动安装 Ubuntu 和 WSL2。

步骤 2:进入 WSL2

重启完成后,打开终端,进入 Ubuntu:

wsl

步骤 3:在 WSL2 中安装 Docker

# 1. 更新包列表
sudo apt update

# 2. 安装必要依赖
sudo apt install -y ca-certificates curl gnupg

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

# 4. 添加 Docker 仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5. 更新包索引
sudo apt update

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

# 7. 启动 Docker 服务
sudo service docker start

步骤 4:验证安装

sudo docker run hello-world

成功输出:

Hello from Docker!
This message shows that your installation appears to be working correctly.

步骤 5:免 sudo 使用 Docker(可选)

每次运行 docker 都要 sudo 很麻烦,可以把当前用户加入 docker 组:

# 添加用户到 docker 组
sudo usermod -aG docker $USER

# 退出 WSL
exit

# 重新进入 WSL
wsl

现在可以直接使用 docker 命令了:

docker ps
docker run hello-world

docker镜像源

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
	"registry-mirrors": [
		"https://docker.1panel.live",
		"https://docker.1panel.dev",
		"https://docker.1ms.run",
		"https://docker.1panel.live",
		"https://docker.1ms.run",
		"https://hub.1panel.dev",
		"https://docker.1panel.live",
		"https://docker.kejilion.pro",
		"https://docker.hlmirror.com",
		"https://hubp.me",
		"https://hub3.nat.tf",
		"https://hub4.nat.tf"
	]
}

docker Desktop汉化

一篇就够!Windows上Docker Desktop安装 + 汉化完整指南(包含解决wsl更新失败方案)_docker汉化-CSDN博客

两种方案对比

特性

Docker Desktop

WSL2 + Docker

安装难度

简单

中等

界面

有 GUI

纯命令行

资源占用

稍高

较低

启动速度

需要启动应用

随 WSL 即时启动

文件系统

Windows/Linux 混合

纯 Linux

推荐场景

日常开发

服务器/命令行爱好者


Docker 常用命令

# 查看版本
docker --version

# 运行容器
docker run hello-world

# 查看运行中的容器
docker ps

# 查看所有容器
docker ps -a

# 停止容器
docker stop <容器名或ID>

# 删除容器
docker rm <容器名或ID>

# 查看镜像
docker images

# 删除镜像
docker rmi <镜像名或ID>

常见问题

Q1: WSL2 安装后无法启动

确保你的 Windows 10 版本不低于 19044,或使用 Windows 11。

Q2: Docker 启动失败

检查虚拟化是否启用:

  1. 以管理员身份打开 PowerShell

  2. 执行:systeminfo

  3. 查看「Hyper-V 要求」部分

Q3: WSL2 中 Docker 每次都要手动启动

~/.bashrc 中添加:

sudo service docker start > /dev/null 2>&1 &

总结

  • 新手推荐:Docker Desktop,安装简单,上手快

  • 进阶推荐:WSL2 + Docker,纯命令行,更灵活

  • 两种方式都支持:可以同时安装,根据需要切换


参考资料:

Vite环境变量实现原理 2026-02-24
Windows 下使用 Scoop 安装 Maven 2026-02-24

评论区