从零开始学 Docker：小白也能轻松上手的容器化实战指南

💡 一句话理解 Docker：它就像一个「标准化的软件快递盒」——把你的代码、依赖、配置全部打包好，扔到任何装了 Docker 的电脑或服务器上，都能原样运行，彻底告别“在我电脑上是好的”这种经典玄学。

---

① 技术栈用途介绍：Docker 到底能解决什么问题？

想象你是一位刚入职的实习生，接到任务：把公司老系统（Spring Boot + MySQL）部署到测试服务器上。

❌ 传统做法：

• 手动安装 JDK 17、Maven、MySQL 8.0、配置环境变量……
• 配置文件改来改去，结果发现服务器用的是 CentOS，而你本地是 macOS，路径/权限/编码全不同……
• 最后花了两天，还是报错 java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver……

✅ Docker 的解法：

一次构建，处处运行。你只需写好一个 Dockerfile（就像一份“打包说明书”），Docker 就会自动拉取 Ubuntu 系统、安装 JDK、复制你的 jar 包、启动应用——全程自动化、可复现、不污染宿主机。

🔹 典型场景：

• 快速搭建本地开发环境（如一键启动 MySQL + Redis + Nginx）
• 微服务项目中统一各服务运行环境
• CI/CD 流水线中标准化构建与测试
• 个人作品集部署（比如把博客一键发到云服务器）

---

② 环境准备与安装配置（Windows/macOS/Linux 通用）

✅ 步骤 1：安装 Docker Desktop（推荐新手）

• 官网下载：https://www.docker.com/products/docker-desktop/
• Windows：需开启 WSL2（安装时勾选自动配置）
• macOS：直接双击 .dmg 安装
• Linux（Ubuntu）：终端执行

  sudo apt update && sudo apt install docker.io -y
  sudo systemctl enable docker && sudo systemctl start docker
  sudo usermod -aG docker $USER  # 加入 docker 用户组，避免每次 sudo
  

✅ 步骤 2：验证安装

$ docker --version
Docker version 24.0.7, build afdd53b

$ docker run hello-world
# 出现 "Hello from Docker!" 即成功！

⚠️ 新手常踩坑：

• ❌ Permission denied while trying to connect to the Docker daemon socket → 重启终端或执行 newgrp docker；
• ❌ Cannot connect to the Docker daemon → 检查 Docker Desktop 是否已启动（Mac/Win 托盘图标亮起）；
• ❌ 拉镜像超慢 → 配置国内镜像源（阿里云免费加速器）：

  Docker Desktop → Settings → Docker Engine → 在 registry-mirrors 中添加： "https://<your-code>.mirror.aliyuncs.com"（登录阿里云容器镜像服务获取专属地址）

---

③ 入门实践：5 分钟跑通一个 Spring Boot Web 容器

我们用最简方式，部署一个返回 Hello Docker! 的 Spring Boot 应用。

📁 Step 1：创建最小 Spring Boot 项目（无需 IDE）

访问 https://start.spring.io/，选择：

• Project：Maven
• Language：Java
• Spring Boot：3.2.x
• Dependencies：Spring Web → 点击 Generate 下载 demo.zip，解压到 ~/docker-demo

📄 Step 2：编写 Dockerfile（放在项目根目录）

# 使用官方 OpenJDK 基础镜像
FROM openjdk:17-jre-slim

# 设置工作目录
WORKDIR /app

# 复制打包好的 jar（注意：先用 mvn clean package 打包）
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar

# 暴露 8080 端口
EXPOSE 8080

# 启动应用
ENTRYPOINT ["java","-jar","app.jar"]

⚙️ Step 3：构建并运行容器

# 1️⃣ 进入项目目录
cd ~/docker-demo

# 2️⃣ 打包（确保有 Maven）
mvn clean package -DskipTests

# 3️⃣ 构建镜像（注意最后的点 .）
docker build -t my-spring-app .

# 4️⃣ 运行容器，映射 8080 端口
# -d：后台运行；--name：起个名字；-p：端口映射

