文档目录
备份和恢复 Velotrak
更新于 2026年11月17日
备份是 PostgreSQL 的逻辑导出,放在数据目录下,保留七份。ClickHouse 的点击历史不在文件里。恢复会在你送出确认词之后,用一个事务替换行,并且不包含 master.key。
文件里有什么
备份覆盖追踪器在 PostgreSQL 里用于配置、用户、转化账本、令牌和审计日志的表。恢复时不替换 schema_migrations、license_runtime 和 outbox。ClickHouse 不在逻辑备份里。项目把它当成可以重建的点击日志副本。灾难之后,配置和已入账的转化从 PostgreSQL 回来。点击明细取决于 ClickHouse 还剩下什么,以及你能和广告平台对上的部分。
文件里有密码哈希、授权码,以及加密后的集成凭据。它不包含 master.key。该文件在数据目录里(用安装脚本时装在 /var/lib/velotrak/master.key)。没有它,已保存的凭据无法解密。把数据目录,或至少 master.key,和逻辑备份放在一起保管。备份目录是 VELOTRAK_DATA_DIR/backups/,目录权限 0700,文件权限 0600。
创建一份
进程在启动约一分钟后做一次备份,然后每小时检查,当最新文件至少有 24 小时时再写一份。保留最新的 7 份。后台的备份页和 MCP 可以立刻创建:list_backups 和 create_backup。create_backup 是管理员操作。API 密钥不能调用备份路由;带写权限的 API 密钥最多只是操作员。请使用带 backups 权限的 MCP 令牌。
恢复
POST /api/backups/restore 要求 "confirm": "RESTORE"。服务器先写一份恢复前快照,然后在一个事务里重载行,并按清单核对行数。MCP 的 restore_backup 是 explicit-only:通配写权限不会授予它,并且它和其他破坏性工具一样要确认 diff。恢复旧文件会带回那份文件里的会话代数。运维说明建议:从一次轮换过会话的升级之前的备份恢复后,重新登录或改一次密码。
如果要搬走服务器,安装页列出了要复制的目录。