Docker 教程：从入门到掌握容器、镜像与 Compose

用通俗易懂的方式介绍 Docker 是什么、它解决的问题，以及镜像、容器、Registry 三个核心概念、Docker 的架构和容器与虚拟机的区别。

一步步在 Windows（WSL 2）、macOS 和 Linux（Ubuntu 26.04 / 24.04）上安装 Docker，检查虚拟化和 WSL 设置，并用 docker version 与 hello-world 验证安装。

Docker Desktop 图形界面逐页介绍：侧边栏、Containers 列表和操作按钮、容器详情页的 Logs／Inspect／Exec／Files／Stats 选项卡、Compose 项目、Images、搜索和下载镜像、底部状态栏，以及每项操作对应的 docker 命令，方便你在图形界面与终端之间切换。

用 nginx 运行第一个 Docker 容器：通过 docker run 下载镜像并启动容器，用浏览器打开网页，用 docker ps 查看容器、用 logs 查看日志、用 exec 进入容器，并通过 stop / start / rm 管理容器；还会演示如何在 Docker Desktop 中用图形界面完成相同操作。

了解 Docker 镜像的命名规则（registry、repository、tag、digest），通过实际输出学习 docker pull、images、tag、rmi、history、inspect、save / load，比较 slim、alpine 版本的大小，并了解 Docker 29 新的 docker images 输出格式与镜像分层。

通过实际输出了解 Docker 容器的状态（created、running、paused、exited）、容器为何启动后立即退出、stop 与 kill 的区别、docker stop 为何要等 10 秒、退出代码的含义，以及 --restart 重启策略的实际行为。

docker run 常用参数一次整理：-d、-it、-p、-v、-e、--name、--rm、--network、--restart、--memory、--cpus、--user、--entrypoint、--read-only，每个参数都附上实际运行的命令与输出。

容器出问题时该怎么排查？通过实际输出学习用 docker logs 查看日志、用 docker exec 进入容器、用 docker inspect 查看配置、用 docker cp 复制文件，以及使用 docker stats、top、diff 查看状态，并排查容器启动即退出、端口占用、exec format error 等常见问题。

通过一个 Node.js 示例学习编写 Dockerfile，并从实际的 docker build 输出理解 FROM、WORKDIR、COPY、RUN、CMD 各步骤的作用、构建缓存（CACHED）的运行方式，以及 .dockerignore 如何将构建内容从 30 MB 降至不到 1 KB。

用 docker init 回答几个问题，就能自动生成 Dockerfile、compose.yaml、.dockerignore 和 README.Docker.md。实测 Node.js 项目的完整交互过程，逐行解读生成的文件，用 docker build --check 找出模板中的两个警告，以及模板中 PostgreSQL 示例在 postgres:18 上会出错的地方。

Dockerfile 常用指令的说明与实际运行结果：FROM、RUN、COPY、ADD、WORKDIR、ENV、ARG、EXPOSE、USER、VOLUME、HEALTHCHECK、CMD、ENTRYPOINT，并用小实验比较 CMD 与 ENTRYPOINT、COPY 与 ADD、ARG 与 ENV，以及 PID 1 与 docker stop 要等 10 秒的关系。

通过实际 docker build 输出了解构建缓存的工作方式和失效规则，学习优化指令顺序、清理临时文件、使用 .dockerignore、精简基础镜像、挂载缓存及清理构建缓存。

使用多阶段构建分离编译环境和运行环境：实测同一个 Go 程序，单阶段镜像为 1.43 GB，多阶段（distroless）仅 20.2 MB。附 Node.js 前端、后端、Java 多阶段 Dockerfile 示例，以及使用 --target 仅构建指定阶段的方法。

学会使用 docker login、docker tag、docker push，将镜像上传到 Docker Hub、GitHub Container Registry（ghcr.io），并通过 registry:3 自建私有 Registry，实际演示推送与下载，附未登录时推送失败的真实错误信息和版本标签命名建议。

容器删除后数据就不见了？通过实际操作学习 Docker Volume 与 Bind Mount：删除容器后数据仍然保留、匿名 Volume 的来源、-v 与 --mount 遇到不存在路径时的差异，以及 Volume 的备份与恢复。