docker run -d --name demo-app -p 8080:8080 my-spring-app

# 5️⃣ 访问验证 👉 打开浏览器 http://localhost:8080
# 如果看到 Whitelabel Error Page —— 别慌！这是正常现象（没写接口）

✨ Step 4：加个接口，让它真正“说话”

在 src/main/java/com/example/demo/DemoApplication.java 同包下新建 HelloController.java：

@RestController
public class HelloController {
    @GetMapping("/")
    public String hello() {
        return "Hello Docker! 🐳";
    }
}

重新 mvn clean package → docker build -t my-spring-app . → docker restart demo-app，再刷新网页 ✅

📌 关键命令速记卡： | 命令 | 作用 | |------|------| | docker ps | 查看正在运行的容器 | | docker logs demo-app | 查看容器日志（排错神器） | | docker stop demo-app | 停止容器 | | docker rm demo-app | 删除已停止容器 | | docker images | 查看本地镜像 |

---

④ 进阶与原理：不只是“打包”，更是环境治理哲学

🔍 镜像分层机制（为什么构建快、推送小？）

Docker 镜像是「只读层叠加」：

[base: ubuntu] ← 最底层（操作系统）
  ↓
[openjdk:17]   ← 第二层（JDK）
  ↓
[app.jar]      ← 你的代码层（仅几 MB）

✅ 优势：多个项目共用 base 层，磁盘不重复占用；更新代码只重传最后一层。

🧩 Compose 编排：一键启动“全家桶”

想同时跑 Spring Boot + MySQL？不用手动启两个容器！

新建 docker-compose.yml：

services:
  app:
    build: .
    ports: ["8080:8080"]
    depends_on: [db]
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/mydb

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: mydb
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

→ 一行命令启动整套环境：docker compose up -d

🛡️ 安全提醒（生产必看）

• ❌ 不要用 root 用户运行容器（Dockerfile 中加 USER nonroot:nonroot）
• ❌ 不要把 application.yml 密码硬编码进镜像（改用 --env-file 或 secrets）
• ✅ 开启 Docker Content Trust（export DOCKER_CONTENT_TRUST=1）防恶意镜像

---

⑤ 总结与评估：Docker 适合谁？什么时候该用？

| 维度 | 说明 | |------|------| | ✅ 核心优势 | 环境一致性高、学习曲线平缓、生态成熟（文档/教程极多）、CI/CD 友好、资源隔离轻量（对比虚拟机） | | ⚠️ 局限性 | Windows/macOS 上需虚拟化层（略慢）；不适合需要内核级调优的场景（如高频网络转发）；初学者易混淆「镜像/容器/卷/网络」概念 | | 🆚 vs 虚拟机（VM） | VM 模拟整台电脑（GB 级），Docker 共享宿主机内核（MB 级），启动秒级 vs 分钟级 | | 🆚 vs Podman | Podman 无守护进程、更安全，但生态和 Windows 支持弱于 Docker（目前仍推荐 Docker 入门） |

📚 后续学习建议：

1. 巩固：动手用 Docker 部署一个带前端（Vue）+ 后端（Spring Boot）+ 数据库（PostgreSQL）的 TodoList 全栈项目；
2. 进阶：学习 Docker Network（自定义桥接网络）、Docker Volume（持久化数据）；
3. 跃迁：无缝过渡到 Kubernetes（K8s 就是“Docker 容器的超级管理员”）；
4. 延伸阅读：《Docker —— 从入门到实践》（开源免费电子书，https://yeasy.gitbook.io/docker_practice/）

---

🌈 最后送你一句心法： “不要试图理解所有命令，先让一个容器跑起来；不要纠结最佳实践，先完成再完美。” 你已经比 90% 的人更接近真正的工程化思维了。

---

✅ 文末彩蛋：本文全部操作命令已整理为可一键执行的 Shell 脚本，关注公众号【码农小白成长记】回复「docker-cheatsheet」免费领取 👇