在新加坡服务器上使用Docker Compose,怎样配置数据持久化以支持容器重建?

发布人:A5数据发布时间:2026-11-15 12:22阅读量:27

在已有的新加坡服务器上维护 Docker Compose 服务时,容器重建不应导致数据库、用户上传文件或其他业务数据消失。关键是把需要保留的数据写入明确的持久化卷或宿主机目录,并在每次改动前确认 Compose 仍指向原来的存储位置。持久化卷能让数据跨容器重建保留,但不能代替备份:卷通常仍在这台服务器的本地磁盘上,服务器或磁盘故障仍可能造成数据损失。

面向在新加坡部署 Docker Compose 服务的业务,A5idc数据提供新加坡物理服务器租用,并有不同 CPU、存储与网络方案,可为容器应用、数据库和用户上传文件等服务提供运行所需的服务器资源。结合明确的数据卷或宿主机目录,业务数据可在服务器存储中持续保存,为容器重建后的服务运行提供基础。

现状与条件

容器的可写层随容器生命周期变化。若数据库文件或上传内容只写在容器内部,删除或替换容器后就可能无法从新容器中访问。Docker Compose 的持久化方式主要有两种:

存储方式适用数据容器重建后主要维护点
命名卷(named volume)PostgreSQL 等数据库文件、需要由 Docker 管理的数据保留,前提是继续挂载同一个卷卷名、挂载容器路径及备份
绑定挂载(bind mount)上传文件、需要直接由宿主机管理的文件保留,前提是继续使用同一个宿主机路径路径、属主权限及备份
容器可写层临时缓存、可重新生成的运行数据通常不保留不应存放需要保留的业务数据

以下配置以单台 Linux 服务器、Docker Compose v2 和 PostgreSQL 为例。新加坡服务器的地域不会改变 Docker 卷的工作方式;需要额外考虑的是,命名卷默认仍依赖这台服务器的本地存储。若应用和数据库都在 Compose 网络中,数据库通常不需要发布主机端口。

示例中的 POSTGRES_IMAGE 使用主版本标签仅为展示配置结构。生产环境应选用已验证、持续维护的具体补丁版本或镜像摘要,并在升级前检查兼容性。APP_IMAGE、应用环境变量和上传目录也需按现有应用实际配置替换,不能直接照搬占位值。

name: sg-prod

services:
  db:
    image: postgres:16
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB:?set POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER:?set POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD}
    volumes:
      - pg/var/lib/postgresql/data
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U "$$POSTGRES_USER" -d "$$POSTGRES_DB"
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 20s

  app:
    image: ${APP_IMAGE:?set APP_IMAGE}
    restart: unless-stopped
    environment:
      DB_HOST: db
      DB_NAME: ${POSTGRES_DB:?set POSTGRES_DB}
      DB_USER: ${POSTGRES_USER:?set POSTGRES_USER}
      DB_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD}
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - uploads:/app/uploads

volumes:
  pg
    name: sg-prod-pgdata
  uploads:
    name: sg-prod-uploads

这里,pgdata 挂载到 PostgreSQL 的数据目录,uploads 挂载到应用容器的 /app/uploads。如果应用实际写入 /var/lib/app/files,就应将挂载目标改为该路径;挂载到错误位置并不会自动把应用已有数据迁移过去。

现状与条件配图

顶层的 name 和卷的显式 name 用来降低项目目录改名、从其他目录运行 Compose 等操作造成卷名变化的风险。卷名固定也意味着同一台主机上的其他 Compose 项目可能与它重名;同时运行多个环境时,应使用不同的卷名。先检查是否已有同名卷,不要在未确认卷内容时直接复用。

Compose 会从项目目录中的 .env 读取变量用于配置插值,但这些变量不会自动进入容器,必须像示例那样通过 environment 或其他方式传递。.env 中的数据库密码应使用符合应用要求的强随机值,并限制文件读取权限;不要将包含密码的文件提交到代码仓库,也不要把 docker compose config 的完整输出随意贴到公开工单中,因为展开后的配置可能含有密钥。

日常操作

先确认当前项目和卷

在修改 Compose 文件前,先进入实际运行该服务的项目目录,确认服务、镜像和卷的状态:

cd /srv/sg-prod
docker compose ps
docker compose images
docker volume ls

检查当前数据库容器挂载了什么:

db_id="$(docker compose ps -q db)"
docker inspect -f '{{range .Mounts}}{{println .Type .Name .Source "->" .Destination}}{{end}}' "$db_id"

输出中应能看到一个挂载目标为 /var/lib/postgresql/data 的卷。若输出中没有对应挂载,先暂停配置变更并查清当前数据位置:数据库可能仍在容器可写层中,也可能使用了与示例不同的宿主机路径或卷名。此时直接改成示例配置,可能会让新容器连接到一个空卷,而旧数据仍留在原位置。

再核对 Compose 实际解析到的配置:

