Docker Desktop 使用指南

Docker Desktop 是在 Mac・Windows・Linux 电脑上使用 Docker 的「一站式」应用，由 Docker 公司开发。安装之后，从运行容器的引擎、命令行到图形界面（仪表盘）一应俱全。

「容器」是把应用和它运行所需的东西（操作系统组件、库、配置）打包在一起的箱子。因为是整箱运行，在谁的电脑上、在服务器上都能同样运行。容器本身的概念，在开发指南的Docker 入门与实战里有详细介绍。本文讲的是在自己电脑上使用 Docker 的应用。

• Docker Engine ── 实际运行容器的核心，与服务器 Linux 上用的是同一个
• 一整套命令 ── docker、一次运行多个容器的 docker compose、构建镜像的 docker buildx、Kubernetes 用的 kubectl 等
• 仪表盘 ── 本文介绍的界面：容器・镜像・数据卷的列表与操作、查看日志、设置
• 其他 ── 单机即可试用的 Kubernetes、检查漏洞的 Docker Scout、扩展、AI 助手 Gordon、运行 AI 模型的 Model Runner 等

它的前身是 2016 年推出的「Docker for Mac」和「Docker for Windows」。在那之前，要在 Mac 或 Windows 上用 Docker，得自己准备虚拟机。让它装上就能用是这款应用的起点，后来统一改名为 Docker Desktop，并增加了 Linux 版。

容器本来依靠 Linux 内核（操作系统核心）的功能运行。Mac 和 Windows 的内核没有这种机制，所以 Docker Desktop 在后台运行一个小型 Linux 虚拟机，在里面运行 Docker Engine 和容器。

了解这个原理，下面这些现象就都说得通了。

• 占用内存和磁盘 ── 因为后台跑着一整台 Linux。上限可在设置中决定（第九章）
• 读写电脑上的文件夹有时较慢 ── 因为文件要在电脑和虚拟机之间传递（第十三章）
• 无法直接访问容器的 IP 地址 ── 因为容器在虚拟机内部的网络里。要从外部访问，需要「发布端口」（第三章）
• 在 Apple 芯片的 Mac 上，Intel 镜像较慢 ── 虚拟机里是 ARM 版 Linux，Intel（amd64）镜像要靠模拟运行

进入界面操作之前，先掌握 Docker 的几个基本概念。理解了这些，界面上什么在哪里也就自然明白了。

其中最重要的是「容器是一次性的」这个意识。写进容器内部的数据，会在删除容器时一起消失。要保留的数据，就放进数据卷或绑定挂载。这个区别在第八章还会再看。

Docker Desktop 从官网（docker.com）下载。Mac 版分 Apple 芯片和 Intel 两种安装包。

需要注意的是费用。Docker Desktop 并不是谁都能免费使用。

登录并非必需。本文的界面也是在未登录的 Personal 状态（左上角显示「PERSONAL」）下截取的。登录后，从 Docker Hub 拉取镜像的次数限制会放宽一些。

启动后会打开如下界面（仪表盘）。随时也可以从菜单栏的鲸鱼图标打开。

先来运行 Web 服务器 nginx。全程不输入一条命令。

按下 Run，镜像拉取完成后容器就会启动，并切换到容器详情界面（文首的图片）。在浏览器打开 http://localhost:8080，显示了「Welcome to nginx!」页面。这就确认了电脑的 8080 端口 → 容器的 80 端口已经连通。

运行起来的容器会出现在 Containers 界面。这台 Mac 上还有别的容器，所以用搜索栏按名称做了筛选。

容器有它的「生命周期」。按钮和命令的关系如下图。

点击容器名称会打开详情界面，这是 Docker Desktop 中最常用的界面。

拉取的镜像会出现在 Images 界面。一个镜像可能有几百 MB，积攒多了会挤占磁盘。不用的就在这里删除。

