# Typesense 数据备份与恢复

当您向 Typesense 发送文档时,系统会将数据存储在 服务器配置参数 data-dir 指定的目录中,然后构建支持搜索的内存数据结构。当 Typesense 进程重启时,会从数据目录读取数据并重建内存索引。

TIP

本文仅适用于自托管 Typesense 的情况。

# 备份步骤

直接归档/备份 Typesense 的数据目录是不安全的,因为在备份过程中 Typesense 可能正在写入打开的文件。正确的做法如下:

  1. 调用 快照 API 端点,指定服务器上写入快照的目录。
  2. 将此目录备份到远程存储,例如使用命令:tar -czvf backup.tar.gz -C /tmp/typesense-data-snapshot .

# 恢复步骤

  1. 停止所有正在运行的 Typesense 进程。
  2. 清空现有数据目录内容。例如:rm -rf /var/lib/typesense/*
  3. 将 tar gzip 备份文件解压到数据目录。例如:cd /var/lib/typesense ; tar -xf backup.tar.gz .
  4. 重新启动 Typesense 进程。

Typesense 随后会从数据目录读取快照并重建内存索引。