跳转到主要内容
本页描述已有 local 离线备份命令。备份覆盖一个数据库 schema 和匹配的私有身份 / 密钥,不是运行中云 Sandbox 的完整快照,也不是 hosted 全套基础设施备份方案。

明确备份能恢复什么

Session 全部关闭的门禁不等于 Provider 全账户孤儿审计。确认该工作负载关联资源,并另外保留未决记录。离线一致性还要求备份期间没有其他进程写入目标数据库/设置;停止一个 launcher 不证明所有外部写入者都已停止。

前置条件

安装 pg_dump / pg_restore,使用正确 DATABASE_URL 和 HEXAGON_DATA_DIR。完成或取消活动 Run,关闭所有云 Session 并确认清理,停止本地服务。备份实现会拒绝仍在运行的服务、未关闭 Session、身份或解密不匹配。
目标目录必须全新,命令不会覆盖旧备份。备份包含 database.dump、master.key、owner.json、可选 deployment.json、hash 清单和迁移信息。目录和文件按私有权限创建;不能提交到仓库或公开上传。

恢复到全新目标

先建立全新空 PostgreSQL 数据库。目标数据目录不存在或为空。以下连接串是示意,使用你准备好的独立目标:
恢复检查 manifest、文件类型与 hash,拒绝非空数据库,使用事务恢复 schema,然后验证 owner 身份和所有加密记录可解密。返回的 schema 若不是 public,后续连接需要配置相应 search_path。使用目标 DATABASE_URL / HEXAGON_DATA_DIR 启动,不要误启动原工作区。 发现文件和 PID 在启动时重新生成,不复制旧进程身份。若恢复在数据库写入后失败,目标可能已不再为空;保留错误记录,检查 staging 目录和数据库,不要直接反复覆盖或删除尚未核实的数据。

恢复中断后的处理

整个命令不是跨 PostgreSQL 与文件系统的单个原子事务。再次恢复到已填充目标会被正确拒绝。不要把删除目标作为通用重试步骤,也不要让原部署和恢复部署同时操作同一组远程资源。

信任与一致性

只恢复可信来源的备份。hash 证明内容与清单一致,不证明归档作者可信。密钥与数据库要匹配:另一个工作区的 master.key 无法解密本备份。 该命令要求 Session 全部关闭,以避免重建仍活跃的云操作。自行恢复较旧或在线数据库副本时,还需额外对账备份时点后的云资源与外部写入,不能直接假设安全重放。 hosted 的外部主密钥、身份、TLS 和部署配置需由部署方另行备份;不要把 local 工具的成功外推为 hosted 恢复完成。

恢复验收

在隔离目标确认历史 Session / Run、初始化、事件和产物可读;凭据可解密;新测试任务可执行并确认清理;没有从旧状态意外复活资源。记录实际恢复命令、schema、验证范围和失败,公开证据不包含备份文件或秘密。 实现依据:离线备份与恢复。下一步:对账、升级、持久化。 11 月 18 日隔离恢复演练按排序行哈希比对了当时全部 27 张表,包括 Session、Run、事件、产物、连接与加密凭据,随后在恢复部署上执行了两套 SDK 的云旅程。表数只描述当时检查点,不是当前 schema 清单。这是 local 模式证据,本页未新增恢复执行。