# ⚡ ObsidianVault - 自动化云备份
  
## 🛡️ 永不再丢失你的服务器数据！
**ObsidianVault** 是 Minecraft 服务器终极备份解决方案。自动备份你的世界、插件和配置到安全云存储，具有定时备份、即时还原和企业级安全性。
### ✨ 主要特性
- 🚀 **自动化定时备份** - 使用 cron 任务调度，设置后即可忘记
- ☁️ **安全云存储** - 你的备份安全地存储在云端，并进行加密
- 🌍 **世界和插件备份** - 备份整个世界或单个插件
- ⚡ **即时命令** - 使用简单命令创建、下载和还原备份
- 📊 **备份历史** - 跟踪所有备份版本，并提供详细的历史记录
- 🔒 **企业级安全** - 使用客户端 ID/Secret 身份验证，确保安全传输
- 💾 **5GB 免费存储** - 慷慨的免费套餐，并提供可负担的升级选项
- 🔄 **轻松还原** - 一键从任何备份点还原
- 📱 **Web 控制台** - 从任何设备管理你的备份
- ⚙️ **灵活配置** - 自定义备份计划和世界选择
---
## 🚀 快速入门指南
### 1. 安装
1. 下载 ObsidianVault.jar
2. 将其放在服务器的 `plugins` 文件夹中
3. 重启你的服务器或使用 `/reload confirm`
4. 插件将生成 `plugins/ObsidianVault/config.yml`
### 2. 获取你的凭据
1. **创建账户** - 访问 [obsidianvault.io/auth](https://obsidianvault.io/auth) 并注册 (5GB 免费存储)
2. **访问控制台** - 登录你的 [控制台](https://obsidianvault.io/dashboard)
3. **生成凭据** - 点击 "Credentials" → "Generate New Credentials"
4. **复制值** - 立即保存你的 Client ID 和 Client Secret
### 3. 配置插件
编辑 `plugins/ObsidianVault/config.yml`:
```yaml
# ObsidianVault 配置
auth:
client-id: your-client-id-here # 来自你的控制台
client-secret: your-client-secret-here # 来自你的控制台
backup:
# 每天午夜备份 (cron 格式)
cron: "0 0 * * *"
# 自动备份的世界
worlds:
- world
- world_nether
- world_the_end
```
配置完成后，使用 `/reload confirm` 重新加载并开始备份!
---
## 🎮 命令
所有命令都以 `/backup` 开头：
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/backup list` | 列出所有可用的备份 | `obsidianvault.backup` |
| `/backup create world ` | 创建一个世界备份 | `obsidianvault.backup` |
| `/backup create plugin ` | 创建一个插件备份 | `obsidianvault.backup` |
| `/backup history ` | 查看备份历史 | `obsidianvault.backup` |
| `/backup download ` | 获取下载链接 | `obsidianvault.backup` |
| `/backup delete ` | 删除一个备份 | `obsidianvault.admin` |
| `/backup status` | 检查备份操作 | `obsidianvault.backup` |
### 命令示例
```
# 创建主世界的备份
/backup create world world
# 创建 WorldEdit 插件的备份
/backup create plugin WorldEdit
# 查看生存世界的全部备份
/backup history world survival
# 下载最新的备份
/backup download world survival
# 检查当前操作
/backup status
```
---
## ⏰ 自动调度
使用 cron 表达式配置自动备份：
| 计划 | Cron 表达式 | 描述 |
|----------|----------------|-------------|
| 每天午夜 | `0 0 * * *` | 每天一次 |
| 每 6 小时 | `0 */6 * * *` | 每天 4 次 |
| 每 30 分钟 | `*/30 * * * *` | 每天 48 次 |
| 每周 (星期日) | `0 0 * * 0` | 每周一次 |
| 工作日凌晨 2 点 | `0 2 * * 1-5` | 星期一至星期五 |
**Cron 格式:** `分钟 小时 天-of-month 月份 天-of-week`
---
## 🔧 高级配置
---
## 🔐 权限
| 权限 | 描述 | 默认值 |
|------------|-------------|---------|
| `obsidianvault.backup` | 访问备份命令 | op |
| `obsidianvault.admin` | 管理员命令 | op |
| `obsidianvault.reload` | 重新加载配置 | op |
---
## 🆘 故障排除
### 调试模式
通过在 config.yml 中设置 `debug: true` 启用详细日志记录以进行故障排除。
---
## 💎 为什么选择 ObsidianVault？
- 🔄 **自动化和可靠** - 设置你的计划，永远不用担心手动备份
- ☁️ **云优先设计** - 即使你的服务器硬件出现故障，你的数据也能安全存储
- 🚀 **性能优化** - 备份过程中对服务器性能的影响最小
- 💰 **具有成本效益** - 5GB 免费存储，并提供可负担的优质计划
- 🛡️ **企业级安全** - 你的备份经过加密和保护
- 📱 **轻松管理** - Web 控制台可在任何设备上管理备份
---
## 📞 支持与资源
- 📖 **文档:** [obsidianvault.io/docs](https://obsidianvault.io/docs)
- 🌐 **网站:** [obsidianvault.io](https://obsidianvault.io)
- 📧 **电子邮件支持:** support@obsidianvault.io
- 📊 **控制台:** [obsidianvault.io/dashboard](https://obsidianvault.io/dashboard)
---
## 🔒 今天就保护你的服务器！
加入数千名信任 ObsidianVault 来保护其宝贵 Minecraft 世界的服务器管理员。立即下载，永远不要再丢失你的服务器数据！
*ObsidianVault 未隶属于 Mojang Studios 或 Microsoft。Minecraft 是 Mojang Studios 的商标。*