🚀 BitAgere 节点一键自动运维系统

这是一个为 BitAgere 节点（审计人 / 执行人）量身定制的自动运维工具集，支持多钱包、多任务定时执行、自动备份上传、故障检测与邮件通知等功能。

---

✨ 核心功能

• 多钱包支持，适配多个节点同时运行
• 节点程序挂掉 / 限流时自动重启
• 钱包与日志定时备份并上传至 GCP 云端
• GitHub Actions 自动模拟每日运行
• 所有配置集中于 .env 文件统一管理
• .gitignore 防止配置意外泄露

---

📂 目录结构

bitagere-node-tools/
├── scripts/
│   ├── restart_auditor.sh
│   ├── monitor_rate_limit.sh
│   ├── backup_bitagere.sh
│   ├── upload_backup_to_gcp.sh
│   ├── backup_logs.sh
│   ├── upload_logs_to_gcp.sh
│   ├── record_validator_efficiency.sh
│   └── backup_and_upload_all.sh
├── logs/
│   └── [自动生成]
├── .env.example          # 配置模板（无私密信息）
├── .gitignore            # 忽略 .env 等私密配置
└── README.md

---

⚙️ 快速开始

git clone https://github.com/yourname/bitagere-node-tools.git
cd bitagere-node-tools

# 创建私有配置文件
cp .env.example .env
nano .env

在 .env 文件中，你需要配置以下变量：

• WALLET_LIST="你的多个钱包名"
• EMAIL_RECIPIENT="你的接收通知邮箱"
• GCP_BUCKET_NAME="你的 GCP 储存桶名"
• 其余路径保持默认即可

---

🧪 手动测试命令

bash scripts/restart_auditor.sh
bash scripts/monitor_rate_limit.sh
bash scripts/backup_bitagere.sh
bash scripts/upload_backup_to_gcp.sh
bash scripts/backup_logs.sh
bash scripts/upload_logs_to_gcp.sh
bash scripts/record_validator_efficiency.sh

---

⏰ 推荐 Crontab 定时任务

0 2 * * * /home/ubuntu/bitagere-node-tools/scripts/restart_auditor.sh
0 3 * * * /home/ubuntu/bitagere-node-tools/scripts/backup_bitagere.sh
0 3 * * * /home/ubuntu/bitagere-node-tools/scripts/backup_logs.sh
0 4 * * * /home/ubuntu/bitagere-node-tools/scripts/upload_backup_to_gcp.sh
0 4 * * * /home/ubuntu/bitagere-node-tools/scripts/upload_logs_to_gcp.sh
*/15 * * * * /home/ubuntu/bitagere-node-tools/scripts/monitor_rate_limit.sh

---

🧬 GitHub Actions 每日检测

.github/workflows/bitagere-daily.yml 自动工作流每日模拟运行，请在 GitHub 设置以下 Secrets：

• EMAIL_RECIPIENT
• WALLET_LIST
• GCP_BUCKET_NAME

---

🧾 示例 .env.example 配置模板

# 钱包配置
WALLET_LIST="WalletA WalletB"
EMAIL_RECIPIENT=your_email@example.com

# 路径配置
AUDITOR_SCRIPT_PATH=/home/ubuntu/RelayAgere/RelayAgere/auditor.sh
BITAGERE_WALLET_PATH=/home/ubuntu/.bitagere/wallets
BACKUP_DIR=/home/ubuntu/bitagere_backups
LOG_DIR=/home/ubuntu/bitagere-node-tools/logs

# 云端配置
GCP_BUCKET_NAME=your-gcp-bucket-name

# Python 虚拟环境路径
VENV_PATH=/home/ubuntu/RelayAgere/RelayAgere/.venv/bin/activate

# 备份策略
MIN_FREE_SPACE_GB=10
RETENTION_DAYS=7

---

📜 许可协议

本项目基于 MIT 协议开源，欢迎贡献与建议 🙌