docker compose config --quiet

此命令用于检查配置能否解析,不会替代卷核对。若需要查看展开后的配置,应在可信终端中操作并保护输出中的敏感信息。

固定数据位置后再应用配置

确认实际卷名和挂载路径无误后,再修改 Compose 配置。对已运行的服务执行:

docker compose up -d
docker compose ps

docker compose up -d 会根据配置创建或重建有变更的容器。只要数据库服务仍挂载原来的卷,重建数据库容器不会等同于初始化一套新数据;但如果改了卷名或挂载目标,Compose 可能创建一个新卷,应用启动后看起来就像数据库被清空了。

更新应用镜像时,应明确目标版本,不要在没有评估的情况下使用不断变化的 latest 标签。若只想应用应用服务的配置变更,可以检查变更范围后执行:

docker compose up -d app

此操作仍可能影响正在处理请求的应用容器。数据库容器也有变更时,先确认是否会重建数据库、预计停机时间以及恢复方式,再安排窗口。只修改 .env 中的 POSTGRES_PASSWORD 并不会自动修改数据库内部已有账号的密码;PostgreSQL 官方镜像中的初始化变量主要用于初始化空数据目录,已有数据库的账号密码需要通过数据库自身的账号管理流程变更,并同步更新应用配置。

检查上传目录和权限

绑定挂载的宿主机目录应明确、固定,例如 /srv/sg-prod/uploads。检查应用容器的挂载情况:

app_id="$(docker compose ps -q app)"
docker inspect -f '{{range .Mounts}}{{println .Type .Source "->" .Destination}}{{end}}' "$app_id"

宿主机目录的属主和权限需要与应用进程的运行用户相容。先核实应用容器中的用户和实际路径,再决定是否调整权限:

docker compose exec app id
docker compose exec app sh -c 'ls -ld /app/uploads'

不要把未知的 UID/GID 当成固定值,也不要使用递归的 chmod -R 777 来处理写入错误。宽泛的递归权限变更可能影响目录内全部文件,并扩大访问范围。若确需调整,只作用于已确认的业务目录;变更前记录原属主和权限,以便按记录恢复。

结果检查

配置更新后,至少检查容器状态、数据挂载和应用读写结果,而不只是确认容器显示为 Up。

检查服务和数据库健康状态:

docker compose ps
docker compose exec -T db sh -c \
  'PGPASSWORD="$POSTGRES_PASSWORD" pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"'

pg_isready 返回可接受连接,说明数据库已准备好接收连接,但不证明业务查询或应用写入完全正常。还要在应用层执行一条低风险的读写验证,确认应用连接到预期数据库,并能访问需要的上传目录。

需要核实卷名称时,可以检查 Compose 显式设置的卷:

docker volume inspect sg-prod-pgdata
docker volume inspect sg-prod-uploads

实际挂载结果应与 Compose 配置一致。若服务使用的是绑定挂载,还应核对宿主机源路径确实是预期目录,而不是一个拼写错误后自动创建的空目录。

计划验证容器重建时,应安排在可接受的维护窗口内,并先确认近期备份可用。容器重建会造成服务短暂中断,数据库连接也可能被断开;不要为了验证而在生产数据上添加或删除未经确认的测试记录。验证后检查容器 ID 是否变化、卷名和挂载目标是否仍一致,再通过应用执行正常读写检查。

异常处理

容器启动后数据库看起来是空的

优先检查挂载,而不是立即初始化新数据或删除卷:

docker compose ps
docker volume ls
db_id="$(docker compose ps -q db)"
docker inspect -f '{{range .Mounts}}{{println .Name .Source "->" .Destination}}{{end}}' "$db_id"

常见原因包括 Compose 项目名变化、卷名被修改、绑定挂载路径写错,或数据仍在旧容器的可写层。先对照变更前的配置、容器信息和卷清单,确认旧数据所在位置,再决定是否恢复原卷或从备份恢复。

不要用 docker compose down -v 作为重启或清理手段。-v 会删除 Compose 管理的命名卷,可能造成业务数据丢失;docker volume rm 和带卷清理选项的全局清理命令也可能产生同类风险。docker compose down 不带 -v 通常不会删除命名卷,但仍会停止并移除容器,执行前要确认服务影响范围。

应用无法写入绑定目录

先核实容器内目标路径、宿主机源路径、应用运行 UID/GID 和宿主机文件权限。若目录属主与应用进程不匹配,应用可能出现权限拒绝;若挂载路径写错,也可能导致文件被写进容器可写层,重建后消失。

只对确认需要的目录进行有范围的权限修复,并记录原有设置。不要把整个项目目录、系统目录或数据库卷的权限一并改动。数据库命名卷由镜像初始化并管理其文件权限,除非已确认原因和操作步骤,不要直接在宿主机上递归修改 Docker 卷内部文件。

磁盘空间不足

检查文件系统和 inode 使用情况:

