帮助文档

Safrove（安匣） 使用指南

本指南按照 Windows 客户端的四个标签页组织，说明如何完成首次配置、确认备份状态、搜索并打开历史文件，以及将快照挂载为只读磁盘。

快速开始

Safrove 设置页面
首次使用时，请先在 Settings 中配置备份仓库、加密密码、待备份目录、备份频率和快照保留策略。
1. 设置仓库在 Location 中选择或输入用于存放备份仓库的路径。
2. 添加来源在文件夹列表中添加需要备份的数据目录。
3. 保存并备份点击 Save 验证密码并保存设置，然后在 Status 中点击 Backup Now。

首次配置流程

1. 设置 Location（备份仓库）

Location 指定备份仓库，是保存全部历史备份的核心位置。 该目录保存加密数据块、快照记录、索引和仓库配置。仓库一旦损坏或丢失，历史版本可能无法读取、挂载或恢复。

  • 建议使用独立磁盘、外置硬盘或容量充足的专用目录；不要使用系统临时目录。
  • 可用容量至少应覆盖所有待备份目录当前数据量的总和。初始规划可按总数据量的 1.5 至 2 倍预留；文件变化越频繁、保留周期越长，所需空间越大。
  • Safrove 会在执行备份时自动排除仓库目录，以防止递归备份。即便如此，仍建议将仓库与待备份目录分开存放。

2. 设置 Encryption Password

密码无法找回，也无法绕过。 该密码用于解密整个仓库。打开已有仓库时，必须使用创建仓库时设置的密码；一旦遗失，Safrove 将无法读取、挂载或恢复其中的数据。请将密码妥善保存在密码管理器或其他安全位置。

3. 添加或删除要备份的目录

  • 添加： 选中表格底部的空白行，点击该行右侧显示的“...”选择文件夹；也可以双击空白行，直接输入完整路径。
  • 修改： 双击已有路径进行编辑，或选中该行后点击右侧“...”重新选择目录。
  • 删除： 右键单击要移除的行并选择 Delete。此操作只会从备份配置中移除该目录，不会删除磁盘上的原始文件。
  • 仓库排除： 如果仓库目录与待备份目录存在包含关系，Safrove 会在每次备份前自动排除仓库本身；位于仓库内部的来源目录不会被备份。

4. 选择 Backup Frequency

该下拉菜单用于设置自动备份间隔，可选 Manual、Every 1/2/4/8/12 hours 或 Daily。

  • Manual：不执行自动备份；需要备份时，请在 Status 中点击 Backup Now。
  • Every N hours / Daily：按设定的时间间隔触发备份并创建快照。相同的数据块会被去重，不会重复占用等量空间。
  • 频繁修改的工作目录可选择 1 至 4 小时；变化较少或数据量较大的目录可选择 8 小时、12 小时或 Daily。

5. 选择 Prune（历史保留策略）

Prune 用于控制历史快照的保留范围。各项保留条件会共同生效；同一个快照可能同时满足“最近”“每日”“每周”等条件，因此最终保留数量并不是各项数值的简单相加。

Minimal

保留最近 3 个、每日 1 个、每周 1 个、每月 1 个、每年 1 个。适合空间较紧张的仓库。

Standard

保留最近 10 个、每日 7 个、每周 4 个、每月 12 个、每年 2 个。适合大多数用户。

Maximum

保留最近 30 个、每日 14 个、每周 8 个、每月 24 个、每年 5 个。可保留更完整的历史记录，但需要更多存储空间。

Standard 示例

假设每小时备份一次，“最近 10 个”可覆盖约 10 小时；更早的历史中，再分别保留近 7 天每天 1 个、近 4 周每周 1 个、近 12 个月每月 1 个，以及近 2 年每年 1 个代表性快照。

6. 保存并完成首次备份

  1. 根据需要设置 Start with Windows，然后点击 Save。看到保存成功提示后，进入 Status 并点击 Backup Now。
  2. 等待任务完成，确认 Last backup、Snapshots、Files 和任务日志均已更新。
首次备份完成后，请在 Status 中确认 Last backup 显示 Successful，并检查对应 Backup 日志的状态是否为 SUCCESS。

