一张结构图（PPT 第 16 页）#

这张图按角色拆开看：

端口映射是怎么回事（PPT 第 18 页的示意图）#

第 18 页右侧画了一张端口映射的示意图，信息量都在上面：

1
        宿主机 192.168.100.128                容器（隔离环境）
2
        ┌──────────────────┐                 ┌──────────────────┐
3
        │   端口 3307      │ ──── 映射 ────► │   端口 3306      │
4
        └──────────────────┘                 │   （MySQL 在里面）│
5
                                             └──────────────────┘
6
   项目里连数据库写的是：
7
   jdbc:mysql://192.168.100.128:3307        ← 宿主机 IP + 宿主机端口

• 为什么要映射：容器是隔离的，它的 3306 只活在容器自己的网络里，外面的机器根本看不见。-p 3307:3306 就是在宿主机上开一个 3307 的口子，所有发给”宿主机 3307”的流量都转进容器的 3306。
• 为什么左边写 3307：因为宿主机的 3306 通常留给”机器上原来那个 MySQL”（或者留给以后别的容器）——一个端口只能被一个东西占用，把容器映射到 3307 就互不打架了。
• 连接串怎么写：PPT 第 18 页写得很清楚——jdbc:mysql://192.168.100.128:3307。写的是宿主机的 IP 和宿主机的端口，不是 3306、也不是容器的 IP。项目在宿主机上跑（或从 Windows 连服务器）时，走的就是这条映射通道。
• 顺序记法：-p 宿主机:容器——“外面 : 里面”，和 109 篇 nginx 反向代理”外面 80 → 里面 8080”是同一个思路。

-e 的两条环境变量#

第 14 页的命令里给了两条 -e，一条是时区、一条是密码：

这也解释了 -e 的意义：镜像把”可配置的东西”留成了环境变量，用 -e 在启动时传进去——不传就用默认值（或者像 MYSQL_ROOT_PASSWORD 这样必须传）。想知道某个镜像支持哪些 -e，看它在 Docker Hub 上的说明页（PPT 第 32 页的 MySQL 案例就标注了”官方文档”）。

一、知识回顾（读完直接做下面的实践题）#

1. Docker 是什么：一款快速构建、运行、管理应用的工具（PPT 第 2、11 页）——构建是把应用和环境打成镜像、运行是把镜像跑成容器、管理是起停删看日志
2. 它冲着哪三条痛点来的（PPT 第 8 页）：命令太太太多记不住、步骤太太太多易出错、安装包哪里下载找不到——分别对应”一条 docker run”、“环境已在镜像里”、“从镜像仓库拉现成的”
3. 镜像是什么：把应用本身 + 运行环境 + 配置 + 系统函数库一起打包得到的文件包（PPT 第 15、17 页）
4. 容器是什么：运行镜像时创建的隔离运行环境，为每个镜像的应用进程各建一个——同一个镜像能起多个互不干扰的容器（PPT 第 15、17 页）
5. 镜像仓库是什么：存储和管理镜像的平台；Docker Hub 是最大的公共仓库（PPT 第 17 页）
6. 结构图上的四个角色：Client（敲 docker run/pull/build 的地方）→ docker daemon（守护进程，真正干活）→ 本地 Images 与 Containers；另一头 Registry 镜像仓库（PPT 第 16 页）
7. 镜像命名规范：[repository]:[tag]，如 mysql:8——repository 是镜像名、tag 是版本；不写 tag 默认 latest（PPT 第 19 页）
8. docker run 四个参数：-d 让容器后台运行、--name 给容器命名（必须唯一）、-p 设置端口映射（宿主机端口:容器端口）、-e KEY=VALUE 设置环境变量（PPT 第 18、20 页）
9. 端口映射怎么理解：容器是隔离的，外面看不见它的 3306；-p 3307:3306 把宿主机的 3307 转到容器的 3306，项目里连数据库写 jdbc:mysql://192.168.100.128:3307——宿主机 IP + 宿主机端口（PPT 第 18 页）
10. 装 MySQL 的那条命令 + 前置条件：docker run -d --name mysql -p 3307:3306 -e TZ=Asia/Shanghai -e MYSQL_ROOT_PASSWORD=123 mysql:8；前置是”先停掉机器上原来的 MySQL、装好 Docker、网络开通”（PPT 第 14 页）。TZ 管时区，MYSQL_ROOT_PASSWORD 是 MySQL 镜像要求的初始 root 密码
11. 本机实测（Docker Desktop 29.1.3）：docker --version → 29.1.3、Compose → v2.40.3；docker info 里 Registry Mirrors: []（没配加速）；裸名拉镜像报 failed to authorize ... EOF；带前缀的镜像名 docker.m.daocloud.io/library/xxx 可以正常用

