从Docker到Docker Compose：完整实战教程

2025.11.12 更新docker compose使用案例和教程

一、Docker核心入门#

1.1 什么是Docker？#

Docker是一款开源的容器化平台，它能将应用程序及其依赖环境打包成一个标准化的“容器”，实现“一次构建，到处运行”的目标。与传统虚拟机相比，Docker容器更轻量、启动更快、资源占用更低——虚拟机需要模拟完整操作系统，而容器则共享宿主机内核，仅封装应用所需的运行时环境。

核心价值：解决开发环境与生产环境“不一致”的痛点，简化服务部署流程，提升运维效率。

1.2 Docker核心概念#

镜像（Image）：容器的“模板”，包含运行应用所需的代码、依赖、环境变量等，可理解为只读的系统快照。
容器（Container）：镜像的“运行实例”，是动态的、可读写的，容器间相互隔离，拥有独立的文件系统。
仓库（Repository）：存储镜像的远程服务，类似代码仓库，Docker Hub（https://hub.docker.com/）是官方公共仓库。
Docker Engine：Docker的核心服务，负责管理镜像和容器的生命周期。

二、Docker安装指南#

Ubuntu 18.04及以上版本推荐使用官方脚本自动安装，步骤如下：

1
# 下载并执行Docker官方安装脚本
2
curl -fsSL https://get.docker.com -o get-docker.sh
3
sudo sh get-docker.sh
4

5
# 启动Docker服务
6
sudo systemctl start docker
7
sudo systemctl enable docker

三、Docker基础使用命令#

3.1 镜像操作#

当运行容器时，使用的镜像如果在本地中不存在，docker 就会自动从 docker 镜像仓库中下载，默认是从 Docker Hub 公共镜像源下载。

1
# 1. 从仓库拉取镜像（格式：docker pull 镜像名:标签，标签默认latest）
2
docker pull nginx:1.23  # 拉取nginx 1.23版本
3
docker pull redis       # 拉取redis最新版本
4

5
# 2. 查看本地镜像列表
6
docker images
7

8
# 3. 删除本地镜像（需先删除依赖该镜像的容器）
9
docker rmi nginx:1.23  # 按镜像名删除
10
docker rmi -f 镜像ID    # 强制删除（-f）
11

12
# 4. 搜索远程仓库镜像
13
docker search mysql

3.2 容器操作#

1
# 1. 创建并启动容器（格式：docker run [选项] 镜像名 [命令]）
2
# -d：后台运行；-p 宿主机端口:容器端口：端口映射；--name：指定容器名
3
docker run -d -p 80:80 --name my-nginx nginx:1.23
4

5
# 2. 查看容器状态
6
docker ps          # 查看运行中的容器
7
docker ps -a       # 查看所有容器（包括停止的）
8

9
# 3. 启动/停止/重启容器
10
docker start my-nginx   # 启动容器
11
docker stop my-nginx    # 停止容器
12
docker restart my-nginx # 重启容器
13

14
# 4. 进入运行中的容器（交互模式）
15
docker exec -it my-nginx /bin/bash  # -it：交互终端
16

17
# 5. 查看容器日志
18
docker logs -f my-nginx  # -f：实时跟踪日志
19

20
# 6. 删除容器（需先停止容器，或用-f强制删除）
21
docker rm my-nginx
22
docker rm -f my-nginx

3.3 数据卷操作（持久化数据）#

容器删除后数据会丢失，通过数据卷挂载宿主机目录或匿名卷实现数据持久化：

1
# 1. 挂载宿主机目录到容器（格式：-v 宿主机路径:容器路径）
2
docker run -d -p 80:80 -v /host/nginx/html:/usr/share/nginx/html --name my-nginx nginx:1.23
3

4
# 2. 创建并使用命名数据卷
5
docker volume create nginx-data  # 创建命名卷
6
docker run -d -p 80:80 -v nginx-data:/usr/share/nginx/html --name my-nginx nginx:1.23

四、Docker Compose进阶#

当应用依赖多个服务（如 Web 服务 + 数据库 + 缓存）时，手动管理多个容器效率低下。Docker Compose 通过 YAML 文件定义多容器服务组合，一键启动 / 停止所有服务，是多容器部署的核心工具。