Docker Scout 的分析会生成镜像内软件包的清单（SBOM），再与已知漏洞比对。「有漏洞」并不等于「马上危险」，但标有「Fixable（已有修复版本）」的，大多换成新版本的镜像就能解决，定期看一看会更安心。

接下来是数据的存放位置。三种存放方式的区别如下图。

在界面上建好的数据卷，实际挂到容器上要通过命令（docker run -v）或 Compose 配置来完成。可以把界面理解为「列出、查看内容、不用了就删除」的地方。

点右上角的齿轮打开设置。首先要看的是 Resources（资源）。

Docker Engine 界面面向进阶用户。例如使用镜像加速（替代的拉取源）、给日志文件大小设上限等，都写在这里。修改前先把原内容记下来，万一无法启动也能马上恢复。

界面上能做的事，用命令都能做。先在界面上学会，熟练后再转向命令，就能把步骤留在文档或脚本里。把前面的操作写成命令如下。

# ① 拉取镜像（界面的 Pull）
docker pull nginx:stable-alpine

# ② 指定名称和端口后启动（界面的 Run）
docker run -d --name kiji-web -p 8080:80 nginx:stable-alpine

# ③ 容器列表（Containers 界面。加 -a 包括已停止的）
docker ps -a

# ④ 查看日志（Logs 标签。-f 持续跟踪）
docker logs -f kiji-web

# ⑤ 进入容器（Exec 标签）
docker exec -it kiji-web sh

# ⑥ 创建数据卷（Volumes 界面的 Create）
docker volume create kijidata

# ⑦ 清理（删除按钮）
docker rm -f kiji-web
docker volume rm kijidata
docker image rm nginx:stable-alpine

# ⑧ 查看磁盘用量・清理不用的资源
docker system df
docker system prune

组合多个容器时使用 Compose（写法见Docker 入门与实战第六章起）。用 docker compose up 启动后，Containers 界面会按项目名归在一起，可以一起停止或删除。

最近一两年，Docker Desktop 陆续加入了与 AI 有关的功能。按左侧菜单从上往下看。

这些都很新，测试版功能也多，界面和名称容易变化。让 Gordon 读取项目文件夹时，要意识到其中的内容会发送给 AI 服务，事先确认公司的代码能否这样使用。在本地运行 AI 模型的方法，也可以参考开发指南的在本地环境运行大模型。

能在本地运行容器的应用不只 Docker Desktop。它们都使用同样格式（OCI）的镜像，所以中途换用也不难。

另外，在 Windows 上也可以把 Linux 版 Docker Engine 直接装进 WSL 2。这样免费，但需要自己处理与 Windows 一侧的配合（文件共享、启动等）。

• 定期清理磁盘 ── 镜像、已停止的容器、不用的数据卷和构建缓存会越积越多。用 docker system df 看明细，用 docker system prune 清理（只有加 --volumes 时才会删除数据卷）
• 在 Apple 芯片的 Mac 上选 ARM 版镜像 ── 大多数官方镜像两种都有，会自动选择。只有 Intel 版时可用 --platform linux/amd64 运行，但较慢
• 源代码共享慢的时候 ── 把 node_modules 等大量小文件放进数据卷。也可以使用付费方案的 Synchronized file shares
• 从容器访问电脑上的服务 ── 用 host.docker.internal 而不是 localhost。容器里的 localhost 指的是容器自己
• 出现「port is already allocated」时 ── 该端口被别的应用或容器占用。换个端口（例 8081:80），或停掉占用的一方
• 无法启动・行为异常时 ── 先从右上角的「?」（Troubleshoot）选「Restart」。不行就收集诊断信息（也可用 docker desktop diagnose）
• 只装可信的扩展 ── 设置界面也警告「扩展以主机权限运行」。扩展能读写文件、操作 Docker Engine，安装前要确认来源
• 统一版本 ── 团队使用时统一 Docker Desktop 和 Compose 的版本，并把版本写进操作手册