Ubuntu 26.04 Docker Compose:持久数据、回环端口与容器重新创建

容器镜像提供应用的运行环境,但持久数据和发布端口仍需单独管理。本实验在新的 Ubuntu 26.04 专用虚拟机安装 Docker Engine 与 Compose,让仅从主机本机访问的 Nginx 应用在容器重新创建后继续使用同一份数据。

选择安装来源与权限方式

Docker Engine 负责运行容器,Compose 则用配置文件描述一组服务、端口和卷。已使用 Docker、containerd 或 Kubernetes 的服务器,应先清点容器、卷、仓库和软件包,另行规划迁移,不能直接删除包或混装。

以下只适用于没有既有 Docker 仓库的全新虚拟机。先检查 /etc/apt/sources.list.d/docker.sources 与 /etc/apt/keyrings/docker.asc,已有普通文件或符号链接时停止。Docker 官方 Ubuntu 安装指南列出了 Ubuntu 26.04 LTS 支持、硬件架构、冲突包与仓库步骤;衍生发行版不能只修改版本号后照搬。

docker 组成员和 Docker 套接字访问可获得很强的主机权限。本例明确使用 sudo,不给套接字设置 777,也不把所有用户加入 docker 组。运行不可信镜像是一项权限与信任决策,不能按普通文件处理。

通过官方仓库安装

将以下完整脚本保存为 ~/install-docker-lab.sh,以 bash ~/install-docker-lab.sh 执行。它检查 Ubuntu 26.04 和既有仓库路径,失败就停止;Signed-By 把签名密钥限定到对应仓库。包安装与仓库操作都在专用 Ubuntu 虚拟机上进行。

set -eu
. /etc/os-release
if [ "$ID" != ubuntu ] || [ "$VERSION_ID" != 26.04 ]; then
    printf "This lab requires Ubuntu 26.04.\n" >&2
    exit 1
fi
if [ -e /etc/apt/sources.list.d/docker.sources ] || [ -L /etc/apt/sources.list.d/docker.sources ] || [ -e /etc/apt/keyrings/docker.asc ] || [ -L /etc/apt/keyrings/docker.asc ]; then
    printf "Inspect the existing Docker repository first.\n" >&2
    exit 1
fi
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker version
sudo docker compose version
sudo docker run --rm hello-world

成功后分别确认 Docker 客户端与服务端版本、Compose 插件版本以及 hello-world 的成功消息。遇到 APT、签名或网络错误,先解决再继续。记录实际安装版本;移除仓库配置不等于卸载引擎,更不等于删除数据。部分步骤成功后不要盲目重新运行整个脚本,应先检查已保存的仓库和密钥。

Nginx 站点配置实验继续使用 8080,本容器应用选择主机 8081,容器内部仍为 80。若 8081 被占用,先用 ss 和 compose ps 查明归属,不强行终止其他服务;改端口时同步修改 Compose 与所有 curl 请求。

创建 Compose 配置与命名卷

创建全新的 ~/compose-lab 目录,并把下面内容保存为其中的 compose.yaml。已有同名项目时不覆盖,应先核对项目和数据。用 ss -lnt 检查主机的 8081 监听情况,包括可能占用该端口的通配地址监听。

services:
  web:
    image: nginx:stable-alpine
    ports:
      - "127.0.0.1:8081:80"
    volumes:
      - lab-html:/usr/share/nginx/html
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
volumes:
  lab-html:

端口字符串依次表示主机地址、主机端口、容器端口。显式的 127.0.0.1:8081:80 把发布地址限制到主机回环接口;省略地址可能发布到其他接口。它不会限制服务器上其他已经公开的服务。绑定行为与实际 Engine 版本仍需对照Docker 的端口发布文档并验证。

lab-html 是与容器可写层分离的命名卷,挂到容器的 /usr/share/nginx/html。新空卷默认可以从镜像中该目录的现有内容初始化;已有非空卷则会遮住镜像原内容。完整生命周期见Docker 卷文档。本例随后只向自己的练习卷写入 index.html。

nginx:stable-alpine 是可变标签;运营中需要记录并测试镜像摘要及更新流程,不把标签当作固定版本。json-file 的 10m、3 是本例的日志轮转选项,unless-stopped 是重启策略,均应根据实际负载和停机安排调整。字段含义见Compose 服务配置参考。

运行、重新创建并检查数据保留

(
set -eu
cd ~/compose-lab
sudo docker compose config
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail 30 web
)

在配置检查和镜像拉取成功后启动,检查 ps 状态与日志。up -d 返回并不保证应用已经可以响应;出现连接拒绝时,先看状态、日志和监听,再单独重试 curl,不为等待就绪而反复执行覆盖文件的步骤。

确认当前项目及命名卷是本次专用实验对象,没有需要保留的运营数据后,再运行下一块。两个 curl 都显式对本机请求禁用代理,以免当前代理环境影响回环访问;不修改系统代理设置。

(
set -eu
cd "$HOME/compose-lab"
sudo docker compose exec web sh -c 'printf "volume-lab\n" > /usr/share/nginx/html/index.html'
curl --noproxy '*' --fail http://127.0.0.1:8081/
sudo docker compose up -d --force-recreate
curl --noproxy '*' --fail http://127.0.0.1:8081/
sudo docker image inspect nginx:stable-alpine --format '{{json .RepoDigests}}'
)

重新创建前后都应得到 volume-lab。这里改变的是容器,保留的是同一项目挂载的卷,因此看到同一练习内容;这不证明备份成功或应用完整健康。image inspect 输出镜像的仓库摘要信息,用于记录实际拉取对象,不是应用测试结果。

启动、重新创建、停止的代码块都先切换到同一个 ~/compose-lab。括号中的工作目录变化不会留在父 shell;所有命令须使用同一份 compose.yaml 及同一项目身份。改目录、项目名或环境覆盖可能选择不同的项目和卷,不能因空页面就立即删除旧数据。

还要在主机用 ss 和 docker compose ps 核对实际绑定,并从其他设备测试:本例的回环发布端口不应通过主机外部地址被访问。Docker 的包过滤与防火墙说明指出,发布端口的流量可能在 UFW 常规规则之前被转发;不能单凭 UFW 已启用就认定容器端口受同样保护。

区分停止应用与删除数据

(
set -eu
cd "$HOME/compose-lab"
sudo docker compose down
sudo docker volume ls
)

默认 down 会停止并移除该项目容器和网络,命名卷会保留。docker volume ls 显示主机上的卷,可能包含其他项目;不要把所有列出的卷当作本实验对象。回到同一项目再次 up -d 后,可确认练习内容是否仍在。

down -v 可以删除项目声明的命名卷,卷清理命令也可能删除数据,不应把它们作为日常停止方式。具体选项见Compose down 官方参考。卷存在和数据可恢复是不同结果;备份时还要协调应用写入,把副本存到独立位置,并在那里测试恢复。