备份与恢复

备份对象复制链接

1. 制作备份复制链接

Docker Compose 内置数据库：

umask 077
docker compose exec -T postgres pg_dump -U edgeweir -d edgeweir --format=custom > edgeweir.dump
docker compose exec -T postgres pg_restore --list < edgeweir.dump > edgeweir.dump.list

外部 PostgreSQL：

umask 077
pg_dump --format=custom --file=edgeweir.dump --dbname=edgeweir
pg_restore --list edgeweir.dump > edgeweir.dump.list

验证：

grep -c 'TABLE DATA' edgeweir.dump.list

预期：大于 0。

deploy.sh 部署执行 ./deploy.sh backup（update 前自动执行），写出同格式的 edgeweir.dump 以及 .env（不含主密钥与 BETTER_AUTH_SECRET）与编排文件，保留最近 5 份，见 deploy.sh 参考。主密钥另行离线保存。

2. 恢复复制链接

先在隔离环境验证。恢复环境的要求：

deploy.sh复制链接

deploy.sh 部署在部署目录执行：

./deploy.sh restore backups/20261001-080000

先备份当前数据库，停止控制台，删除并重建数据库，导入备份中的 edgeweir.dump，再启动并等待健康检查。.env 不变，其中须为上表的主密钥。前提与失败时的行为见 deploy.sh 参考。

Docker Compose复制链接

在新主机或新的 Compose 项目中执行：

1. 放置 compose.yml、原 .env 与 edgeweir.dump。

2. 启动空数据库：

   复制

   docker compose up -d --wait postgres

3. 导入：

   复制

   docker compose exec -T postgres pg_restore -U edgeweir -d edgeweir --exit-on-error < edgeweir.dump

4. 启动控制台：

   复制

   docker compose up -d

5. 验证：curl -s http://127.0.0.1:3000/healthz 返回 "status":"ok"。

外部 PostgreSQL复制链接

1. 恢复到新数据库：

   复制

   createdb edgeweir_restored
   pg_restore --exit-on-error --dbname=edgeweir_restored edgeweir.dump

2. 将控制台的 DATABASE_URL 指向 edgeweir_restored，按上表配置后启动。

3. 验证：curl -s http://127.0.0.1:3000/healthz 返回 "status":"ok"。

3. 节点重新同步复制链接

1. 数据库中的 CA 恢复后，已注册节点经 mTLS 重新连接。等待每个节点在恢复后上报新的心跳；恢复前的心跳不计入。
2. 发布一次配置（任一网站或集群配置变更）。

配置版本号规则：

旧版节点在备份前升级并完成一次配置同步；节点状态备份保留 config/receipts.json。

4. 恢复验收复制链接

验收通过后保留旧数据库，按备份保留策略处理。

ClickHouse复制链接

• ClickHouse 与 PostgreSQL 来自同一恢复点，或改用新的 ClickHouse 数据库（EDGEWEIR_CLICKHOUSE_DATABASE）开始写入。
• 恢复较旧的 PostgreSQL 游标而继续使用较新的 ClickHouse 表，可能与已有批次序号冲突。
• 跨存储恢复不自动完成；PostgreSQL 恢复成功不代表 ClickHouse 已恢复。

演练复制链接

node scripts/e2e-restore.mjs