如何自动备份Docker中的Postgre数据库

## 方案一：宿主机脚本 + Crontab 定时任务

这是最经典、最直接的方法。通过在宿主机（Host）编写 Shell 脚本，利用 `docker exec` 调用容器内的 `pg_dump` 工具。

### 实现步骤：

1. **编写脚本**：创建一个 `.sh` 文件，内容通常包含：

   ```Bash
   docker exec -t <container_name> pg_dumpall -c -U <username> > /path/to/backups/db_$(date +%Y%m%d).sql
   ```

2. **设置权限**：确保脚本具有执行权限。

3. **配置 Cron**：使用 `crontab -e` 添加定时任务（如每天凌晨 2 点执行）。

4. **清理机制**：在脚本中加入 `find` 命令自动删除 X 天前的旧备份。

### 优劣总结：

- **优点**：无需修改容器镜像，配置灵活，不占用额外的容器资源。
- **缺点**：依赖宿主机的环境配置，如果迁移到新服务器，需要重新配置 Cron 和脚本路径。


## 方案二：使用“边车”容器（Sidecar Container）

在 Docker Compose 中添加一个专门负责备份的服务。目前社区有很多成熟的镜像，如 `prodrigestivill/postgres-backup-local`。

### 实现步骤：

1. **修改 Compose 文件**：在 `docker-compose.yml` 中增加备份服务：

   
   ```YAML
   services:
     db:
       image: postgres:15
     backup:
       image: prodrigestivill/postgres-backup-local
       volumes:
         - ./backups:/backups
       links:
         - db
       environment:
         - POSTGRES_HOST=db
         - POSTGRES_USER=user
         - POSTGRES_PASSWORD=pass
         - SCHEDULE=@daily # 使用内建的 Cron 表达式
         - BACKUP_KEEP_DAYS=7
   ```

2. **启动服务**：`docker-compose up -d` 后，备份服务将自动按照设定的 `SCHEDULE` 运行。

### 优劣总结：

- **优点**：高度集成，配置与项目代码一同管理；易于迁移，一套 Compose 运行在任何地方都能备份。
- **缺点**：增加了一个容器的开销，且备份文件默认存储在卷中，仍需考虑异地备份。

## 方案三：云端/对象存储备份（如 S3/OSS）

如果您的数据非常重要，建议直接将备份流式传输到云存储（如 AWS S3 或阿里云 OSS），防止物理服务器故障。

### 实现步骤：

1. **选择镜像**：使用支持 S3 协议的镜像（如 `schickling/postgres-backup-s3`）。
2. **配置环境变量**：在容器中配置 `S3_ACCESS_KEY_ID`、`S3_SECRET_ACCESS_KEY` 和 `S3_BUCKET`。
3. **运行备份**：容器会自动完成“导出 -> 压缩 -> 上传”全流程。

### 优劣总结：

- **优点**：**异地灾备**，安全性极高；不占用本地磁盘空间。
- **缺点**：需要公网带宽，且会产生少量的云存储费用。

## 方案综合对比

| **特性**     | **方案一：宿主机脚本** | **方案二：Sidecar 容器** | **方案三：云存储备份** |
| ------------ | ---------------------- | ------------------------ | ---------------------- |
| **部署难度** | 中等 (需配置 Cron)     | **简单 (配置 YAML)**     | 较复杂 (需云端授权)    |
| **可移植性** | 差                     | **极佳**                 | 佳                     |
| **安全性**   | 依赖本地磁盘           | 依赖本地磁盘             | **极高 (异地冗余)**    |
| **适用场景** | 单机小型项目           | 复杂应用、微服务         | 生产环境、核心业务     |


## 建议

- **不要只备份不测试**：定期尝试从备份文件恢复数据，确保备份是“活”的。
- **敏感信息处理**：避免在脚本或 Compose 文件中明文写入密码，建议使用 Docker Secrets 或 `.pgpass` 文件。
- **监控报警**：无论采用哪种方案，最好配置一个备份失败的通知（如企业微信/钉钉 Hook），防止备份静默失效。