数据库 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-10-03 15:44:19
创建人	孙荣利
创建时间	2026-10-03 15:44:19

该文档由孙荣利创建于 2026-10-03 15:44:19 ，孙荣利在 2026-10-03 15:44:19 修改了该文档。

[TOCM]

## 一、简介

```text
本方案使用 pg_basebackup 对 PostgreSQL（容器 postgresql14）执行每日全量物理备份：在容器内生成 tar 格式压缩备份，拷出到宿主机按日期归档，保留最近 14 天，超期自动清理。

注意：虽然归档目录命名为 day-increment，但 pg_basebackup 每次生成的都是全量备份，属于"按天归档的全量快照"，并非基于 WAL 的增量备份；如需真正的增量备份，应配合 WAL 归档方案。
```

## 二、备份方案

#### 1. 目录结构

```shell
/data/postgresql/backup/day-increment/
├── 20260930/          # 当天备份归档（tar.gz 压缩包）
├── 20260929/
└── ...                # 保留最近 14 天，超期自动删除
```

#### 2. 备份脚本（day-increment.sh）

脚本建议存放于 `/data/postgresql/backup/day-increment.sh`，可直接 `bash` 执行。

```shell
#!/bin/bash
# ============================================================
# PostgreSQL 日归档备份脚本
# 说明：目录名为 day-increment（按天归档），实际使用 pg_basebackup
#       做全量物理备份，按日期存放，保留最近 14 天，超期自动清理。
# 环境：容器 postgresql14，复制用户 repl_user，端口 5432
# ============================================================
set -euo pipefail

# 1. 生成当天日期（格式：20260930），用于归档目录命名
DATE=$(date +%Y%m%d)

# 2. 按天归档目录：/data/postgresql/backup/day-increment/YYYYMMDD
BACKUP_DIR=/data/postgresql/backup/day-increment/${DATE}

# 3. 创建归档目录（-p：目录已存在时不报错，幂等）
mkdir -p "${BACKUP_DIR}"
echo "[$(date '+%F %T')] 开始备份：${BACKUP_DIR}"

# 4. 在容器内执行 pg_basebackup（全量物理备份）：
#    -h 127.0.0.1 -p 5432  连接容器内 PostgreSQL 的地址和端口
#    -U repl_user          使用流复制专用用户（需具备 REPLICATION 权限）
#    -D /tmp/backup        备份输出到容器内临时目录
#    -Ft -z                tar 格式输出并压缩
#    --no-password         不交互式提示密码（认证由 pg_hba.conf 控制）
docker exec -i postgresql14 bash -c \
  "pg_basebackup -h 127.0.0.1 -p 5432 -U repl_user -D /tmp/backup -Ft -z --no-password"

# 5. 将容器内生成的备份文件拷出到宿主机归档目录
docker cp postgresql14:/tmp/backup/. "${BACKUP_DIR}/"

# 6. 清理容器内临时备份目录，避免占用容器磁盘空间
docker exec postgresql14 rm -rf /tmp/backup
echo "[$(date '+%F %T')] 备份完成：${BACKUP_DIR}"

# 7. 清理 14 天前的备份归档（按文件修改时间判断，超期直接删除）
find /data/postgresql/backup/day-increment -mtime +14 -delete
```

#### 3. 执行与验证

```shell
# 手动执行一次备份
bash /data/postgresql/backup/day-increment.sh

# 查看当天归档目录及备份文件
ls -lh /data/postgresql/backup/day-increment/$(date +%Y%m%d)/

# 验证备份内容（可选）：列出 tar 包中的文件
tar -tf /data/postgresql/backup/day-increment/$(date +%Y%m%d)/*.tar.gz
```

#### 4. 定时执行（可选，crontab 每日凌晨 2 点）

```shell
0 2 * * * /bin/bash /data/postgresql/backup/day-increment.sh >> /var/log/postgresql-backup.log 2>&1
```