4.1 Compose 简介与安装#

Compose 是定义和运行多容器 Docker 应用的工具，核心流程分三步：

用 Dockerfile 定义应用环境；
用docker-compose.yml定义所有服务配置；
执行docker-compose up一键启动整个应用。

安装步骤（Linux）#

从 Github 下载二进制包安装，最新版本可查看Compose 官方 Releases：

1
# 下载指定版本（替换1.24.1为最新版本）
2
sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
3

4
# 赋予可执行权限
5
sudo chmod +x /usr/local/bin/docker-compose
6

7
# 创建软链接（可选，解决命令路径问题）
8
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
9

10
# 验证安装成功
11
docker-compose --version

提示：Alpine 系统需先安装依赖包：py-pip、python-dev、libffi-dev、openssl-dev、gcc、libc-dev、make。

4.2 Compose 配置文件核心逻辑#

docker-compose.yml是 Compose 的核心，文件名可自定义（需用-f参数指定，如docker-compose -f my-compose.yml up）。其层级结构严格，后一层级需比前一层级后退 2 个空格或 1 个 Tab，格式错误易导致运行失败。

核心层级关系#

第 1 级：version和services为顶层参数。version仅标识配置版本，不参与运行；services定义所有需启动的服务。
第 2 级：服务名称（如app、db），可自定义但不可重复，作为容器在局域网内的通信标识。
第 3 级：容器核心参数，包括镜像（image）、重启策略（restart）、端口映射（ports）、目录映射（volumes）等。
第 4 级：参数具体配置，如端口映射格式为 “宿主端口：容器端口”。

服务命名习惯#

我个人习惯按功能命名服务：核心应用叫app、数据库叫db、缓存叫redis（或cache），这样仅看名称就能知晓服务角色，方便管理。

镜像标签（tag）使用建议#

不推荐直接用:latest（默认标签）：不同时间的latest对应不同版本，不利于迁移和镜像复用，多个服务共用同一镜像时可能重复下载。
推荐用法：指定具体 tag（如mysql:5.7），可在 Docker Hub 查询最新版本，也可通过 RSShub 订阅版本更新。
特殊场景可使用:latest：WordPress（支持后台更新）、需频繁更新的镜像。

4.3 实战实例：WordPress 多服务部署#

以下是一个完整的 WordPress 部署配置，包含 Web 应用（WordPress）、数据库（MySQL）和缓存（Redis）三个服务，可直观体现 Compose 对多服务依赖的管理能力：

1
version: '3.0'
2

3
services:
4
  # MySQL数据库服务
5
  db:
6
    image: mysql:5.7 # 注意：arm架构机器（如M1/M2 Mac）需改为mysql:oracle
7
    container_name: wordpress-db # 自定义容器名，便于管理
8
    restart: unless-stopped # 重启策略：除非手动停止，否则总是重启
9
    # command: --max-binlog-size=200M --expire-logs-days=2 # MySQL 8.0建议添加，限制日志大小
10
    environment: # 数据库环境变量（核心配置，需妥善保存）
11
      MYSQL_ROOT_PASSWORD: rootpassword # 数据库root密码，建议改为复杂密码
12
      MYSQL_DATABASE: wordpress # 为WordPress创建的数据库名
13
      MYSQL_USER: wordpress # 为WordPress授权的数据库用户
14
      MYSQL_PASSWORD: yourpassword # 数据库用户密码，建议与root密码区分
15
    volumes: # 数据持久化：将主机目录挂载到容器，避免容器删除后数据丢失
16
      - './db:/var/lib/mysql'
17
    networks: # 加入自定义网络，实现服务间隔离通信
18
      - default
19

20
  # WordPress应用服务
21
  app:
22
    image: wordpress:latest # 官方WordPress最新镜像
23
    container_name: wordpress-app
24
    restart: unless-stopped
25
    ports: # 端口映射：主机18080端口 → 容器80端口（需确保主机防火墙开放18080）
26
      - 18080:80
27
    environment: # 关联数据库配置，与db服务的环境变量对应
28
      WORDPRESS_DB_HOST: db # 数据库服务名（Compose自动解析为容器IP）
29
      WORDPRESS_DB_NAME: wordpress
