手把手教你 Linux 服务器和 Windows 安装 Docker 环境(附避坑指南)
视频看了几百小时还迷糊?关注我,几分钟让你秒懂!
🧩 一、为什么要在服务器上装 Docker?
你是不是经常遇到这些问题:
- 开发环境跑得好好的,部署到服务器就“水土不服”?
- 想快速部署多个微服务,但手动配置 JDK、MySQL、Redis 太麻烦?
- 团队协作时,每个人的本地环境都不一样,调试成本高?
Docker 就是你的“环境打包机”!
它能把应用 + 依赖 + 配置打包成一个标准化的容器,在任何支持 Docker 的机器上一键运行。
而要使用 Docker,第一步就是——正确安装 Docker 环境!
本文将手把手教你:
- ✅ 在 Linux 服务器(以 CentOS 7 / Ubuntu 22.04 为例) 上安装 Docker
- ✅ 在 Windows 10/11 家庭版 & 专业版 上安装 Docker Desktop
🐧 二、Linux 服务器安装 Docker(CentOS 7 & Ubuntu)
✅ 场景说明
你有一台云服务器(阿里云、腾讯云、AWS 等),系统是 CentOS 7 或 Ubuntu 22.04,想部署 Spring Boot 应用,需要先装 Docker。
🔧 步骤 1:卸载旧版本(如有)
# CentOS
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine
# Ubuntu
sudo apt-get remove docker docker-engine docker.io containerd runc
💡 大多数新服务器没有旧版本,可跳过。
🔧 步骤 2:安装必要依赖
CentOS 7
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
Ubuntu 22.04
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release
# 添加 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.gpg
# 设置仓库
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/null
🔧 步骤 3:安装 Docker Engine
CentOS
sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Ubuntu
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
🔧 步骤 4:启动 Docker 并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
验证是否安装成功:
sudo docker --version
# 输出示例:Docker version 25.0.3, build 4413d67
🔧 步骤 5:【重要】免 sudo 运行 Docker(非 root 用户)
默认只有 root 能操作 Docker,普通用户需加 sudo,很麻烦。
解决方法:把当前用户加入 docker 用户组。
sudo usermod -aG docker $USER
然后 重新登录终端(或执行 newgrp docker),之后就可以直接运行:
docker run hello-world
✅ 如果看到 “Hello from Docker!”,恭喜你,Linux 环境安装成功!
💻 三、Windows 安装 Docker(家庭版 vs 专业版)
⚠️ 注意:Windows 对 Docker 的支持分两种情况!
| 系统版本 | 推荐方案 |
|---|---|
| Windows 10/11 专业版、企业版、教育版 | 安装 Docker Desktop(原生支持 WSL2) |
| Windows 10/11 家庭版 | 必须先启用 WSL2,再安装 Docker Desktop |
✅ 场景说明
你在本地 Windows 电脑开发 Spring Boot 项目,想用 Docker 测试容器化部署。
🔧 步骤 1:确认系统要求
- Windows 10 64位:版本 2004 及以上(Build 19041+)
- Windows 11 任意版本
- BIOS 中开启 虚拟化(VT-x/AMD-V)
💡 如何查看?按
Win+R输入winver查看版本。
🔧 步骤 2:安装 WSL2(Windows Subsystem for Linux)
即使你是专业版,Docker Desktop 也强烈建议使用 WSL2 后端(性能更好)。
以管理员身份打开 PowerShell,执行:
# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑!
重启后,设置 WSL2 为默认版本:
wsl --set-default-version 2
💡 如果提示“WSL2 内核未安装”,去微软官网下载:
https://aka.ms/wsl2kernel
🔧 步骤 3:安装 Docker Desktop
-
访问官网下载安装包:
👉 https://www.docker.com/products/docker-desktop/ -
双击安装,勾选“Use WSL 2 instead of Hyper-V”(关键!)
-
安装完成后重启 Docker Desktop
-
打开 PowerShell 或 CMD,运行:
docker --version
docker run hello-world
✅ 如果看到欢迎信息,说明安装成功!
❌ 四、反例:新手常踩的坑
反例 1:在 CentOS 7 上直接 yum install docker
- 系统自带的
docker包是老版本(叫docker,不是docker-ce) - 功能缺失,兼容性差,千万别用!
✅ 正确做法:必须添加官方仓库,安装 docker-ce
反例 2:Windows 家庭版强行装 Docker Toolbox
- Docker Toolbox 是 2016 年的老方案,基于 VirtualBox
- 性能差、网络复杂、已停止维护
- 很多人因此放弃 Docker
✅ 正确做法:家庭版也能用 Docker Desktop,只要先装 WSL2!
反例 3:Linux 安装后不加用户组,每次都要 sudo
- 长期使用非常不便
- 还可能因权限问题导致 volume 挂载失败
✅ 正确做法:sudo usermod -aG docker $USER + 重新登录
⚠️ 五、注意事项
-
国内用户建议配置镜像加速器
编辑/etc/docker/daemon.json(Linux)或 Docker Desktop 设置 → Docker Engine:{ "registry-mirrors": [ "https://hub-mirror.c.163.com", "https://docker.mirrors.ustc.edu.cn" ] }然后重启 Docker:
sudo systemctl restart docker -
Windows 下路径挂载注意大小写和权限
建议把项目放在 WSL2 的 Linux 文件系统中(如wsl$Ubuntuhome...),而不是 Windows 盘符。 -
不要在生产服务器用 Docker Desktop
Docker Desktop 是桌面工具,仅用于开发。生产环境请用 Docker Engine(Linux)。 -
定期清理无用镜像和容器
docker system prune -a
✅ 六、验证安装:跑一个 Spring Boot 示例(可选)
你可以用之前文章中的 Spring Boot 项目,构建镜像并运行:
# 构建镜像(假设已有 Dockerfile)
docker build -t myapp .
# 运行
docker run -d -p 8080:8080 myapp
访问 http://localhost:8080/hello,看到返回即成功!
📌 总结
| 系统 | 关键步骤 |
|---|---|
| Linux (CentOS/Ubuntu) | 添加官方源 → 安装 docker-ce → 启动服务 → 加入 docker 用户组 |
| Windows 专业版 | 启用 WSL2 → 安装 Docker Desktop → 使用 WSL2 后端 |
| Windows 家庭版 | 同上!家庭版也能用 Docker Desktop(前提是 WSL2) |
只要按步骤来,99% 的安装问题都能避免!
视频看了几百小时还迷糊?关注我,几分钟让你秒懂!










