把一组容器写进一份文件

把参数搬进配置树

命令变成服务

Compose 是定义和管理多容器应用的工具。项目（project）是一组由它一起管理的资源；服务（service）是创建容器的配置，本例每个服务运行一个容器。[1]

左边逐条创建资源，右边描述同样的运行配置。为避免名称冲突，左边用 runlab 前缀，右边用项目名 cfile。先读对照；动手时只执行后面的实验。

docker network create runlab_default
docker volume create runlab_site

docker run -d --name runlab-web \
  --network runlab_default \
  --network-alias web \
  -p 127.0.0.1:8080:80 \
  -v runlab_site:/usr/share/nginx/html:ro \
  nginx:alpine

docker run -d --name runlab-client \
  --network runlab_default \
  --network-alias client \
  busybox:1.37 sleep 86400

name: cfile

services:
  web:
    image: nginx:alpine
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - site:/usr/share/nginx/html:ro
  client:
    image: busybox:1.37
    command: ["sleep", "86400"]

networks:
  default: {}

volumes:
  site: {}

YAML 用缩进表达层级：用空格，不用 Tab。web、client 缩进在 services 下；image 再缩进一层。- 开头表示列表项，端口字符串加引号。

Compose 会按项目生成容器名，无需照搬 --name。服务名写在 services 下即可。镜像标签引用自官方镜像页；标签可能更新，本例不承诺镜像大小或具体构建版本。[10]

名字和端口都带作用范围

同网用服务名

没有显式指定其他网络的服务，会加入项目的 默认网络（default network）。本例项目名为 cfile，网络名默认是 cfile_default，由 Compose 创建。[2]

域名系统（Domain Name System，DNS）在这里把服务名解析成容器地址。同一网络里的 client 可访问 http://web:80；你在宿主机访问 http://127.0.0.1:8080。即使移除 ports，这两个服务仍能走共同网络通信。

services:
  web:
    # image、ports、volumes 保持原样
    networks: [app]
  client:
    # image、command 保持原样
    networks: [app]
networks:
  app: {}

同名字段，两个层级

卷要声明和挂载

命名卷（named volume）是由 Docker 管理、独立于容器生命周期的数据存储。顶层 volumes.site 声明卷；services.web.volumes 把它挂载到容器目录。少了挂载，web 就用不到这个卷。[4]

默认情况下，项目名会作为卷名前缀：配置键 site 对应实际卷 cfile_site。docker compose down 删除容器和项目网络，默认保留命名卷；再次 up 会复用它。[4] [7]

只运行这一条实验路线

启动到清理

目标：写入一份网页，让两个入口都能读取；删除容器后，再验证卷中的文件仍在。需要 Linux 容器模式、可用的 Docker 与 Compose v2，以及拉取镜像的网络。命令在 Docker 所在的本机终端运行。

1. 保存并校验文件

新建空目录 compose-structure-lab 并进入。把前面的完整 YAML保存成 compose.yaml。后续命令都留在此目录，不运行左栏的 runlab 命令。

预期（未实测）：config -q 校验成功时无输出。它只校验配置，不启动服务。[9]

2. 启动、写入并检查

预期（未实测）：ps 列出 web、client 正在运行，web 发布本机 8080。两次 HTTP 请求的正文都应等于刚写入 index.html 的那一行文本。web 日志应能找到访问记录；具体格式、时间和容器名以实机为准，待维护者补录。

先由 up 创建 cfile_site，再用临时容器挂载并写入网页。--rm 删除临时容器，命名卷仍在；web 的只读挂载不妨碍临时容器通过自己的可写挂载更新文件。[11]

exec client … 在已运行的 client 容器内执行命令；BusyBox 提供此处使用的 wget。curl 在宿主机运行，没有它可直接用浏览器打开地址。up -d 返回不保证应用已经就绪；若首次请求过早失败，先查看 ps、logs web，再重试。依赖与健康检查留给下一页。

docker compose logs -f web 可持续跟随日志，按 Ctrl+C 只退出日志查看；后台服务继续运行。ps -a 还会列出已停止的容器。[8]

3. 删除容器，验证数据

预期（未实测）：down 后 ps -a 不再列出本例服务容器；临时容器仍能读出你写入的文本。重新启动后的 HTTP 正文保持相同。若请求过早，同样先检查状态再重试。

离开前再检索一次

四条带走

• services 把镜像和运行参数归到各自服务下。
• 顶层声明网络、卷；服务内连接网络、挂载卷。
• 同网访问用服务名和容器端口；宿主机用发布端口。
• up -d 启动，ps 查状态，logs 读日志，down 清理容器与网络。

来源

官方文档核对日期：2026-11-03。Docker 命令均未实测；未给出容器 ID、日志时间等虚构记录。

1. Docker Docs：Services — 服务结构、image、command、ports、hostname、挂载语法。
2. Docker Docs：Networking in Compose — 默认项目网络、服务名解析与容器端口。
3. Docker Docs：Networks — 隐式 default 与显式网络连接。
4. Docker Docs：Volumes — 顶层卷声明和服务挂载、复用现有卷。
5. Docker Docs：Version and name、Compose CLI — version 过时、项目名与覆盖优先级。
6. Docker Docs：docker compose up — 创建、重建和后台运行。
7. Docker Docs：docker compose down — 默认清理范围、-v；external 资源不被删除。
8. Docker Docs：ps、logs、exec — 状态、日志与容器内执行。
9. Docker Docs：config — 校验并展开配置；-q 只校验。
10. NGINX 官方镜像、BusyBox 官方镜像 — nginx:alpine 和 busybox:1.37 标签与用法。
11. Docker Docs：Engine volumes — 命名卷生命周期、只读挂载与临时容器。
12. Docker Docs：Packet filtering and firewalls — Linux bridge 网络和端口发布的防火墙规则。