chore: snapshot current aws standby and backup tooling work

deploy/aws/ap-east-1/README.md

@@ -4,7 +4,7 @@
 
 目标架构：
 
-`DNS -> ALB -> WAF -> EC2(Nginx + ppanel-server + observability) -> RDS MySQL + ElastiCache Redis`
+`DNS -> ALB -> WAF -> EC2(Nginx + ppanel-server + Redis + observability) -> RDS MySQL`
 
 ## 1. 资源清单
 
@@ -16,7 +16,7 @@
 4. 公有 / 私有路由表
 5. 安全组
 6. RDS MySQL
-7. ElastiCache Redis OSS
+7. EC2 本机 Redis Docker
 8. EC2
 9. ACM 证书
 10. ALB + Target Group
@@ -28,7 +28,7 @@
 - VPC: `ppanel-hk-prod`
 - EC2: `ppanel-app-hk-01`
 - RDS: `ppanel-mysql-hk`
-- Redis: `ppanel-redis-hk`
+- Redis container: `hifast-redis`
 - ALB: `ppanel-alb-hk`
 - WAF: `ppanel-waf-hk`
 
@@ -42,6 +42,7 @@
 - Disk: `gp3 80GB`
 - Public subnet: 是
 - IAM Role: 允许读取 CloudWatch / SSM（如使用）
+- 如果要在 AWS EC2 本机执行 S3 备份：额外允许写入专用备份桶
 
 ### RDS MySQL
 
@@ -54,21 +55,21 @@
 - Charset: `utf8mb4`
 - Backup: `7-14 days`
 
-### ElastiCache Redis OSS
+### Redis
 
-- Engine: Redis OSS 7.x
-- Node type: `cache.m7g.large`
-- Cluster mode: disabled
-- Multi-AZ: 按预算决定，正式环境建议开启
-- Public access: 不开放
-- TLS: 当前模板按 **关闭** 规划
+- 部署位置：业务 EC2 本机
+- 部署方式：Docker
+- 版本：`redis:8.2.1`
+- 监听：`0.0.0.0:6379`
+- 应用连接：`127.0.0.1:6379`
+- 安全组：仅对白名单备用节点或同机应用开放
 
 ## 3. 网络与安全组
 
 ### 子网布局
 
 - `public-a`, `public-b`: ALB / EC2
-- `private-a`, `private-b`: RDS / Redis
+- `private-a`, `private-b`: RDS
 
 ### 安全组建议
 
@@ -99,10 +100,10 @@
 - Inbound
   - `3306/tcp` from `sg-ec2`
 
-#### `sg-redis`
+#### `sg-ec2` 额外说明
 
-- Inbound
-  - `6379/tcp` from `sg-ec2`
+- 如果需要外部备用节点复制 Redis，再额外放行：
+  - `6379/tcp` from `104.238.220.230/32`
 
 ## 4. ALB / Target Group / 健康检查
 
@@ -198,6 +199,7 @@
 - `MySQL.Addr`
 - `MySQL.Password`
 - `Redis.Host`
+- `Redis.Pass`
 - `JwtAuth.AccessSecret`
 - `Administrator.Email`
 - `Administrator.Password`
@@ -217,6 +219,41 @@ Redis 约定保持不变：
 
 把脚本上传到 EC2 后执行：
 
