SetFN
SetFNDocs2026年10月27日

迁移服务器

介绍如何将安装在 Linux 上的 SpaceBuilder 迁移到新服务器。将配置文件夹和数据存储路径复制到新服务器后，在新服务器上重新注册许可证。

开始之前

  • 在原服务器和新服务器的终端中进行。
  • 迁移期间连接会中断，请在用户较少的时间段进行。
  • 确认新服务器有足够的存储空间容纳原有数据。
  • 建议在新服务器上也使用与原服务器相同名称的用户账户和相同的路径。如果路径不同，需要修改配置文件。

确认要迁移的项目

位置内容
~/.config/SetFN配置文件、用户账户和服务器设置数据
数据存储路径团队和用户保存的文件

数据存储路径可在原服务器上使用以下命令确认。

~/setfn-spacebuilder homepath get

在原服务器上准备

  1. 在管理员主页的许可证管理中进行 释放许可证。许可证与设备绑定，必须先释放才能在新服务器上注册。
  2. 停止 SpaceBuilder。
    sudo systemctl stop setfn-spacebuilder
  3. 将配置文件夹和数据存储路径复制到新服务器的相同路径。以下是使用 rsync 的示例。
    rsync -a ~/.config/SetFN/ <用户名>@<新服务器地址>:~/.config/SetFN/
rsync -a <数据存储路径>/ <用户名>@<新服务器地址>:<数据存储路径>/

在新服务器上启动

  1. 按照在 Linux 上安装准备安装文件。请使用与原服务器相同版本的安装文件。版本可在原服务器上使用 ~/setfn-spacebuilder version 确认。
  2. 如果数据存储路径与原服务器不同，请在 ~/.config/SetFN/config.yaml 中修改路径。
    server:
  homeFolder: <新数据存储路径>
  3. 按照在 Linux 上安装中的自动启动设置进行配置，然后启动 SpaceBuilder。
    sudo systemctl start setfn-spacebuilder
  4. 登录管理员页面，在许可证管理中重新注册许可证。
  5. 将用户访问的地址改为指向新服务器。请参阅查看访问地址（本地/内网）和选择外部访问方式。

确认迁移结果

  • 确认可以使用原有账户登录。
  • 确认团队文件夹和个人文件夹中的文件可见。
  • 在管理员主页确认许可证状态。
  • 如果使用 Qdrant 或 Milvus 等外部向量数据库，请在知识存储中确认新服务器能够连接到该服务器。

与原服务器并行运营

如果要在继续运营原服务器的同时将复制的服务器作为独立服务器运营，请在首次启动复制的服务器之前执行以下命令。

~/setfn-spacebuilder admin vector-instance-id
~/setfn-spacebuilder admin prepare-clone <输出的 UUID>

第一条命令输出当前实例的 UUID。第二条命令为复制的服务器分配新的实例 UUID，并将一同复制过来的知识索引另行保管。启动服务器后，会根据已保存的文件重新生成知识索引。

复制的服务器也需要注册许可证。可运营的服务器数量因套餐而异。

注意事项

相关文档