跳到主要内容

迁移到新服务器

您的 Qubix 许可证绑定到激活它的服务器的硬件指纹（由主板的固件 ID 派生而来）。这可防止 同一个许可证同时在多台机器上运行。当您迁移到新服务器或更换主板时，指纹会发生变化，因此您需要 使用您后台中重新签发的激活码来重新绑定许可证。

请在新服务器首次启动之前重新签发激活码——这样实例会在启动时干净地完成激活，中间不会出现 任何错误。

备注

在同一台服务器上进行的常规重新部署（新的 Docker 镜像、重新创建容器）不会改变指纹， 也不需要执行以上任何操作。

流程​

步骤​

  1. 在旧服务器上——停止整个服务栈，使数据库处于一致状态：
    Bash
    cd /opt/qubix && docker compose down
  2. 重新签发激活码。 打开 my.qubix.pro 后台 → 您的许可证 → 重新签发激活码。旧的硬件绑定会被释放，并签发一个全新的激活码——将其复制下来。
  3. 将实例复制到新服务器。 您需要保留的所有内容都位于 /opt/qubix 之下：
    • /opt/qubix/data/clickhouse — 您的数据库（所有统计数据、广告系列、事件和设置）；
    • /opt/qubix/data/letsencrypt — 您的 TLS 证书；
    • /opt/qubix/data/qubix — 后端的本地状态；
    • /opt/qubix/.env — 您的设置和密钥；
    • /opt/qubix/docker-compose.yml — 服务栈定义。
    Bash
    ssh newserver 'mkdir -p /opt/qubix'
    rsync -a /opt/qubix/ newserver:/opt/qubix/
    由于您在步骤 1 中停止了服务栈，数据库已干净地关闭，其文件处于一致状态——直接复制即可， 无需单独导出数据库。Web 服务器配置会在首次启动时自动重建，因此无需复制其他任何内容。
  4. 在新服务器上替换激活码。 复制过来的 /opt/qubix/.env 中仍然保留着旧的、已被使用的激活码。请将其值替换为您刚刚 重新签发的激活码（删除旧激活码，写入新激活码）：
    Bash
    LICENSE_ACTIVATION_CODE=XXXX-YYYY-ZZZZ
  5. 启动服务栈：
    Bash
    cd /opt/qubix && docker compose pull && docker compose up -d
    首次启动时，Qubix 会使用新激活码进行激活并绑定到新服务器。完成。
已经启动并看到硬件指纹错误？

这属于同一种情况，并非失败。执行步骤 2 和步骤 4，然后重启后端：

Bash
cd /opt/qubix && docker compose restart qubixd
保留异地备份

迁移之前，请始终保留 /opt/qubix/data 的异地备份——它是您的 分析数据库。

接下来做什么​

许可证密钥

激活 Qubix 许可证。

订阅到期

许可证到期时会发生什么。

On this page