VPS 被墙换新服务器:3x-ui 备份恢复,节点和用户一个不丢
不翻车编辑部 · 更新于

服务器被墙了,或者到期想换一家,新开一台不用从头配:3x-ui 首页的备份和恢复,旧面板导出一个 .db 文件,新服务器装好同版本的 3x-ui 再传上去,入站、用户、流量统计全回来。2026 年 10 月 16 日,我们在测试服务器上完整走了一遍(先卸载 3x-ui 当作全新机器,再装 v3.10.2、恢复),恢复后用订阅连 Google 三次,三次都返回 204。
被墙怎么判断、什么时候需要换服务器,先看 VPS 被墙了怎么办。
为什么一个文件就够?
3x-ui 官方文档《备份与恢复》写的是:入站、客户端、各项设置都存放在面板的数据库里,默认是 /etc/x-ui/x-ui.db。官方《迁移》一页说得更直接:迁移到新服务器,本质上就是迁移数据库。
第 1 步:旧服务器备份
面板首页 → 顶部备份和恢复 → 第一项“备份”,点右边的下载按钮。浏览器会下载一个 .db 文件,文件名是“服务器 IP_日期_时间.db”。

存在自己电脑上,再存一份网盘。被墙以后国内连面板也打不开,所以备份要趁现在做;已经被墙的,用别的能用的梯子打开旧面板再备份。
也可以在服务器上直接复制数据库(官方文档给的命令):
cp /etc/x-ui/x-ui.db /root/x-ui-backup-$(date +%F).db
第 2 步:新服务器装同一个版本
安装命令后面加版本号,装和旧服务器一样的版本。官方提醒:备份尽量恢复到与其来源相同的主版本上。
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) v3.10.2
装完会给一组新的端口、路径、账号密码(下面是我们这次的输出,已打码),用 ufw 放行这个端口:
Username: Z7f■■■■■■■
Password: ■■■■■■■■■■
Port: 13528
WebBasePath: c1BO■■■■■■■■■■■■■■
Database: SQLite (/etc/x-ui/x-ui.db)
root@srv:~# ufw allow 13528/tcp
Rule added
登进新面板,入站和客户端都是空的:

第 3 步:恢复,保留本机设置别去掉
首页 → 备份和恢复 → 第二项“恢复”,点上传,选旧服务器的 .db 文件。下面的保留本机设置默认勾着,别去掉。传完面板会自己重启。

“保留本机设置”具体留哪些?v3.10.2 源码里列得很清楚(hostBoundSettingKeys):面板和订阅服务的监听地址、域名、端口、证书、基础路径、订阅 URI,以及节点身份相关的密钥。入站、客户端、Reality 密钥、面板登录账号这些,都用备份里的。
恢复后要用旧账号登录
这里最容易懵。我们实测:恢复以后,新装时给的那组账号密码登不进去了,旧服务器的账号密码才能登进去。因为登录账号也存在数据库里,跟着备份回来了;地址还是新服务器的端口和路径。
恢复后:节点、用户、流量都在
入站:bufanche-reality(443、Reality)和 bufanche-hy2(8443、UDP)都回来了,总流量 716.98 MB 也在。

客户端:my-phone、mom、dad 三个用户都在,流量上限、分组、已用流量没变。

第 4 步:新机器放行端口
旧服务器放行过的端口,新机器要重新放。按你自己的入站改:
ufw allow 443/tcp # Reality
ufw allow 8443/udp # HY2,注意是 UDP
ufw allow 2096/tcp # 订阅
服务商后台有安全组的也要开。HY2 用的 IP 证书,新服务器装面板时已经重新申请好了(安装输出里有 “IP certificate installed and configured successfully”),路径还是 /root/cert/ip/,入站不用改。
第 5 步:客户端只改地址
用户 ID、Reality 的密钥都是从备份里来的,没有变,节点不用重配,变的只有服务器地址:
旧:https://旧IP:2096/<订阅路径>/<订阅ID>
新:https://新IP:2096/<订阅路径>/<订阅ID>
订阅路径和订阅 ID 跟着备份走,不变;订阅端口属于“本机设置”,两边都是默认 2096 就不变。客户端里把订阅地址的 IP 改掉,更新订阅,节点地址会跟着变成新 IP。
恢复后我们用 my-phone 的订阅在电脑上的 mihomo 里连 Google:
第 1 次访问 Google:HTTP 204 PROXY 当前用:主力
第 2 次访问 Google:HTTP 204 PROXY 当前用:主力
第 3 次访问 Google:HTTP 204 PROXY 当前用:主力
更省事的做法:订阅链接用域名不用 IP。下次换服务器,把域名解析改到新 IP,客户端什么都不用动。
搬家出问题,先查什么
| 现象 | 先查什么 |
|---|---|
| 恢复后登不进面板 | 用旧服务器的账号密码 |
| 上传提示出错 | 两边 3x-ui 版本是不是一样 |
| 节点连不上 | 新机器 ufw 和安全组放行了没有 |
| 订阅更新失败 | 订阅地址里还是旧 IP |
| HY2 连不上 | 放行的是不是 UDP |
| 面板地址打不开 | 保留本机设置勾着时,面板端口和路径是新服务器的,不是旧的 |
常见问题
**新旧服务器的系统不一样能恢复吗?**数据库只认 3x-ui 版本,不认系统;官方支持的发行版都行,版本尽量一样。
**保留本机设置去掉会怎样?**新面板会用旧服务器的端口、路径和证书路径,证书文件对不上时面板可能打不开。没有特别理由就别去掉。
**流量统计会清零吗?**不会,已用流量也在数据库里。我们备份前 my-phone 已用 708.78 MB,恢复后是 708.86 MB(多出来的是恢复后连测试用掉的)。
**旧服务器要马上删吗?**官方建议确认新服务器正常工作之前,旧服务器先留着。
资料来源
核对日期均为 2026 年 10 月 16 日。
- 3x-ui 文档:备份与恢复
- 3x-ui 文档:迁移
- 3x-ui 文档:安装(指定版本)
- 3x-ui v3.10.2 源码
internal/web/service/server.go(hostBoundSettingKeys)、frontend/src/pages/index/BackupModal.tsx - 2026-10-16 测试服务器实操截图和终端实录(录完已用开工前的完整备份还原);本机 mihomo 连通测试
