备份与恢复的范围
influx CLI 的 backup 与 restore 覆盖两样东西：元数据（组织、用户、桶、看板、任务等配置）与时间序列数据。备份产物是一组文件，可以整份恢复到另一实例，也可以只挑某个桶恢复。它是最常用的灾难恢复手段，但可用性取决于是否演练过——备份文件存在不等于能恢复成功。
基本信息
| 工具 | influx CLI（influx backup / influx restore） |
|---|---|
| 备份 | influx backup <目录> -t <Token>，可加 --bucket-id 只备份某个桶 |
| 恢复 | influx restore <目录> -t <Token>，可加 --bucket 只恢复某个桶 |
| 恢复为新桶 | 恢复时指定新桶名，避免覆盖现有同名桶 |
| 权限 | 需要覆盖全部资源的读权限，建议使用 all-access Token |
| 执行时机 | 低峰期执行，并预先估算耗时与磁盘占用 |
典型使用场景
- 定期全量备份：按保留周期保留多份，并异地存放
- 实例迁移：整份备份恢复到新实例，完成环境搬迁
- 误删数据兜底：只恢复被误删的桶，避免整库回滚
- 升级与变更前快照：大版本升级或批量改配置前留一份
- 恢复演练：在隔离环境验证恢复流程与耗时，校准 RTO
备份与恢复
备份与恢复
# 全量备份到带日期的目录
influx backup /data/backup/20261012 -t $INFLUX_TOKEN
# 只看备份目录结构，确认元数据与数据文件都在
ls -lh /data/backup/20261012 | head
# 只恢复指定桶（恢复到新桶名时不会覆盖现有数据）
influx restore /data/backup/20261012 --bucket metrics -t $INFLUX_TOKEN
# 恢复后核对写入点数与时间范围
influx query 'from(bucket:"metrics") |> range(start: -30d) |> count()'关键环节读法
| 环节 | 要点 | 常见风险 |
|---|---|---|
| 备份前 | 确认 Token 权限覆盖全部资源 | 权限不足导致备份中途失败，产物不完整 |
| 备份中 | 避开写入高峰，观察磁盘与 IO | 备份与写入争抢资源，影响线上查询 |
| 恢复前 | 确认目标实例数据状态与桶名冲突 | 覆盖现有桶造成二次数据损失 |
| 恢复后 | 核对点数与时间范围，做抽样查询 | 只看命令返回成功，不校验数据完整性 |
| 记录 | 记录恢复耗时、数据量与发现的问题 | 无记录则 RTO 只能靠猜 |
备份要成对保留「元数据与数据」：只留数据文件而缺元数据，恢复到新实例时桶与权限配置无法还原，恢复出来的是一个空壳。
恢复是覆盖性操作：默认可能写入同名桶并影响线上数据，优先恢复到新实例或新桶名，确认无误后再切换应用指向。