df -h
df -i
docker system df

若服务器磁盘接近耗尽,先识别增长来源、评估业务影响并安排扩容或有针对性的清理。日志、数据库文件、上传内容和备份可能分别占用空间;删除日志或备份前要确认保留要求和可恢复性。不要直接运行带卷清理选项的 Docker 全局清理命令来“腾空间”,这可能删除仍在使用或用于恢复的数据。

改了数据库镜像版本后无法启动

同一数据库主版本的小版本维护更新,与跨主版本升级不是一回事。不要只把 PostgreSQL 镜像从一个主版本改到另一个主版本,就让新版本直接使用旧主版本的数据目录。跨主版本升级需要按 PostgreSQL 支持的升级方法进行,常见方案包括受控的数据迁移或 pg_upgrade;操作前必须备份,并在隔离环境验证应用兼容性、扩展和恢复流程。

如果镜像升级失败,保留原数据卷和旧镜像,不要在排查时删除卷或反复用不兼容版本启动数据库。确认问题范围后,在维护窗口恢复已验证的旧镜像版本,检查数据库能否正常启动,再重新制定升级方案。

必要恢复

命名卷解决的是容器替换后的本机数据保留,不是异地备份。新加坡服务器发生磁盘故障、误删卷或主机整体故障时,留在同一块磁盘上的备份可能也无法使用。数据库备份应复制到独立的备份主机或对象存储,按业务要求设定保留周期和访问权限;包含敏感数据的备份应采用适当的加密和密钥管理方式。至少要定期验证备份文件可读,并演练恢复。

必要恢复配图

以下示例将 PostgreSQL 逻辑备份写到服务器上的备份目录。生产环境还应将生成的备份复制到独立存储。备份过程中数据库仍可接受写入,但如果上传文件与数据库记录必须保持同一时点的一致性,应先启用应用维护模式或暂停相关写入,再一起备份数据库和文件。

cd /srv/sg-prod
umask 077
install -d -m 0700 /srv/sg-prod/backups

backup="/srv/sg-prod/backups/db-$(date +%F-%H%M%S).dump"
tmp="${backup}.partial"

docker compose exec -T db sh -c \
  'PGPASSWORD="$POSTGRES_PASSWORD" pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  > "$tmp" \
  && test -s "$tmp" \
  && docker compose exec -T db pg_restore --list < "$tmp" > /dev/null \
  && mv "$tmp" "$backup"

命令成功后,最终文件名以 .dump 结尾;若中途失败,留下的 .partial 不应被当成可用备份。确认文件通过基本检查后,再将其复制到独立存储,并保留传输及恢复所需的访问凭据。

若应用同时保存上传文件,可以在暂停写入后备份绑定目录。例如:

tar -C /srv/sg-prod -czf \
  "/srv/sg-prod/backups/uploads-$(date +%F-%H%M%S).tar.gz" \
  uploads

恢复数据库前,先在隔离环境或新数据库中测试备份,不要直接对正在使用的生产库执行带清理选项的恢复操作。下面的示例使用名为 restore_check 的临时数据库;先确认这个名称尚未被占用。恢复可能因数据库扩展、角色或权限要求而失败,需按应用实际情况处理。

cd /srv/sg-prod
backup="/srv/sg-prod/backups/db-YYYY-MM-DD-HHMMSS.dump"

docker compose exec -T db sh -c \
  'PGPASSWORD="$POSTGRES_PASSWORD" createdb -U "$POSTGRES_USER" restore_check'

docker compose exec -T db sh -c \
  'PGPASSWORD="$POSTGRES_PASSWORD" pg_restore -U "$POSTGRES_USER" -d restore_check --no-owner' \
  < "$backup"

确认临时库中的表、关键数据和必要扩展符合预期,再按维护方案切换应用连接或将数据恢复到目标库。替换现有生产数据前,先备份当前生产库、明确停机范围,并保留可回退的数据副本。若上传文件也需要恢复,数据库与文件应按同一恢复时间点协调处理,避免数据库记录指向不存在的文件,或文件目录中出现没有对应记录的内容。

上线验收清单

  • 数据库目录和需要保留的应用文件均已挂载到明确的命名卷或宿主机路径。
  • 已记录实际卷名、挂载目标和绑定挂载源路径;项目目录变化不会导致误用新卷。
  • docker compose ps 显示预期服务运行,数据库健康检查通过,应用能正常读写。
  • Compose 更新前已确认会被重建的服务及可能的短时中断。
  • 数据库镜像版本经过验证;跨主版本升级没有被当作普通容器重建处理。
  • 已生成数据库备份,并验证备份文件可读;上传文件备份与数据库的一致性需求已评估。
  • 至少一份备份保存在服务器本地磁盘之外,且恢复所需的密钥和访问方式可用。
  • 团队明确知道不要用 docker compose down -v、卷删除命令或卷清理操作处理普通重启问题。

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

相关推荐