二、裸写题#

• 2-1 用一条命令把 MySQL 跑起来 需求：一台装好 Docker、能联网的 Linux 服务器（IP 192.168.100.128）。要求用一条命令起一个 MySQL 容器：后台运行、容器名叫 mysql、用 mysql:8 这个镜像、时区设成上海、root 初始密码设成 123，并且让服务器外面的机器能连上这个数据库（映射到宿主机的 3307）。 素材：容器里的 MySQL 监听 3306；服务器上原来装的 MySQL 要先停掉。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：四个参数各管一件事——后台、名字、端口、环境变量，最后跟上镜像名；顺序是”命令 → 参数 → 镜像名” 二级 · 方法：docker run -d --name … -p 宿主机端口:容器端口 -e KEY=VALUE 镜像名:tag；端口映射左外右内（宿主机 3307 → 容器 3306）；两条 -e 分别是 TZ=Asia/Shanghai 与 MYSQL_ROOT_PASSWORD=123 三级 · 骨架：docker run -____ --____ mysql -p ____:____ -e TZ=____ -e MYSQL_ROOT_PASSWORD=____ mysql:____

  参考答案（做完再点开）

  1
  docker run -d \
  2
    --name mysql \
  3
    -p 3307:3306 \
  4
    -e TZ=Asia/Shanghai \
  5
    -e MYSQL_ROOT_PASSWORD=123 \
  6
    mysql:8

  逐段对号：-d 后台运行；--name mysql 容器名（唯一）；-p 3307:3306 宿主机的 3307 映射到容器里的 3306；-e TZ=Asia/Shanghai 时区；-e MYSQL_ROOT_PASSWORD=123 root 初始密码；mysql:8 镜像名与版本。 验证：docker ps 能看到 mysql 容器在运行、PORTS 列显示 0.0.0.0:3307->3306/tcp；在别的机器上用客户端连 192.168.100.128:3307，用户名 root、密码 123。 注意：① 顺序是 宿主机:容器，写反了就连不上；② 名字重复会报冲突（先 docker ps -a 看看有没有同名容器）；③ 不写 tag 就是 latest，课程统一用 mysql:8。

