# tb-backup-restore

**Repository Path**: roofox/tb-backup-restore

## Basic Information

- **Project Name**: tb-backup-restore
- **Description**: 该项目提供了一套完整的ThingsBoard 3.4备份与还原解决方案
- **Primary Language**: Shell
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-11
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ThingsBoard 3.4 备份与还原方案

## 目录结构
本项目包含以下主要组件：
- **common**: 通用脚本和配置文件
- **full_version**: 完整版本（PostgreSQL + Cassandra）的备份与还原文档及脚本
- **postgresql_only**: PostgreSQL 单独版本的备份与还原文档及脚本

## 快速开始
根据您的 ThingsBoard 安装版本选择合适的备份还原方案：
- **完整版本（PostgreSQL + Cassandra）**：请参考 `full_version` 目录下的文档和脚本
- **PostgreSQL 单独版本**：请参考 `postgresql_only` 目录下的文档和脚本

## 选择合适的版本
- **完整版本**：适用于使用 PostgreSQL 和 Cassandra 的部署
- **PostgreSQL 版本**：适用于仅使用 PostgreSQL 的部署

## 安装步骤
### 完整版本（PostgreSQL + Cassandra）
1. 将 `full_version` 目录中的备份和还原脚本复制到您的服务器
2. 赋予脚本执行权限：
   ```bash
   chmod +x backup_script.sh restore_script.sh
   ```
3. 根据需要修改脚本中的配置（如备份目录、保留天数等）

### PostgreSQL 版本
1. 将 `postgresql_only` 目录中的备份和还原脚本复制到您的服务器
2. 赋予脚本执行权限：
   ```bash
   chmod +x backup_script_postgresql.sh restore_script_postgresql.sh
   ```
3. 根据需要修改脚本中的配置（如备份目录、保留天数等）

## 执行备份
### 完整版本
运行以下命令执行备份：
```bash
./backup_script.sh
```

### PostgreSQL 版本
运行以下命令执行备份：
```bash
./backup_script_postgresql.sh
```

## 执行还原
### 完整版本
运行以下命令执行还原：
```bash
./restore_script.sh /path/to/backup/file.tar.gz
```

### PostgreSQL 版本
运行以下命令执行还原：
```bash
./restore_script_postgresql.sh /path/to/backup/file.tar.gz
```

## 相关文档
- **完整版本**：
  - `full_version/BACKUP_README.md`: 备份方案详细说明
  - `full_version/RESTORE_README.md`: 还原方案详细说明
- **PostgreSQL 版本**：
  - `postgresql_only/POSTGRESQL_BACKUP_README.md`: PostgreSQL 备份方案详细说明
  - `postgresql_only/POSTGRESQL_RESTORE_README.md`: PostgreSQL 还原方案详细说明

## 功能特点
- 自动化备份与还原流程
- 支持定时备份任务
- 支持备份验证与监控
- 提供详细的日志记录
- 支持异地备份与灾难恢复

## 系统要求
- ThingsBoard 3.4
- PostgreSQL（如使用完整版本，还需 Cassandra）
- Bash shell 环境
- tar、gzip 等常用工具

## 完整文档
- `common/thingsboard_backup_restore_plan.md`: 详细备份与还原策略文档

## 贡献
欢迎提交 Issue 和 Pull Request 来改进本项目。

## 许可
本项目遵循 MIT License。详情请查看 `LICENSE` 文件。