从 TG115 迁移到 TG2Cloud

TG2Cloud v1.0.2 默认按全新安装处理，不提供 TG115 原地自动迁移。

目录与名称的变化#

TG2Cloud 使用独立容器、网络和备份目录。旧目录或已停容器存在时只提示，不会自动覆盖、停止、移动或删除旧资源。

如果固定管理端口 19798/5244 被占用，或新目录/容器归属不明，部署会停止，不会自行抢占资源或随机换端口。

迁移前先处理这几件事#

1. 在旧实例中处理完队列，记录需要保留的失败任务和下载文件。
2. 通过旧项目的备份方式保护配置、数据库、网关状态和必要文件。
3. 记录 WebDAV 根目录、相对子目录、用户权限和存储挂载关系。
4. 确认新旧实例不会同时长期使用一个 Bot Token。
5. 确认有明确的失败后返回旧实例的方案。

所有凭据与备份留在自己的私有环境，不能公开提交给维护者。

推荐：独立安装后验证#

优先在独立 VPS 按 TG2Cloud 新目录部署，由本人重新配置存储授权和 WebDAV，完成真写验收与小文件测试。

验收前保留旧 VPS 和完整备份。新项目正常运行并不自动意味着旧队列已迁移；旧状态延续需要专门的迁移与验证计划。

必须复用同一 VPS 时#

安排维护窗口，先完成旧实例备份，再由操作者明确处理同 Edition 固定端口占用。旧目录可以保留，TG2Cloud 不会接管它。

不要简单重命名旧目录、移动数据库，或者批量替换文件内的 TG115 字样来“绕过”检测。

本机主机记录也需要重新核对#

TG2Cloud 使用 %APPDATA%\TG2Cloud-Deployer\known_hosts。旧 TG115 记录不会自动导入；首次连接通过服务商控制台核对 SSH 指纹。

明确尚未验证的范围#

仓库迁移文档未承诺旧 TG115 队列/状态的真实 VPS 迁移已经验收，也未承诺可直接复制 .env、rclone.conf、SQLite 或网关数据目录。需要延续这些状态时，先验证迁移方案，不要盲目覆盖。