香港服务器上单机Docker如何部署并验证容器重启与数据持久化
在香港服务器上使用单机 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
配置中有四个关键点:

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