• 2-2 读懂别人写的一条命令 需求：同事给了你一条命令，让你说清它干了什么： docker run -d --name nginx -p 80:80 -e TZ=Asia/Shanghai nginx:1.20.2 请回答：① 这条命令要起什么、起完之后容器叫什么名字；② -p 80:80 两边的 80 分别是谁的端口、为什么这次两边可以写成一样；③ -e TZ=Asia/Shanghai 有什么用；④ 如果本地没有 nginx:1.20.2 这个镜像，Docker 会做什么；⑤ 命令跑完之后，用哪条命令能确认容器在运行。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：把命令拆成”命令本体 + 参数 + 镜像名”三块，参数一个一个对号；“本地没有镜像”这件事想一想第 10 页那份拉取日志 二级 · 方法：-d 后台、--name 名字、-p 宿主机:容器、-e 环境变量、镜像名:tag；本地没有镜像时 Docker 会自动去镜像仓库搜索并下载；查看运行中容器用 docker ps 三级 · 骨架：① 起的是 ____ 应用、容器名 ____；② 左边 80 是 ____ 的、右边 80 是 ____ 的，两边相同是因为 ____；③ -e 设置的是 ____；④ 本地没有镜像时 Docker 会去 ____ 下载；⑤ 确认命令是 docker ____

  参考答案（做完再点开）

  ① 起的是 nginx（Web 服务器）；容器名字叫 nginx（--name nginx）。 ② -p 80:80 是”宿主机 80 : 容器 80”：左边是服务器对外开的端口，右边是容器里 nginx 真正监听的端口。两边都写 80 是因为宿主机的 80 正好空着（没有被别的程序占用）——如果宿主机 80 被占了（比如 109 篇里那个装在机器上的 nginx 还在跑），就要改成 -p 90:80 之类，左边随便换、右边不能动（右边由镜像里的程序决定）。 ③ -e TZ=Asia/Shanghai 把容器里的时区设成上海，避免日志时间差 8 小时。 ④ 本地没有这个镜像时，Docker 自动去镜像仓库（默认 Docker Hub）搜索并下载，下载完再创建容器——就像第 10 页日志里的 Unable to find image … locally → Pulling → Downloaded。 ⑤ docker ps（PORTS 列会显示 0.0.0.0:80->80/tcp）。 补充：这条命令里的容器名、镜像名、端口都是”起容器的人自己定的”，只有 -p 右边那个 80 是镜像里的 nginx 决定的。

• 2-3 镜像名里每一段是什么意思 需求：说出下面三个镜像名各自的 repository 和 tag，并说明它们分别会装到哪个版本： ① mysql:8　② mysql　③ docker.m.daocloud.io/library/alpine:latest 然后回答：本机（Registry Mirrors: []）里用第 ② 种写法拉镜像会报什么错、为什么，两条解决办法分别是什么。

  提示（先自己想，实在想不出再点开）

  一级 · 思路：先按 [repository]:[tag] 切两段；再想”不写 tag 会怎样”；最后把”拉不到镜像”归到网络到镜像仓库不通这件事上 二级 · 方法：[repository]:[tag]，不写 tag 默认 latest；本机没配 Registry Mirror 时直连 auth.docker.io 会失败（failed to authorize ... EOF）；办法是配镜像加速或用带国内源前缀的镜像名 三级 · 骨架：① mysql:8 → 镜像名 ____、版本 ；② mysql → 等价于 mysql:____；③ 完整形式是”仓库地址//镜像名”；④ 报错原文 failed to ____ ... EOF，原因是没配 ____

  参考答案（做完再点开）

  ① mysql:8：repository = mysql、tag = 8，装 MySQL 的 8.x 版本。 ② mysql：没写 tag，等价于 mysql:latest（最新版）——第 10 页日志里的 mysql:latest 就是这么来的。 ③ docker.m.daocloud.io/library/alpine:latest：这是完整形式——docker.m.daocloud.io 是仓库地址（国内源）、library 是命名空间（官方镜像都在它下面）、alpine 是镜像名、latest 是 tag。 拉不到镜像的部分：报错形如

  1
  docker: Error response from daemon: failed to resolve reference "docker.io/library/alpine:latest":
  2
    failed to authorize: ... Get "https://auth.docker.io/token?...": EOF

  原因是没配镜像加速（docker info 里 Registry Mirrors: []），直连 Docker Hub 的认证服务不通。 两条办法：① 配 Registry Mirror（Docker Desktop 设置里加镜像加速地址），之后命令原样可用；② 用带国内源前缀的镜像名（如 docker.m.daocloud.io/library/mysql:8），不改配置、只改镜像名。

