香港服务器上单机Docker如何部署并验证容器重启与数据持久化

发布人:A5数据发布时间:2026-10-26 10:49阅读量:84

在香港服务器上使用单机 Docker 部署,验收重点不只是容器能否启动,还要确认 Docker 服务重启后容器能自动恢复,以及容器被重建后业务数据仍然存在。对于首次上线,建议使用 Docker Compose 管理服务,并将需要保留的数据放入命名卷,而不是只写入容器可写层。

下面以 Ubuntu 22.04/24.04、amd64 架构和 Nginx 示例容器为例。示例监听本机 127.0.0.1:8080,通过一个持久化文件验证数据保存效果;如果服务器已有反向代理,可将反向代理转发到该端口。如果需要直接从外部访问,再按需调整端口绑定和安全组规则。

一、准备条件

1. 环境与资源要求

本次部署使用的对象和验证方式如下:

项目要求或用途
服务器系统Ubuntu 22.04 或 Ubuntu 24.04,amd64 架构
管理权限可通过 SSH 登录,并具备 sudo 权限
网络条件能访问 Docker 镜像仓库的 HTTPS 服务,通常需要出站 TCP 443
端口示例使用本机 127.0.0.1:8080,不直接暴露到公网
数据目录使用 Docker 命名卷 a5idc_web_data
容器管理使用 Docker Compose Plugin
磁盘空间示例服务建议预留至少 2 GB 可用空间;实际应用应按镜像、日志和业务数据重新评估

香港服务器所在地区不会改变 Docker 的部署命令,但需要额外确认服务商控制台中的安全组、网络 ACL 或入站策略。若后续将服务直接发布到公网,应只开放实际需要的端口,并限制管理端口来源地址。

对于文中的单机 Docker 部署场景,A5数据提供香港物理服务器,涵盖入门建站、Xeon Gold 和 AMD EPYC 等配置,并提供 SSD 或 NVMe 存储及不同带宽线路选择。这些计算、内存、磁盘和网络资源可用于承载 Nginx、业务接口等容器化服务,也为 Compose 服务运行和数据卷持久化提供硬件基础。

2. 检查系统和网络

先确认系统版本、架构、磁盘和内存,避免在不兼容的系统上直接安装。

cat /etc/os-release
uname -m
df -h /
free -h

预期能够看到 Ubuntu 系统信息,uname -m 通常为 x86_64。如果系统不是 Ubuntu,或者发行版代号为空,不要直接套用下面的 Ubuntu 软件源命令,应先根据实际发行版选择对应安装方式。

检查出站 HTTPS 是否可用:

curl -I --connect-timeout 10 https://download.docker.com

返回 HTTP 响应或至少完成 TLS 连接,通常说明基础网络可用。如果超时,应先检查服务器 DNS、出站规则和服务商安全策略。不要在网络未恢复时反复删除容器或卷,这些操作不能解决镜像拉取失败。

二、安装并验证 Docker

如果系统已经安装 Docker,可先执行版本检查;只有命令不存在时才进行安装。

docker --version
docker compose version

如果没有 Docker,使用 Docker 软件源安装 Engine、Compose Plugin 和常用构建组件:

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  | sudo gpg --dearmor --yes -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

. /etc/os-release
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu ${VERSION_CODENAME} stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install -y \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin

启动 Docker,并设置为系统启动时自动运行:

sudo systemctl enable --now docker

sudo systemctl is-active docker
sudo systemctl is-enabled docker
sudo docker version
sudo docker compose version

预期结果分别为 active、enabled,并能看到 Docker Engine 和 Compose Plugin 的版本信息。

如果安装过程中提示无法定位软件包,重点检查 /etc/os-release 中的 VERSION_CODENAME 是否为受支持的 Ubuntu 代号。不要随意把代号改成其他版本,否则可能造成软件包依赖不一致。

3. 端口和防火墙边界

示例 Compose 文件默认只绑定本机地址,因此不需要为 8080 开放公网入站规则。若要从其他设备直接访问,需要同时完成以下两项:

  • 将 Compose 中的端口改为 "8080:80";
  • 在服务商安全组和服务器防火墙中允许指定来源访问 TCP 8080。

调整防火墙属于有影响的操作。若服务器启用了 UFW,建议只允许管理端 IP,而不是对所有地址开放:

sudo ufw status
sudo ufw allow from 203.0.113.10 to any port 8080 proto tcp

上面的 203.0.113.10 仅为示例地址,应替换为实际管理端公网 IP。回滚规则时执行:

sudo ufw delete allow from 203.0.113.10 to any port 8080 proto tcp