30
      WORDPRESS_DB_USER: wordpress
31
      WORDPRESS_DB_PASSWORD: yourpassword
32
    volumes: # 持久化WordPress代码和主题文件
33
      - './app:/var/www/html'
34
    links: # 显式关联db服务（兼容旧版本Compose，可配合depends_on使用）
35
      - db:db
36
    depends_on: # 依赖关系：确保redis和db启动后再启动app
37
      - redis
38
      - db
39
    networks:
40
      - default
41

42
  # Redis缓存服务（提升WordPress访问速度）
43
  redis:
44
    image: redis:alpine # alpine版本镜像更小，资源占用低
45
    container_name: wordpress-redis
46
    restart: unless-stopped
47
    volumes: # 持久化Redis缓存数据
48
      - ./redis-data:/data
49
    networks:
50
      - default
51

52
# 自定义网络：所有服务加入同一网络，服务名即主机名
53
networks:
54
  default:
55
    name: wordpress

实例参数详解#

顶层配置
- version: '3.0'：标识 Compose 配置版本，需与 Docker Engine 版本兼容。
- services：定义所有服务的集合，包含db（数据库）、app（WordPress 应用）、redis（缓存）三个服务。
- networks：定义网络配置，此处创建名为wordpress的自定义网络，所有服务加入该网络实现隔离通信。
db 服务（MySQL 数据库）
- image: mysql:5.7：指定使用 MySQL 5.7 版本镜像（arm 架构需替换为mysql:oracle）。
- container_name: wordpress-db：自定义容器名称，便于识别和管理。
- restart: unless-stopped：重启策略，除非手动停止，否则容器退出后自动重启。
- environment：设置环境变量，包括数据库 root 密码、默认数据库名、用户及密码（需自行修改为复杂密码）。
- volumes: - './db:/var/lib/mysql'：将宿主机当前目录下的db文件夹挂载到容器的/var/lib/mysql（MySQL 数据存储目录），实现数据持久化。
- networks: - default：加入default网络（即wordpress网络）。
app 服务（WordPress 应用）
- image: wordpress:latest：使用 WordPress 最新镜像（推荐用latest，支持后台直接更新）。
- ports: - 18080:80：端口映射，宿主机 18080 端口映射到容器 80 端口（需确保宿主机防火墙开放 18080 端口）。
- environment：配置数据库连接信息，WORDPRESS_DB_HOST: db直接使用db服务名作为地址（Compose 自动解析为容器 IP）。
- volumes: - './app:/var/www/html'：挂载 WordPress 代码目录，确保主题、插件等文件持久化。
- links: - db:db：显式关联db服务，建立网络通信（兼容旧版本 Compose）。
- depends_on: - redis - db：定义启动顺序，确保redis和db启动后再启动app，避免依赖服务未就绪导致的错误。
redis 服务（缓存）
- image: redis:alpine：使用轻量的 Alpine 版本 Redis 镜像，减少资源占用。
- volumes: - ./redis-data:/data：挂载 Redis 数据目录，持久化缓存数据。

4.4 Compose 核心命令#

1
# 启动服务（前台运行，日志实时输出）
2
docker-compose up
3

4
# 后台启动服务（推荐）
5
docker-compose up -d
6

7
# 查看运行中的服务
8
docker-compose ps
9

10
# 停止服务（保留容器和数据）
11
docker-compose stop
12

13
# 停止并删除服务、容器、网络（保留数据卷）
14
docker-compose down
15

16
# 停止并删除所有（包括数据卷）
17
docker-compose down -v
18

19
# 拉取最新镜像（针对:latest标签）
20
docker-compose pull
21

22
# 查看服务日志
23
docker-compose logs -f

五、总结#

Docker 解决了 “环境一致性” 问题，而 Docker Compose 则解决了 “多容器管理复杂性” 问题。它将繁琐的docker run命令整合为结构化的 YAML 文件，不仅层级清晰、易于维护，还支持服务依赖、自定义网络等复杂场景。

对我而言，Compose 早已取代了docker run和后台 GUI 工具 —— 配置文件可备份、可复用，迁移时只需执行docker-compose up -d即可快速启动整个应用，效率大幅提升。

音乐

音乐