授权与激活

Safrove 使用绑定当前 Machine ID 的离线 license.lic 授权文件。授权有效期决定是否允许写入仓库；授权正常到期后，仍保留对已有备份的只读访问能力。

授权有效期内 授权到期后
完整读写 只读访问
  • 允许 Backup Now 和按 Backup Frequency 自动备份。
  • 允许执行 Quick check、Clean Unused Data、Unlock Locks 等维护操作。
  • 允许搜索、双击打开、挂载、卸载和恢复已有历史数据。
  • 禁止创建新快照，自动备份计划停止执行。
  • 禁止清理及其他会修改仓库或配置的维护操作。
  • 仍可搜索、双击打开、挂载和恢复已有快照中的数据。

获取并导入授权文件

  1. 打开托盘菜单中的 License...，确认 Machine ID；Buy Now 会打开 safrove.com/buy，并自动带入当前机器码。
  2. 试用授权：在网页选择 14-Day Trial，填写邮箱并确认协议，生成后下载 license.lic。
  3. 购买授权：在购买功能开放后，从同一页面选择买断版并完成付款，下载为当前 Machine ID 签发的 license.lic。
  4. 返回 License 窗口，点击 Import License... 选择该文件。程序会复制并立即验证，显示 Activated 后生效。
当前网页的自助接口仅开放 14 天试用授权；买断版会在支付接口开放后提供。授权文件可离线导入，日常使用不要求在线验证。

排查步骤

  • 打开 License... 检查授权状态和到期时间。
  • 确认程序目录中的 license.lic 是当前机器的授权文件。
  • 如果提示机器码不匹配，使用当前机器码重新激活。

备份设置

Settings 将仓库位置、加密密码、来源目录、备份频率、保留规则和维护操作集中在一个页面中。

仓库与密码

  • Location — 备份仓库路径，负责保存快照、索引和数据块。
  • Encryption Password — 仓库加密密码。忘记后无法读取历史备份，请妥善保管。
  • Save — 点击 Save 后会验证仓库密码并保存全部设置；成功后会显示完成提示。

来源目录

表格中的每一行代表一个待备份的来源目录。可以添加多个目录；如果来源目录与仓库存在包含关系，程序会在备份时自动排除仓库本身。

备份频率与保留规则

Backup Frequency 控制自动备份间隔；Prune 控制历史快照保留策略，并在下拉框右侧显示当前规则的具体保留数量。

维护操作

Run Check 快速检查仓库元数据和索引，Clean Unused Data 清理不再引用的数据，Unlock Locks 清除确认已失效的仓库锁。执行维护操作时不要同时运行备份。

Safrove 设置页面
当前 Settings 页面：上方配置仓库和来源目录，下方设置计划、保留规则与开机启动，右下角 Save 保存。
程序会在备份执行时自动排除仓库目录，防止递归备份。为了目录结构清晰和降低误配置风险，仍建议仓库与待备份目录分开存放。

状态与任务日志

Status 用于查看仓库概览、统计数据和任务日志，也可立即执行 Backup Now 或 Quick check。

Safrove 状态与任务日志页面
上方显示仓库、运行状态、最近备份和统计数据，下方按时间倒序显示任务日志。
Repository

显示当前仓库路径，左侧有仓库图标标识。

Status / Last backup

Status 表示程序当前的运行状态，例如 Idle、Refreshing 或 Running；Last backup 显示最近一次备份的结果。

Snapshots / Files

Snapshots 是仓库中的快照总数；Files 是当前索引统计到的文件数量。

任务日志

按时间倒序列出每次任务，包括类型、状态、耗时和 Detail；失败或跳过时可在此查看原因。

Original

被索引文件的原始逻辑大小，即未考虑压缩和去重时的数据规模。

Stored

仓库实际存储的数据大小，包含压缩、去重后的数据块及相关仓库数据。

Saved

根据 Original 与 Stored 估算的空间节省比例，主要来自去重和压缩。

Quick check

快速检查仓库元数据和索引的一致性，不读取全部数据块内容。适合日常快速检查；它不能替代完整数据读取校验。