如果服务器没有启用 UFW,不要为了本次验证强行启用防火墙。直接对公网提供服务时,还应在服务商控制台同步配置入站规则。

三、创建单机 Docker Compose 服务

1. 创建部署目录

sudo mkdir -p /opt/a5idc-demo/backup
sudo chmod 0755 /opt/a5idc-demo
cd /opt/a5idc-demo

这里使用 /opt/a5idc-demo 作为示例目录。生产环境可以替换为实际项目目录,但建议统一保存 Compose 文件、备份文件和变更记录,避免多个项目混用。

2. 编写 Compose 配置

创建 compose.yaml:

sudo tee /opt/a5idc-demo/compose.yaml > /dev/null <<'EOF'
services:
  web:
    image: nginx:1.27-alpine
    container_name: a5idc-web
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - web_/usr/share/nginx/html
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  web_
    name: a5idc_web_data
EOF

配置中有四个关键点:

单台香港服务器的示意边界内,Docker Compose 管理 Nginx 容器;本机回环地址 127.0.0.1:8080 指向容器 80 端口;容器内 /u

  • restart: unless-stopped:容器异常退出或 Docker 服务恢复后,Docker 会尝试重新启动容器;如果管理员明确执行停止操作,则不会自动拉起。
  • web_/usr/share/nginx/html:将 Nginx 网站目录映射到命名卷,文件不会只存在于容器可写层。
  • 127.0.0.1:8080:80:只允许服务器本机访问,适合先完成部署验证。
  • json-file 日志轮转:单个日志文件限制为 10 MB,最多保留 3 个文件,降低日志长期占满系统盘的风险。

如果需要直接从公网访问,将端口部分改为:

    ports:
      - "8080:80"

这会监听服务器所有 IPv4 地址。修改前应确认安全组和防火墙已经限制访问来源。

3. 检查配置并启动容器

先让 Compose 校验配置语法:

cd /opt/a5idc-demo
sudo docker compose config --quiet

没有输出通常表示 YAML 配置可以被解析。如果这里出现缩进、字段或格式错误,应先修正配置,不要继续启动。

拉取镜像并启动:

sudo docker compose pull
sudo docker compose up -d

检查服务状态:

sudo docker compose ps
sudo docker ps --filter name=a5idc-web

预期状态为 Up 或 running,端口信息应类似:

NAME         IMAGE               SERVICE   STATUS          PORTS
a5idc-web    nginx:1.27-alpine   web       Up              127.0.0.1:8080->80/tcp

上面的输出是示例格式,用于说明检查重点,不代表已经在某台服务器上实际执行。

四、逐步验证容器和持久化数据

1. 验证初始 HTTP 服务

在服务器本机执行:

curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:8080/

预期输出:

HTTP 200

如果返回 200,说明端口映射、容器进程和 Nginx 基础服务均已工作。若返回连接失败,先检查容器状态和端口监听,不要立即重建数据卷。

也可以查看端口监听情况:

sudo ss -lntp | grep ':8080'

由于配置绑定在 127.0.0.1,预期只看到本机回环地址监听。

2. 写入一个持久化验证文件

通过容器内部 Shell 写入固定标识。这个文件用于后续重启和重建验证:

cd /opt/a5idc-demo

sudo docker compose exec -T web sh -c \
  'printf "persist-token=a5idc-demo\ncreated_at=%s\n" "$(date -u +%FT%TZ)" > /usr/share/nginx/html/persist.txt'

从 HTTP 入口读取文件:

curl -fsS http://127.0.0.1:8080/persist.txt

预期能看到类似内容:

persist-token=a5idc-demo
created_at=2025-01-01T12:00:00Z

时间仅为示例。关键是 persist-token 内容存在,并且文件是通过映射到命名卷的目录写入的。

同时检查容器挂载关系:

sudo docker inspect -f \
  '{{range .Mounts}}{{println .Type .Name .Source "->" .Destination}}{{end}}' \
  a5idc-web

预期能看到类似结果:

volume a5idc_web_data /var/lib/docker/volumes/a5idc_web_data/_data -> /usr/share/nginx/html

不要把 /var/lib/docker/volumes 下的目录当作应用接口直接读写。应用应通过容器内的挂载路径访问数据,宿主机路径主要用于运维检查和备份。

3. 验证人工重启后数据仍在

先记录文件内容,再执行 Compose 重启:

before="$(curl -fsS http://127.0.0.1:8080/persist.txt)"
printf '%s\n' "$before"

sudo docker compose restart web
sleep 3

after="$(curl -fsS http://127.0.0.1:8080/persist.txt)"
printf '%s\n' "$after"

前后两次输出中的 persist-token 和 created_at 应保持一致。这个步骤验证的是容器进程重启后,挂载卷中的文件没有丢失。

