备份和维护
Keepbay 每天自动备份一次数据库,保留最近 7 份。备份、缩略图、日志和诊断信息都在「系统设置 › 维护」中。
在网页上更新 Keepbay 也在这一页,见升级。
备份内容
备份的是 Keepbay 的数据库:文件索引、标签、智能文件夹、分享链接、整理记录、设置和帐号。
您的文件本身不在备份范围内。 它们在您自己的文件夹里,Keepbay 只是建立了索引。请用 NAS 的快照、rsync 或其他备份工具备份它们。
数据库丢失时,文件不受影响,但需要重新添加文件夹、重新扫描,标签和设置也要重新设置。文件丢失时,数据库备份无法恢复文件。
数据目录中的 secret.key 也不在备份中,请另外保管一份,原因见下文。
自动备份
| 设置 | 说明 |
|---|---|
| 频率 | 每天(默认)、每周或关闭。在凌晨 3 点后进行,按服务器的时区 |
| 保留份数 | 默认 7 份,可以设 1 到 60 份。自动备份和手动备份合计,更早的自动删除 |
| 备份目录 | 留空时是数据目录下的 backups/。可以改到其他磁盘,需要填写完整路径,目录必须已经存在并且可写 |
备份目录不能放在添加给 Keepbay 的文件夹里。数据库中有全部帐号和设置,如果放在挂载的文件夹中,有权限的成员就能直接下载。
备份失败时,1 小时后重试,同时通知所有者,每天最多一条。
备份文件的名称带有日期和时间,比如 keepbay-auto-20261113-030012.db。
立即备份
在维护页点「立即备份」,或者在服务器上运行:
sudo -u keepbay /opt/keepbay/keepbay db:backup进行较大的改动之前,比如移除文件夹、批量整理,可以先手动备份一份。
备份列表
维护页列出所有备份,从新到旧排列。默认只显示最近 5 份,点击「显示全部」查看其余的。备份分四类:
- 自动:每天或每周的自动备份
- 立即备份:手动进行的备份
- 升级前:新版本需要升级数据库时,升级前自动进行的备份
- 恢复前:用备份恢复时,被替换下来的数据库
网页上不能下载备份。数据库中有全部的索引和设置,我们不希望它能从浏览器中直接下载。如有需要,请在服务器上直接复制备份目录中的文件。
恢复
恢复只能在服务器上用命令行进行,网页上不能恢复:
sudo systemctl stop keepbay
sudo -u keepbay /opt/keepbay/keepbay db:restore # 在列表中选一份备份
sudo systemctl start keepbay恢复前,现在的数据库会先保存为一份"恢复前"的备份,如果恢复有误,可以用它还原。
用旧版本的备份恢复时,启动后数据库会自动升级到当前版本。
命令的详细说明见命令行。
secret.key
AI 厂商的 API Key、通知和代理的密码、两步验证的密钥、远程存储的访问密钥和密码,在数据库中是用数据目录中的 secret.key 加密保存的。
secret.key 不放进数据库备份。这样备份文件被他人复制时,里面的 Key 和密码仍然是密文。
用备份恢复到新的服务器时,请把原来的 secret.key 一并复制过去。缺少它时:
- AI 厂商的 API Key、通知渠道和发件服务器的密码,要重新填写
- 开启了两步验证的帐号,要用恢复码登录
- 远程文件夹显示离线(认证失败),要在「系统设置 › 存储」中重新填写凭据,见远程文件夹
建议把整个数据目录一起备份和迁移,见安装。
缩略图
维护页的「缩略图」一节显示缩略图占用的空间,分两类:
| 类别 | 内容 | 生成时机 |
|---|---|---|
| 小缩略图 | 网格和列表中显示的小图 | 扫描文件夹时 |
| 预览图 | 查看照片时的大图、放大时的原图清晰度预览、转换格式的实况照片视频 | 第一次打开时 |
两者都存放在数据目录的 thumbs/ 中,删除不影响原文件。
- 清除预览图:删除所有预览图,释放空间。之后第一次打开照片时重新生成,会慢一些。
- 重新生成缩略图:在后台重新处理所有照片和视频,进度见「后台任务」。适用于缩略图显示不正确的情况。原来的缩略图在新的生成之前照常显示;预览图和不再使用的缩略图会立即删除。图片的搜索索引也会随之重新建立,文件多时需要几个小时。开启了只在空闲时段处理时,只在空闲时段进行。
浏览器可能缓存了旧的缩略图,重新生成后仍显示旧图时,请清除浏览器缓存。
日志
日志写在数据目录的 logs/keepbay.log 中,超过 5 MB 时换用新文件,保留最近 3 个旧文件。维护页显示日志文件的位置。
以系统服务运行的,也可以用 journalctl 查看:
sudo journalctl -u keepbay -f诊断信息
遇到问题需要求助时,在维护页的「诊断信息」中点「生成」,下载诊断文件,附在 GitHub 的 Issue 中,或发邮件到 support@huohuastudio.com。
诊断文件包含:版本和系统信息、依赖检测结果、设置、最近 2000 行日志、数据库检查结果、文件夹和任务的统计。
不包含 secret.key、密码、会话、API Key、授权证书和您的文件内容,日志中的令牌和密码也会被清除。
「隐藏路径、文件名和网址」默认打开,会把它们换成 [路径1] 这样的占位符。Issue 是公开的,附在 Issue 中时请保持这个选项打开。
下载前可以在页面上展开查看全部内容,确认其中没有不希望发送的信息。
数据库检查
怀疑数据库有问题时,在服务器上运行:
sudo -u keepbay /opt/keepbay/keepbay db:check数据库较大时需要几分钟。发现问题时,可以用最近一份正常的备份恢复,见命令行。