在所有历史版本中搜索（Search Files）

Search Files 的搜索范围不是当前文件夹或单个快照，而是所有已建立索引的历史快照。搜索结果先汇总匹配的文件路径；选中路径后，可查看该文件在全部快照中的历史版本。

匹配规则与示例

  • 普通输入采用不区分大小写的完整路径子串匹配，并自动把“\”与“/”按同一种路径分隔方式处理。例如 report 可匹配 /work/Report.xlsx。
  • 输入扩展名也会匹配路径，例如 .png 会找到路径中包含 .png 的文件；project/settings 可匹配包含该路径片段的文件。
  • 包含 * 或 ? 时使用通配符：* 表示任意长度字符，? 表示一个字符。例如 *.py 匹配 Python 文件，report?.docx 可匹配 report1.docx。
  • 右上角状态菜单可进一步筛选 Deleted、Changed、Stable 或 Size anomaly；最多显示前 500 条匹配结果。
Safrove 跨历史版本搜索页面
一个搜索框覆盖全部历史快照；左侧找文件，右侧选版本。

左右列表如何使用

左侧：搜索结果

每行是一个唯一文件路径，并显示 Versions、最新大小和状态。结果按全局索引建立顺序显示，通常接近路径顺序，不是相关度排序。

右侧：File History

选中左侧文件后，右侧列出该路径在所有快照中的版本，按 Snapshot Time 从新到旧排列，并显示大小及与前一版本是否相同。

双击即可打开： 在右侧 File History 双击目标版本，Safrove 会把该版本恢复到临时目录，并调用 Windows 默认关联程序直接打开，不覆盖当前文件。

快照时间线、挂载与卸载

Snapshots 用于按备份路径和时间查看快照变化，并把任一快照挂载为只读 Windows 驱动器。

Safrove 快照时间线与挂载页面
先选择备份路径和时间范围，再通过图表及下方表格选择目标快照。

选择路径并阅读顶部图表

  1. 先在左上角路径下拉菜单选择要查看的备份路径，再在右侧选择 All Time 或其他时间范围。页面只显示符合这两个条件的快照。
  2. 图表横轴是快照日期，每根柱代表一个快照相对前一个快照的变化量；绿色是 Added，橙色是 Modified，红色是 Removed。柱越高，变化文件越多。
  3. 点击图表中的柱或时间点，会同步选中下方对应快照，并刷新该快照的变化列表。

底部两个表格

左侧 Snapshots

按时间从新到旧列出快照，包含 Time、Snapshot ID、Path、Changes 和 Tags。选择一行即确定要查看或挂载的历史时间点。

右侧 Snapshot Changes

显示所选快照相对同一路径前一快照的变化明细，包括 Added、Modified、Removed、文件路径和大小；第一个快照可能没有可比较的前一版本。

挂载和卸载

  1. 在左侧 Snapshots 表格中只选择一个目标快照。
  2. 右键该行选择 Mount As Drive；如果页面显示 Mount 按钮，也可直接点击。系统必须已安装 WinFsp。
  3. 挂载成功后会自动打开只读盘符。也可从托盘菜单选择 Open Mounted Drive 再次打开。
  4. 使用页面中的 Unmount，或托盘菜单中的 Unmount 卸载。挂载另一个快照时，当前挂载会先被停止。
退出前先卸载。 挂载盘为只读模式，可以浏览、预览和复制文件，但不能修改其中的历史数据。

常见问题

提示文件正在被占用怎么办？

如果错误中包含 .safrove_write_in_progress，说明上一次备份或另一个进程仍持有写入标记。确认没有备份任务运行后，再重试；必要时关闭软件后重新打开。

Backup Now 显示授权不足怎么办？

先打开 License... 查看状态。如果提示机器码不匹配，需要使用当前机器码重新激活。

搜索还是慢怎么办？

尽量输入更具体的路径片段或文件名，避免只输入一个通用字符。大型仓库首次索引会更慢，后续筛选会更快。

忘记 Encryption Password 可以恢复吗？

不能。该密码用于加密仓库数据，软件无法绕过密码读取历史备份。