• 2-4 找出这条命令里的问题 需求：小明照着 PPT 敲了下面这条命令，结果容器没起来。请逐条指出问题并给出正确写法（一共 4 处）： docker run --name mysql -d -p 3306:3307 -e MYSQL_ROOT_PASSWORD 123 mysql:8 （他想要的是：后台运行的 MySQL 容器、名字叫 mysql、外面的 3307 连到容器里的 3306、root 密码 123。）

  提示（先自己想，实在想不出再点开）

  一级 · 思路：一处一处对”他想要的”和”他写的”——名字、后台、端口方向、环境变量的写法 二级 · 方法：-p 是”宿主机:容器”；-e 是”KEY=VALUE”，等号不能少、中间不能有空格 三级 · 骨架：① 端口顺序应为 -p ____:____；② -e 要写成 -e MYSQL_ROOT_PASSWORD=____；③ 检查容器名是否与已有容器 ____；④ 别忘了镜像名后面的 ____

  参考答案（做完再点开）

  问题（对照”他想要的”）： ① 端口映射写反了：-p 3306:3307 是”宿主机 3306 → 容器 3307”，而他要的是外面 3307 连到容器里的 3306，应写 -p 3307:3306（左外右内）。写反的后果：连 3307 连不上，而且宿主机 3306 上如果还跑着老 MySQL 会直接冲突。 ② -e 少写了等号：-e MYSQL_ROOT_PASSWORD 123 会被当成”环境变量 MYSQL_ROOT_PASSWORD（值为空）+ 一个多余的参数”，必须写 -e MYSQL_ROOT_PASSWORD=123。 ③ 名字可能冲突：--name 必须唯一，如果之前已经有个叫 mysql 的容器（哪怕是停止状态的），这条会报冲突——先 docker ps -a 查，有就先 docker rm 掉或者换个名字。 ④ mysql:8 只写了镜像名和 tag——这条本身没错（不写 tag 默认 latest），但课程统一写 mysql:8 更稳；真正容易漏的是镜像名必须放在最后（参数写完后跟镜像名），顺序写错 Docker 会把它当成参数。 正确写法：

  1
  docker run -d --name mysql -p 3307:3306 -e MYSQL_ROOT_PASSWORD=123 mysql:8

  起完验证：docker ps 看状态与 PORTS；再看一眼容器里 MySQL 的日志 docker logs mysql（111 篇）。

三、综合题#

