EasyXrayEasyXray
帮助

迁移

在服务器之间或版本之间迁移 EasyXray 安装 —— 以及为什么不支持导入 X-UI / 3x-ui 安装。

从 X-UI / 3x-ui 迁移

EasyXray 不会迁移现有的 X-UI 或 3x-ui 安装。 既没有检测步骤,也没有导入命令,更没有自动转换。这两个产品在迁移所必需查看的几乎每一处都刻意不同:

X-UI / 3x-uiEasyXray
服务与命令x-uieasyxray
配置 / 数据库各自的路径/etc/easyxray/EasyXray.db
环境变量前缀XUI_*EASYXRAY_*
HTTP 命名空间/panel/…/easyxray/…

在已经运行 X-UI/3x-ui 的服务器上安装 EasyXray,属于一次全新的并行安装——它不会替换或升级旧版本。若要迁移过来,请全新安装 EasyXray,重新创建入站与客户端,并从旧面板逐一导出每个客户端的分享链接,以便在客户端侧导入。复用旧的 SQLite 文件不受支持:两者的数据库结构不同。

自动化方面也是如此:REST API 已从 /panel/api/… 迁移到 /easyxray/api/v1/…,旧前缀没有任何兼容别名。凡是针对 /panel/api/… 编写的脚本、机器人和面板,都必须更新。

在服务器之间迁移

把同一个 EasyXray 安装迁移到新服务器,本质上就是迁移数据库:

备份旧服务器

复制数据库(默认位于 /etc/easyxray/EasyXray.db)以及你的证书。参见 备份与恢复。

在新服务器上安装 EasyXray

使用相同的安装方式以及兼容的版本。参见 安装。

恢复数据库

停止面板,将数据库放置到位,恢复证书,然后启动面板。并重新检查所有与 IP/域名相关的设置。

在不同 EasyXray 版本之间迁移

在同一后端内,升级通常只需重新运行安装程序或拉取新镜像即可——面板会自行迁移其数据库。如果是跨大版本升级,请先阅读 版本发布说明 并做好备份。

在任何迁移之前都要先做好备份,并在确认新服务器正常工作之前保持旧服务器继续运行。

On this page