3x-ui面板迁移与备份教程

换服务器的时候，3x-ui 里配置好的入站节点、用户数据、面板设置不想重新配置一遍，可以直接把数据库文件迁移过去。3x-ui 的数据全部存在一个 SQLite 数据库文件里，路径是 /etc/x-ui/x-ui.db，备份和迁移都围绕这个文件操作。

备份很简单，把这个文件复制出来就行。可以用 scp 直接从服务器下载到本地：

```bash
scp root@你的服务器IP:/etc/x-ui/x-ui.db ./x-ui.db
```

或者先在服务器上压缩，再下载：

```bash
cp /etc/x-ui/x-ui.db /root/x-ui-backup.db
```

建议换服务器之前、以及每次大改配置之前都备份一次，文件本身不大，存几个版本也占不了多少空间。

迁移到新服务器的顺序是先装好 3x-ui，再导入备份数据。参考3x-ui安装：MHSanaei版官方脚本与面板配置装好面板之后，把备份的 x-ui.db 上传到新服务器，覆盖掉新装的数据库文件：

```bash
scp ./x-ui.db root@新服务器IP:/etc/x-ui/x-ui.db
```

上传完之后重启 3x-ui 让新数据库生效：

```bash
x-ui restart
```

重启完登录面板，正常情况下之前的入站列表、用户数据、面板设置都会恢复。如果入站列表显示为空，再重启一次面板通常就能解决，不需要其他操作。

证书路径失效是迁移后比较常见的问题。如果你之前用的是自己的域名证书，证书文件存在旧服务器上某个路径，迁移过来之后面板里记录的还是旧路径，新服务器上这个路径可能不存在或者文件没有一起迁移过来。处理方式是把证书文件一并复制到新服务器的相同路径，或者在面板设置里重新填写新的证书路径，改完重启面板生效。

端口冲突的情况是新服务器上已经有其他服务占用了某个入站的端口，这时候那条入站会启动失败。进入面板入站列表，把冲突的端口改掉，同时记得在防火墙放行新端口。

迁移完之后建议逐一检查每条入站是否正常启动，用客户端实际连接测试一下，不要只看面板状态，有时候面板显示正常但实际连不上，实际测一下才知道。多用户的数据也会一并迁移过来，不需要重新添加，具体用户管理操作参考3x-ui多用户管理。