通过实际输出了解 Docker 网络：默认 bridge 为什么不能用名称连接、自定义网络的内置 DNS、应用连接数据库、多网络与网络别名、仅监听 127.0.0.1 时无法访问的原因，以及容器如何连接主机。

用实际输出学习 -e、--env-file、Dockerfile 的 ENV，以及 Docker Compose 的 environment、env_file 和 .env 变量替换；实测引号处理差异、${VAR:?} 错误信息，以及如何用 secrets 安全传递密码。

Docker Compose 入门：用一个 compose.yaml 同时启动网站、PostgreSQL 与 Adminer，附 docker compose up、ps、logs、stop、down 的实际输出，以及 Adminer 登录（记得选择 PostgreSQL）、执行 SQL、down 与 down -v 对数据的影响等完整截图。

Docker Compose 配置文件 compose.yaml 的完整语法：services、image、build、ports、volumes、environment、env_file、depends_on 与 healthcheck、restart、networks、profiles、compose.override.yaml 合并，以及使用 docker compose config 检查最终配置。

Docker Compose 常用命令及实际输出：up、down、ps、ls、images、top、logs、exec、run、pull、config、port，并实测修改 compose.yaml 后 restart 不会应用新设置，必须使用 up -d 重建，涵盖日常开发与部署场景。

一步步用 Docker Compose 搭建 WordPress 7 + MySQL 8.4，包含实际运行输出和安装界面截图：健康检查、数据持久化、上传大小限制、phpMyAdmin、备份与恢复，以及更新镜像的方法。

把 Python 网站打包成 Docker 镜像，附实际构建与运行输出：Flask + gunicorn、开发模式热重新加载、FastAPI + uvicorn、Django 的 collectstatic 与 STATIC_ROOT 错误、用 uv 搭配 uv.lock 构建，以及镜像大小比较。

Node.js 项目的 Dockerfile 写法与实测：npm ci、只装生产环境包、以 node 用户运行、docker stop 为什么要等 10 秒（PID 1 与 SIGTERM 实测）、TypeScript 多阶段构建、Next.js standalone 从 968MB 降到 295MB，以及开发时热重新加载与 compose watch。

使用 Docker 和 Nginx 搭建静态网站，配置 SPA、缓存和 gzip，检查语法并使用模板和环境变量，还可代理到后端容器。涵盖 proxy_pass 斜杠、文件挂载、502 和 Caddy 自动 HTTPS。

用 Docker 启动 MySQL 8.4 并附实际输出：环境变量、初始化 SQL、中文 utf8mb4、从容器内／主机／其他容器连接、localhost 与 127.0.0.1 的差别、Compose 健康检查的陷阱、mysqldump 备份还原，以及「改了密码变量却没生效」的原因。

使用 Docker 启动 PostgreSQL 18，了解新版数据目录、Compose 配置、pg_isready 健康检查陷阱、psql 常用命令、备份还原，以及从 16 升级到 18。

使用 Docker 启动 Redis 8，学习 redis-cli 基本操作、配置密码、RDB 与 AOF 持久化、内存淘汰策略，以及通过 Compose 搭配 Flask 和配置健康检查。

Docker 占用太多磁盘空间？用 docker system df 找出占用来源，再安全清理容器、镜像、Volume 和构建缓存。了解 Docker 29 的行为变化与日志上限设置。

Docker 容器安全入门与实测：以非 root 用户运行、固定镜像版本、了解 ARG／ENV／COPY 中的机密如何留在镜像层中、使用 BuildKit secret、限制端口与权限、扫描漏洞并修复。

为什么 Docker 相当于拥有 root 权限？实测 Rootless 模式如何将容器内的 root 映射为主机普通用户、无法读取主机的 /etc/shadow，并介绍无需常驻进程的 Podman：命令几乎与 Docker 相同、可直接构建 Dockerfile、默认采用 rootless，以及两者的差异和选择方法。

了解 CPU 架构与多平台镜像，使用 docker buildx 和 Go 交叉编译一次构建 linux/amd64 与 linux/arm64，检查 manifest，并了解何时需要 QEMU。

