# 卸载与迁移

卸载节点与主控、保留或清除数据，以及用备份把主控迁到新机器。


## 卸载节点
在节点服务器上以 root 执行:

```
gocdn-node-uninstall
```

只停掉并删除节点的服务、程序和防火墙规则,节点身份、配置、缓存与日志都留着;重跑安装命令即以同一节点恢复,不需要新令牌。要彻底清除加 `--purge`,此后重新接入必须用新令牌,并在面板里删掉旧节点。末行 `NODE_UNINSTALL_DONE`,有残留会逐项列出。

## 卸载主控
在主控服务器上以 root 执行 `gocdn-master-uninstall`:停掉并删除主控各服务,库、钥、配置都留着,重跑安装命令即恢复。加 `--purge` 会连业务库、ClickHouse 库、钥和配置一起删掉。

:::warn
`--purge` 不可恢复。执行前先确认备份已经拷到别的机器,签名钥和凭据加密钥尤其要有离机副本。
:::

## 把主控迁到新机器
主控默认每小时自动备份业务库,ClickHouse 关键表每天备份一次,备份设置与加密见[备份与按时间点恢复](https://www.gocdn888.com/zh/guide/backup)。迁移的思路是:新机器上装好同版本主控,停服务,用备份恢复业务库,再起服务。

1. 在旧主控上确认最新一份备份,拷到新机器,同时拷走签名钥与凭据加密钥。
2. 新机器上用安装命令装主控(版本与旧主控一致)。
3. 停主控服务,执行 `gocdn-master db-restore < gocdn-db-<时间>.sql.gz`,末行 `DB_RESTORE_DONE`。
4. 起服务,登录检查数据;在「系统管理 › 升级与维护 › 节点通信」把「节点通信公网地址」改成新主控地址。

:::tip
配置了异地副本目录后,还能用 `-until` 恢复到任意时间点,步骤见[备份与按时间点恢复](https://www.gocdn888.com/zh/guide/backup)。
:::