再查看容器状态和重启计数:

sudo docker inspect -f \
  'status={{.State.Status}} restart_count={{.RestartCount}}' \
  a5idc-web

预期状态为:

status=running restart_count=0

人工执行 docker compose restart 不一定会增加 RestartCount,这并不代表重启失败。它主要用于验证服务重启后的可用性。

4. 验证异常退出后的自动恢复

要验证 restart: unless-stopped 是否生效,需要模拟容器主进程异常退出。下面的 docker kill 会立即终止示例容器,只适合在测试服务或维护窗口执行。

cid_before="$(sudo docker inspect -f '{{.Id}}' a5idc-web)"

sudo docker kill a5idc-web
sleep 5

sudo docker inspect -f \
  'status={{.State.Status}} restart_count={{.RestartCount}}' \
  a5idc-web

cid_after="$(sudo docker inspect -f '{{.Id}}' a5idc-web)"

if [ "$cid_before" = "$cid_after" ]; then
  echo "container identity retained"
else
  echo "container identity changed"
fi

curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:8080/
curl -fsS http://127.0.0.1:8080/persist.txt

预期结果:

  • 容器状态恢复为 running;
  • restart_count 大于或等于 1;
  • HTTP 返回 200;
  • persist-token 仍然存在。

docker kill 验证的是容器进程退出后的自动恢复,不等同于断电、宿主机宕机或内核故障测试。不要为了验证重启策略而直接重启生产服务器。

5. 验证容器重建后数据仍在

容器重启不会改变容器本身,进一步执行一次容器重建,才能验证数据是否真正脱离容器生命周期。

cd /opt/a5idc-demo

sudo docker compose down
sudo docker compose up -d
sleep 3

sudo docker compose ps
curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:8080/
curl -fsS http://127.0.0.1:8080/persist.txt

预期仍然返回 HTTP 200,并且能够读取之前写入的 persist-token。

这里执行的是 docker compose down,没有使用 -v,因此命名卷仍然保留。下面这个命令会删除 Compose 管理的卷,不能用于普通重启或常规下线:

sudo docker compose down -v

如果执行了 down -v,a5idc_web_data 中的验证文件会被删除,后续启动得到的是一个新的空卷或由镜像初始化的目录。

四、逐步验证容器和持久化数据/验证容器重建后数据仍在配图

五、日志、资源和常见异常处理

1. 容器启动失败或反复重启

先查看最近日志和容器状态:

cd /opt/a5idc-demo

sudo docker compose ps
sudo docker compose logs --tail=100 web
sudo docker inspect -f \
  'status={{.State.Status}} exit={{.State.ExitCode}} error={{.State.Error}} restart={{.RestartCount}}' \
  a5idc-web

不同结果的处理方向如下:

  • status=running 且 HTTP 返回 200:容器已经恢复,应继续检查业务文件和日志内容。
  • status=restarting:通常是主进程启动失败、配置错误或依赖服务不可用,先查看日志,不要删除数据卷。
  • status=exited:检查退出码和最后一段日志,确认是主动停止、配置错误还是资源不足。
  • No such container:可能是 Compose 项目目录不对,或容器名称与当前文件不一致,应在 /opt/a5idc-demo 下重新执行 sudo docker compose ps。

2. 8080 端口被占用

如果 docker compose up -d 提示端口已被占用,检查监听进程:

sudo ss -lntp | grep ':8080'

不要直接停止未知进程。可以选择:

  • 使用已有反向代理,继续保持 127.0.0.1:8080,解决代理配置;
  • 将 Compose 端口改为未占用的端口,例如 127.0.0.1:18080:80;
  • 如果确实需要替换现有服务,先确认其配置、连接方和回滚方式,再安排维护窗口。

修改端口后重新校验:

cd /opt/a5idc-demo
sudo docker compose config --quiet
sudo docker compose up -d
curl -fsS -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:18080/

3. 镜像拉取超时

检查 Docker 服务和外部网络:

sudo systemctl is-active docker
curl -I --connect-timeout 10 https://registry-1.docker.io/v2/
sudo docker compose pull

如果服务器可以访问普通网站,但无法访问镜像仓库,应检查出站 TCP 443、DNS 和服务商网络策略。不要把拉取失败误判为卷损坏,也不要通过删除 /var/lib/docker 来处理网络问题。

4. 重启后数据为空

按以下顺序检查:

cd /opt/a5idc-demo

sudo docker inspect -f \
  '{{range .Mounts}}{{println .Type .Name .Destination}}{{end}}' \
  a5idc-web

sudo docker volume inspect a5idc_web_data
sudo docker compose config