• 3-1 给新同事写一份”用 Docker 起 MySQL”的交接说明 需求：新同事的电脑上已经装好 Docker Desktop，现在要在一台 Linux 服务器（192.168.100.128）上把 MySQL 跑起来，给开发环境用。请写一份可以照着做的说明，要求包含：

  1. 先交代背景：为什么不用 108 篇那套手工装法（把 PPT 第 8 页的三条痛点写进去）；
  2. 起容器：写出完整命令，并说明每个参数在干什么（后台、名字、端口、两条环境变量、镜像名）；
  3. 说清端口：为什么映射到 3307 而不是 3306，以及连接串应该怎么写；
  4. 验证：至少写出两条”确认它真的起来了”的办法（一条看容器状态、一条看日志或连接）；
  5. 万一拉不到镜像：把本机实测那个坑（报错原文 + 两条解决办法）写进去。
  6. 最后用一张小表把”手工装 vs Docker 装”的差别列出来（找包、安装、启停、卸载、换版本）。
  提示（先自己想，实在想不出再点开）

  一级 · 思路：这份说明要能”从零照着做通”——所以顺序是”为什么 → 怎么做（命令+参数）→ 怎么连（端口与连接串）→ 怎么确认 → 出问题怎么办” 二级 · 方法：命令用 docker run -d --name mysql -p 3307:3306 -e TZ=Asia/Shanghai -e MYSQL_ROOT_PASSWORD=123 mysql:8；验证用 docker ps 和 docker logs mysql（或在别的机器上用客户端连 192.168.100.128:3307）；拉不到镜像时要么配 Registry Mirror、要么把镜像名换成带前缀的形式 三级 · 骨架：① 三条痛点：命令多 / 步骤多 / 包难找；② 命令五段（-d、--name、-p、-e×2、镜像名）；③ 连接串 jdbc:mysql://____:____；④ 验证 docker ____ + docker ____ mysql；⑤ 报错 failed to ____ ... EOF → 配加速或换 ____ 名

  参考答案（做完再点开）

  1
  【用 Docker 起一个 MySQL（开发环境）】
  2
  
  3
  一、为什么不用手工装
  4
    第 19 章那套手工装法的三条代价（PPT 第 8 页）：
  5
    · 命令太太太多，记不住（卸载→解压→环境变量→注册服务→初始化→授权，十几条）
  6
    · 步骤太太太多，易出错（顺序还有讲究，漏一步就卡住）
  7
    · 安装包哪里下载，找不到（官网翻版本、选平台、几百 MB）
  8
    Docker 的做法：环境已经装在镜像里，一条命令起容器。
  9
  
  10
  二、起容器（服务器上执行，先确认机器上原来的 MySQL 已停掉）
  11
    docker run -d \
  12
      --name mysql \
  13
      -p 3307:3306 \
  14
      -e TZ=Asia/Shanghai \
  15
      -e MYSQL_ROOT_PASSWORD=123 \
  16
      mysql:8
  17
    参数对号：
  18
      docker run        创建并运行一个容器
  19
      -d                后台运行（不占终端）
  20
      --name mysql      容器名，必须唯一（后面 docker stop mysql 靠它）
  21
      -p 3307:3306      宿主机 3307 → 容器 3306（左外右内）
  22
      -e TZ=…           时区（不然日志和 now() 差 8 小时）
  23
      -e MYSQL_ROOT_PASSWORD=123   MySQL 镜像要求的 root 初始密码
  24
      mysql:8           镜像名:版本（本地没有会自动去仓库拉）
  25
  
  26
  三、端口与连接串
  27
    容器的 3306 是隔离的、外面看不见，所以映射到宿主机 3307：
  28
    · 宿主机上原来的 MySQL 占用 3306，映射 3307 互不打架
  29
    · 项目/客户端连它写：jdbc:mysql://192.168.100.128:3307
  30
      （宿主机 IP + 宿主机端口，不是 3306、也不是容器的 IP）
  31
  
  32
  四、验证
  33
    docker ps                      → 状态 Up，PORTS 显示 0.0.0.0:3307->3306/tcp
  34
    docker logs mysql              → 看 MySQL 启动日志（[111 篇]）
  35
    别的机器用客户端连 192.168.100.128:3307（root / 123）→ 能连上就成
  36
  
  37
  五、拉不到镜像怎么办（本机实测的坑）
  38
    报错：
  39
      docker: Error response from daemon: failed to resolve reference
  40
      "docker.io/library/mysql:8": failed to authorize: … EOF
  41
    原因：没配镜像加速（docker info 里 Registry Mirrors 为空），连不上 Docker Hub。
  42
    办法①：在 Docker 设置里加 Registry Mirror，命令原样可用；
  43
    办法②：把镜像名换成带国内源前缀的写法（如 docker.m.daocloud.io/library/mysql:8）。
  44
  
  45
  六、手工装 vs Docker 装
  46
    ┌────────┬──────────────────────────┬───────────────────────┐
  47
    │ 环节   │ 手工装（108 篇）          │ Docker                │
  48
    ├────────┼──────────────────────────┼───────────────────────┤
  49
    │ 找包   │ 官网翻版本、选平台、上传   │ 从镜像仓库自动拉       │
  50
    │ 安装   │ 十几条命令                │ 一条 docker run        │
  51
    │ 启停   │ systemctl start/stop      │ docker start/stop      │
  52
    │ 卸载   │ rpm -e + 删目录 + 清配置   │ docker rm              │
  53
    │ 换版本 │ 整套重来                  │ 换 tag 再来一条        │
  54
    └────────┴──────────────────────────┴───────────────────────┘

  显示更多显示更少

  检查点：① 三条痛点写全；② 命令里五个参数一个不少、端口方向对；③ 连接串写的是宿主机 IP + 3307；④ 验证方式给了两条；⑤ 报错原文和两条办法都在。