+## 9. 104 灾备节点常用运维脚本
+
+如果你要在 `104.238.220.230` 上执行数据迁移、主从重拉、主库提升，可以直接复用仓库里的这几份脚本：
+
+- 数据导出 / 导入交互工具：
+  - [`deploy/scripts/hifast_data_sync_tool.sh`](/Users/Apple/code_vpn/vpn/ppanel-server/deploy/scripts/hifast_data_sync_tool.sh)
+- MySQL 主从运维工具：
+  - [`deploy/scripts/mysql_replica_ops.sh`](/Users/Apple/code_vpn/vpn/ppanel-server/deploy/scripts/mysql_replica_ops.sh)
+- Redis 主从运维工具：
+  - [`deploy/scripts/redis_replica_ops.sh`](/Users/Apple/code_vpn/vpn/ppanel-server/deploy/scripts/redis_replica_ops.sh)
+- 统一总入口：
+  - [`deploy/scripts/hifast_data_sync_tool.sh`](/Users/Apple/code_vpn/vpn/ppanel-server/deploy/scripts/hifast_data_sync_tool.sh)
+- 主从运维环境模板：
+  - [`deploy/aws/ap-east-1/configs/replica-ops.env.example`](/Users/Apple/code_vpn/vpn/ppanel-server/deploy/aws/ap-east-1/configs/replica-ops.env.example)
+
+### 9.1 数据迁移工具
+
+支持：
+
+- 备份 MySQL 到 S3
+- 备份 Redis 到 S3
+- 从正式库导出 MySQL `sql.gz`
+- 把 `sql.gz` 导入 AWS RDS
+- 从正式 Redis 导出 `RDB`
+- 将 `RDB` 导入 Docker Redis 或宿主机 Redis
+- 查看 MySQL / Redis 当前主从状态
+- 强制重拉 MySQL / Redis 主从
+- 把 MySQL / Redis 从库提升为可写主库
+
+示例：
+
+```bash
+bash deploy/scripts/hifast_data_sync_tool.sh /root/replica-ops.env
+```
+
 ```bash
 chmod +x deploy/scripts/bootstrap_aws_ec2.sh
 sudo APP_DIR=/opt/ppanel deploy/scripts/bootstrap_aws_ec2.sh
@@ -244,7 +281,7 @@ docker compose -f docker-compose.cloud.yml up -d
 chmod +x deploy/scripts/preflight_aws_hk.sh
 APP_DIR=/opt/ppanel \
 RDS_HOST=<new-rds-endpoint> \
-REDIS_HOST=<new-redis-endpoint> \
+REDIS_HOST=127.0.0.1 \
 deploy/scripts/preflight_aws_hk.sh
 ```
 
@@ -260,7 +297,7 @@ deploy/scripts/preflight_aws_hk.sh
 4. 用户注册 / 登录
 5. 订阅查询
 6. 节点上报 `/v1/server/status`
-7. Redis 可写缓存
+7. 本机 Redis 可写缓存
 8. Asynq 可入队并消费
 
 ## 10. 正式切换
@@ -270,7 +307,7 @@ deploy/scripts/preflight_aws_hk.sh
 1. ALB 5xx 为 0
 2. EC2 CPU / Memory 正常
 3. RDS CPU / Connections 正常
-4. Redis CPU / Connections / Memory 正常
+4. 本机 Redis CPU / Connections / Memory 正常
 5. WAF 已挂到 ALB
 6. EC2 安全组没有对公网放 `8080/3333/9090/4317`
 
@@ -288,7 +325,7 @@ deploy/scripts/preflight_aws_hk.sh
 - ALB `RequestCount`, `HTTPCode_ELB_5XX_Count`, `TargetResponseTime`
 - EC2 `CPUUtilization`, `NetworkIn`, `NetworkOut`, `StatusCheckFailed`
 - RDS `CPUUtilization`, `DatabaseConnections`, `ReadLatency`, `WriteLatency`
-- Redis `EngineCPUUtilization`, `CurrConnections`, `BytesUsedForCache`
+- Redis 容器 CPU / Memory / restart count
 
 ## 12. 这次方案的边界
 
@@ -296,11 +333,31 @@ deploy/scripts/preflight_aws_hk.sh
 
 - 香港区新账号的部署模板
 - 新空环境启动与验证流程
-- ALB / WAF / EC2 / RDS / Redis 的落地约定
+- ALB / WAF / EC2 / RDS / 本机 Redis 的落地约定
 
 不包含：
 
 - 旧数据迁移
 - Terraform / CloudFormation 自动建资源
-- Redis TLS 改造
+- Redis 托管版改造
 - 多活 / 自动扩缩容
+
+## 13. S3 备份补强
+
+当前已落地的 S3 备份桶：
+
+- `hifast-prod-backups-200810848252-ap-east-1`
+
+建议与现网结合方式：
+
+1. `RDS automated backup` 继续保留，作为第一层恢复能力
+2. `104` 外部 MySQL 从库执行逻辑备份并上传到 S3，作为第二层可下载备份
+3. `104` 外部 Redis 从库按需导出 `RDB` 到 S3，补齐缓存类灾备材料
+
+仓库中已补充：
+
+- 环境变量模板：[`configs/backup-to-s3.env.example`](./configs/backup-to-s3.env.example)
+- MySQL 备份脚本：[`../../scripts/mysql_backup_to_s3.sh`](../../scripts/mysql_backup_to_s3.sh)
+- Redis 备份脚本：[`../../scripts/redis_rdb_backup_to_s3.sh`](../../scripts/redis_rdb_backup_to_s3.sh)
+
+建议把 MySQL 备份脚本优先部署到 `104`，因为它直接连接本地只读从库，对 AWS 主库扰动最小。