重点确认:

  • 应用写入的路径是否正是 /usr/share/nginx/html;
  • Compose 文件中是否仍然使用 a5idc_web_data;
  • 是否误执行过 docker compose down -v 或 docker volume rm;
  • 容器是否实际使用了另一份 Compose 文件;
  • 宿主机磁盘是否已经满。

查看磁盘和 Docker 占用:

df -h /
sudo docker system df

不要在未确认影响范围的情况下执行 docker system prune。该命令可能删除未使用的镜像、网络或容器,不能作为数据恢复手段。

5. 日志持续增长

本示例已经配置了 json-file 日志轮转,可以查看容器日志:

cd /opt/a5idc-demo
sudo docker compose logs --tail=50 web

日志轮转只限制 Docker 日志文件,不会限制命名卷中的业务数据。上线前还需要分别关注:

  • / 分区剩余空间;
  • Docker 镜像和容器占用;
  • 命名卷数据大小;
  • 应用自身是否将大量内容写入标准输出。

如果业务是数据库或队列,不能只依赖 Docker 命名卷。还应根据应用特性设计停写备份、恢复演练和一致性校验。

六、备份与回滚

1. 备份命名卷

示例中的 Nginx 文件可以直接打包备份。执行备份前,生产应用应先确认是否需要暂停写入;对于数据库,应使用数据库自身的逻辑备份或一致性快照方式。

sudo mkdir -p /opt/a5idc-demo/backup

stamp="$(date -u +%Y%m%dT%H%M%SZ)"

sudo docker run --rm \
  -v a5idc_web_/from:ro \
  -v /opt/a5idc-demo/backup:/to \
  alpine:3.20 \
  sh -c "tar czf /to/web_data_${stamp}.tgz -C /from ."

ls -lh /opt/a5idc-demo/backup

预期能看到一个以时间命名的压缩包。备份文件应复制到独立存储位置,不能只保存在与 Docker 数据相同的系统盘上。

2. 配置回滚

如果新版本 Compose 配置启动异常,优先回退配置文件,不要删除数据卷:

cd /opt/a5idc-demo

sudo cp compose.yaml compose.yaml.failed
sudo cp compose.yaml.previous compose.yaml

sudo docker compose config --quiet
sudo docker compose down
sudo docker compose up -d

如果没有提前保存 compose.yaml.previous,可以使用部署前的备份文件恢复。配置回滚的影响范围是容器和网络,命名卷不会因普通 down 被删除。

3. 数据卷恢复

只有确认当前卷中的数据损坏,并且已经准备好可用备份时,才执行删除卷的恢复操作。下面的 docker volume rm 是破坏性命令,会删除当前卷,执行前必须确认服务已经停止、卷名称准确且备份可读。

cd /opt/a5idc-demo

backup_file="/opt/a5idc-demo/backup/web_data_20250101T120000Z.tgz"

sudo docker compose down
sudo docker volume inspect a5idc_web_data
sudo docker volume rm a5idc_web_data
sudo docker volume create a5idc_web_data

sudo docker run --rm \
  -v a5idc_web_/to \
  -v /opt/a5idc-demo/backup:/from:ro \
  alpine:3.20 \
  sh -c "tar xzf /from/$(basename "$backup_file") -C /to"

sudo docker compose up -d
curl -fsS http://127.0.0.1:8080/persist.txt

如果恢复后的文件能够读取,说明数据卷恢复完成。对于真实业务,还应进一步检查文件权限、应用版本兼容性和数据完整性,不能只以 HTTP 200 作为唯一判断依据。

七、验收与回滚检查项

部署完成后,建议保留以下验收记录:

  • [ ] systemctl is-active docker 返回 active。
  • [ ] docker compose config --quiet 无错误。
  • [ ] docker compose ps 显示服务处于运行状态。
  • [ ] 本机访问服务返回 HTTP 200。
  • [ ] docker inspect 能看到命名卷挂载到实际数据目录。
  • [ ] 手工重启容器后,持久化文件内容不变。
  • [ ] 使用 docker kill 模拟异常退出后,容器能够自动恢复。
  • [ ] 执行 docker compose down 后重新启动,持久化文件仍然存在。
  • [ ] 没有使用 docker compose down -v 清理生产数据卷。
  • [ ] 已检查系统盘、Docker 占用和日志轮转配置。
  • [ ] 已生成至少一份可读取的卷备份,并记录备份文件位置。
  • [ ] 回滚时优先恢复 Compose 配置,不直接删除数据卷。
  • [ ] 只有在备份确认可用、服务已停止且卷名称核对无误时,才执行卷删除和恢复操作。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5789.html

相关推荐