更新与本地存储:备份、重启、迁移和卸载
理解内置更新流程、源码构建限制、数据库归属和清除本地数据的影响。
先看自己的发行类型
桌面版、Web 独立服务和 Docker Compose 的运行方式不同。源码构建可以检查版本,但不会被官方自动更新覆盖。页面显示“只能检查”时,不要把它当成网络或余额问题。
点击客户端版本入口查看版本、最新发布、下载和校验状态。多个用户共用一套 Client 时,安装更新由其安装管理员执行;Partner 安装受保护更新还要有相应合作伙伴权限。
自动更新开关
User Client 和 Partner Client 的版本窗口中均有“自动更新”开关,默认开启。只有此安装的所有者可以修改,设置保存在本机,重启后继续生效。开启时会立即检查;之后按原有后台周期(约 30–35 分钟)检查、下载、校验并安装新版本,安装会重启客户端。失败后后台会重试。
关闭后仍可手动检查和安装;关闭不取消已经开始的安装。需要持续接单或长会话时可以保持关闭。源码构建和缺少安装支持的发行方式不能开启。Partner 自动更新使用当前安装所有者保存的有效凭据,并继续检查受保护下载权限。此开关不改变平台最低版本要求。
更新发生什么
客户端下载制品并核对产品、版本、系统、架构、文件摘要和发行签名。安装逻辑内置在主程序里,通过内部更新模式启动临时进程,不需要另带 primerouter-launcher 文件。
安装进程停止旧 Client、切换版本并等待新程序就绪;启动失败会按流程回滚。更新期间可能短暂不能接单,应先结束重要长会话,不要同时强制关机。
检查版本 → 下载 → 校验 → 临时安装进程
→ 旧进程退出 → 新版本就绪
→ 成功完成 / 失败回滚
Web 版若由系统服务管理,还需要服务管理员按部署方式管理进程接管。Docker 更新依赖宿主机运行对应 Client 的内部 Compose 服务;容器内部不直接拿 Docker Socket 替换自己。
哪些数据在本机
User Client 保存账号接入凭据、本地 Key、信任策略、请求诊断、增量使用记录和相应会话状态。Partner 保存自己接入与同步所需的资料、代理、实例和账号维护状态。
正式桌面版使用应用数据目录中的 SQLite。Web 服务版可以使用其支持的 SQLite/MySQL 配置。不要把数据库文件当成无害截图附件,它可能包含可用密钥。
升级与迁移
普通版本升级不等于删除数据。新版本通过迁移记录升级本地数据库;遇到问题先保留原数据和日志,不要通过删库反复尝试。
迁移到另一台电脑时,应有意识地处理平台 Key、本地 Key、应用数据、权限和新实例身份。不能仅复制一个程序就假设本机凭据、官方 CLI 登录和原设备记录全部随之转移。
清除和卸载
只删除程序文件不一定删除应用数据。User 的“移除此设备上的账号数据”明确清除当前账号的本机资料并退出,不删除网站账号或自动禁用网站 Key。
Partner 清理前先检查远端账号调度和同步是否仍在运行。本机出口断线会影响供号;删除本地文件不会自动替你停用所有远端账号。
先做需要的备份,再按确认内容操作。不会恢复的删除操作不要用于普通排障,见请求排障。


