数据备份

Guide 数据保存在实例 SQLite 数据库中。备份含网站、分类、设置及认证信息，必须像凭据一样保护；不要上传公开仓库或 Issue。

下载一致性备份

当前后台没有“数据”菜单。管理员登录后，在同一浏览器打开自己实例的以下地址下载备份：

https://你的域名/api/db/backup

下载需要当前浏览器已登录管理员账号。生成的文件是一致性数据库备份。保存后确认文件可读、来源实例及日期，并在隔离环境验证可以恢复。

停服文件快照

也可以在维护窗口停止并确认服务退出后，保存真实数据库和当时仍存在的 -wal、-shm，同时记录权限、ownership、旧二进制和配置。自定义主题目录单独备份。

仅复制运行中的 guide.db 可能漏掉 WAL 中已提交的数据。不要在不清楚实际路径时改名或复制默认 monitor.db / guide.db；两个默认文件同时存在时必须显式指定 --db。

升级器快照

官方升级器停服后把 DB 及存在的侧文件放在数据库目录的 backups 下，旧二进制备份在其目录的 backups 下，记录真实路径。备份 root-only，不自动清理。

升级失败后整体回滚与 Hub 的备份上传恢复是两个流程。恢复文件快照时必须确认服务停止，移开失败状态及不属于快照的侧文件，恢复权限、完整快照与相匹配的二进制，再启动验证。

恢复限制

恢复会覆盖当前数据，先独立保存当前状态，确认备份对应的实例和版本。当前后台没有恢复菜单；需要恢复时，按官方恢复说明处理。

v1.2.0 备份保留独立分类、空分类和顺序。已有管理分类时会拒绝缺少分类表的旧备份，避免丢失这些信息；空实例可迁移此类旧备份。不要删除分类或网站绕过保护。

数据库结构升级后，回退需要升级前完整快照和对应旧二进制，不能假定旧程序可以读取新数据库。恢复会舍弃备份后的修改，先另存需要保留的内容。版本兼容说明见升级与回退。

备份检查清单

• 记录实际 DB 路径、实例版本、时间与自定义配置。
• 使用一致性接口或停服完整快照，不单独复制活动主文件。
• 保存独立副本，限制文件访问，防止认证信息外泄。
• 在隔离环境确认可恢复，不直接覆盖生产数据来“测试”。
• 升级前后都保存适用备份，维护结束检查登录和网站配置。