推送代码或创建版本 tag 后，自动构建多平台 Docker 镜像并推送到 GitHub Container Registry（ghcr.io），再通过 SSH 自动部署到服务器。包含完整 workflow 文件、逐段说明、metadata-action 生成 tag 的规则、构建缓存、Docker Hub 的配置方式，以及使用 actionlint 验证 workflow。

从零开始将 Docker 应用部署到 Linux 云服务器，涵盖构建并推送镜像到 Registry、服务器使用 Compose 拉取并运行 Caddy（HTTPS）＋ Node.js ＋ PostgreSQL 18、版本更新与回滚、自动备份脚本，以及上线前检查清单。

容器到底是什么？从 Docker 主机实际观察：容器只是一个由 namespace 隔离、由 cgroup 限制资源、以 overlayfs 作为文件系统的 Linux 进程。实测容器内外的 PID、用 lsns 查看 namespace、从 cgroup 读出 --memory 与 --cpus 的设置值、在 upperdir 找到容器写入的文件，以及 capabilities 与 seccomp。

把 Docker 的错误消息粘贴来找答案：Cannot connect to the Docker daemon、permission denied docker.sock、port is already allocated、container name is already in use、exec format error、no such file or directory（CRLF）、executable file not found in $PATH、volume is in use、dependency failed to start、No space left on device、PowerShell 的 '<' operator is reserved 等 25 种错误，每个都附 Docker 29 实测输出、原因与解法。

最常用的 Docker 命令一页整理：容器、镜像、构建、Volume、网络、Docker Compose、清理与系统信息，每条命令附简短说明，适合收藏以便随时查阅。

Docker build 完整参数说明（-t、-f、--build-arg、--target、--no-cache、--pull、--platform、--progress、--secret、--check、-q 等），附 Docker 29 实际运行示例：命名镜像、传入构建参数、指定 Dockerfile、仅构建到某个阶段、显示完整构建输出。

完整介绍 docker exec 参数（-it、-u、-w、-e、-d、--env-file、--privileged），并通过 Docker 29 示例讲解进入容器 Shell、指定用户和工作目录、传递环境变量、后台运行，以及容器停止时的报错。

docker ps 参数完整说明（-a、-q、-f/--filter、--format、-s、-n、-l、--no-trunc），附 Docker 29 实际运行示例：列出所有容器、仅显示 ID、按状态／名称／标签筛选、自定义输出字段、显示容器大小，以及一次删除所有已停止的容器。

docker logs 完整参数说明（-f、-n/--tail、-t、--since、--until、--details），附 Docker 29 实际运行示例：查看最后几行、添加时间、查看最近几秒、只看 stdout 或 stderr、搭配 grep 搜索，以及持续跟踪新日志。

docker cp 参数与用法：从容器复制文件或文件夹到主机、从主机复制到容器、复制整个文件夹的规则、文件不存在时的错误，以及用 docker cp 在 Windows 上备份和还原数据库。附 Docker 29 实际运行示例。

了解 docker inspect 参数和 -f/--format 模板写法，附 Docker 29 实际运行示例：查询容器状态、IP 地址、环境变量、重启策略、镜像的 CMD 与 ENTRYPOINT、架构和大小、Volume 的实际路径、网络子网，以及 Docker 29 移除 .NetworkSettings.IPAddress 的变更。

全面介绍 docker volume 的 create、ls、inspect、rm、prune 子命令，并提供 Docker 29 实测示例：创建 Volume 并写入数据、查找悬空匿名 Volume、添加标签并按标签筛选，以及 prune 与 prune -a 的区别。

完整说明 docker network 的 create、ls、inspect、connect、disconnect、rm、prune 子命令及其参数，并附 Docker 29 实际运行示例：自定义网络的名称解析、--network-alias 别名、指定子网、一个容器加入多个网络，以及删除使用中网络时的错误。

完整介绍 docker compose up 的参数（-d、--build、--wait、--force-recreate、--no-deps、--scale、--remove-orphans、--abort-on-container-exit、--exit-code-from、--pull、-V、--watch 等），并提供 Docker Compose v5 实际运行示例。

了解 docker compose down 的参数（-v/--volumes、--rmi local|all、--remove-orphans、-t/--timeout），并通过示例了解默认保留 Volume、down -v 删除数据，以及 down、stop、rm 的区别。