跳到正文

目录和文件 ​

本页列出 Keepbay 在服务器上、在您添加的文件夹中、在远程存储上创建的全部目录和文件,以及每一项的作用和能否手动删除。

Keepbay 创建的内容集中在以下位置:安装目录、数据目录、系统服务文件、您设置的备份目录,以及文件夹和远程存储中以 .keepbay- 开头的项。除此之外,Keepbay 不在其他位置写入。

安装目录 ​

程序安装在 /opt/keepbay 中,安装步骤见安装。

/opt/keepbay/
├── versions/                                  # 各个版本的程序
│   ├── keepbay_0.1.0-beta.5_linux_amd64/      # 上一个版本,用于回滚
│   ├── keepbay_0.1.0-beta.7_linux_amd64/      # 正在用的版本
│   ├── .download-<版本>                        # 在线更新:下载中的安装包
│   └── .staging-<版本>/                        # 在线更新:解压中的新版本
├── current -> versions/keepbay_0.1.0-beta.7_linux_amd64
├── .current-new                               # 在线更新:切换 current 时的临时链接
└── keepbay -> current/keepbay                 # 命令行使用这个路径
项目作用能否删除
versions/每个版本一个子目录,包含程序及其依赖的库。在线更新成功后,只保留新版本和上一个版本不要删除正在使用的版本和 current 指向的版本
current、keepbay指向正在使用的版本。服务文件使用 /opt/keepbay/current/keepbay,命令行使用 /opt/keepbay/keepbay,更换版本时都不用修改不能删除
.download-*、.staging-*、.current-new在线更新过程中的临时文件,更新结束后自动清理更新中断后残留的可以删除,更新进行中请勿改动

数据目录 ​

默认是 /var/lib/keepbay,首次设置时可以更改位置。目录权限 0700,只有运行服务的用户能访问。

您的文件不会长期存放在这里。远程文件夹的中转上传、解压、离线下载会在这里临时暂存。

/var/lib/keepbay/
├── keepbay.db                 # 数据库(另有 keepbay.db-wal、keepbay.db-shm)
├── secret.key                 # 加密敏感配置的密钥
├── license.cert               # 专业版的授权证书
├── keepbay.lock               # 进程锁
├── keepbay.sock               # 命令行与服务之间的控制通道
├── thumbs/                    # 缩略图和大图预览
├── avatars/                   # 用户头像
├── models/                    # 本地 AI 模型和 ONNX Runtime
├── downloads/                 # 视频离线下载的工作目录
├── stage/                     # 远程文件夹的暂存
├── tmp/                       # 临时文件
├── backups/                   # 数据库备份
├── update/                    # 在线更新的状态
└── logs/                      # 日志和崩溃信息
项目作用能否删除
keepbay.db数据库:索引、标签、设置、成员、分享链接等全部数据。全文索引和向量索引也在其中不能删除。-wal、-shm 两个文件是数据库的一部分,同样不能删除
secret.key加密 API Key、两步验证密钥、远程存储的访问密钥和密码,以及其他各种密码不能删除。备份数据库时需要另外保存,见备份和维护
license.cert专业版的授权证书,在本地验证不要删除,删除后需要重新激活专业版
keepbay.lock、keepbay.sock防止两个进程同时打开同一个数据库;命令行通过 sock 与运行中的服务通信服务运行时不能删除
thumbs/缩略图和大图预览,按哈希分两级子目录存放不要手动删除。需要释放空间或重新生成时,在「系统设置 › 维护」中操作,见缩略图
avatars/用户上传的头像删除后头像会丢失
models/下载的本地 AI 模型和 ONNX Runtime。下载中的文件在 .partial/ 中可以删除,需要时重新下载
downloads/视频网站离线下载(yt-dlp)的工作目录,每个任务一个子目录下载进行中不要删除
stage/远程文件夹的暂存,每个远程文件夹一个子目录:中转上传,以及解压、离线下载到远程文件夹的临时文件夹(其中的 .keepbay-publish 记录上传到存储后的名称)。中断后重启会继续传输运行中不要删除。移除远程文件夹时自动删除对应的子目录
tmp/临时文件:处理远程文件夹中的文件时从存储下载的副本、编辑图片的结果、远程文件夹上传的记录(S3 分片上传的 s3-parts/,WebDAV、SFTP 上传的 webdav-up/、sftp-up/)停止服务后可以删除,s3-parts/、webdav-up/、sftp-up/ 除外:它们记录存储上未完成的上传,删除后 Keepbay 无法清理存储上残留的分片或临时文件,这些内容会继续占用存储空间
backups/数据库备份。文件名以 keepbay-auto-(自动备份)、keepbay-manual-(手动备份)、pre-migrate-(升级数据库前)、before-restore-(恢复前)开头。在「备份」中设置了其他备份目录的,自动和手动备份写在那个目录中。写到一半的备份名称以 .keepbay-partial- 开头,下次备份前自动清理旧的备份可以删除,最近的建议保留
keepbay.db.restore-tmp、.secret.key-*、.license.cert-*恢复数据库、保存密钥和证书时的临时文件,完成后改为正式名称正常情况下不会留下。进程异常退出后残留的,停止服务后可以删除
update/在线更新的状态,以及更新前的数据库副本更新进行中不要删除
logs/keepbay.log 和轮换出来的旧日志,crash.log 记录崩溃信息可以删除

迁移到新设备时,把整个数据目录复制过去即可。

系统服务文件 ​

keepbay setup 安装为系统服务时,创建 /etc/systemd/system/keepbay.service,并设为开机启动(systemd 会在 /etc/systemd/system/multi-user.target.wants/ 中创建一个指向它的链接)。以当前用户安装的,对应 ~/.config/systemd/user/keepbay.service 和 ~/.config/systemd/user/default.target.wants/ 中的链接。

Keepbay 不创建系统用户,不修改 sudoers,除了上面的服务文件和链接,也不在 /etc 下写入其他文件。运行服务的 keepbay 用户由您在安装时创建,见安装。

mount:grant 给文件夹授权时只修改文件夹的权限,不创建文件,见安装。

您添加的文件夹中 ​

Keepbay 在您的文件夹中创建的项目,名称都以 .keepbay- 开头。扫描时跳过它们,Keepbay 的文件列表中也不显示。

/srv/photos/                       # 您添加的文件夹
├── .keepbay-trash/                # 回收站
│   └── <编号>/                     # 每次删除一个子目录
├── .keepbay-op-<编号>.part        # 复制中的临时文件
├── .keepbay-rename-<编号>         # 改名、移动中的临时名称
├── .keepbay-unpack-<编号>/        # 解压中的临时文件夹
└── .keepbay-dl-<编号>/            # 离线下载中的临时文件夹(BT 的数据也在其中)
项目作用能否删除
.keepbay-trash/回收站。放在您添加的文件夹的根目录,如 /srv/photos/.keepbay-trash/;文件夹中另外挂载的磁盘,回收站在那块磁盘挂载点的根目录不要手动改动。清空回收站请在 Keepbay 中操作,见回收站和撤销
.keepbay-op-*、.keepbay-rename-*复制、上传、改名、移动过程中的临时名称,完成后改为正式名称操作进行中请勿改动。操作中断后,Keepbay 下次启动时自动处理
.keepbay-unpack-*、.keepbay-dl-*解压、离线下载的临时文件夹,完成后改为正式名称任务进行中或暂停时不要删除。确认任务已经删除后,残留的可以删除

以只读方式添加的文件夹,Keepbay 不写入任何内容,以上各项都不会出现。

远程存储上 ​

远程文件夹所在的存储上,Keepbay 创建以下对象。

<存储桶>/<前缀>/(S3)或 <地址>/<文件夹>/(WebDAV、SFTP)
├── .keepbay-trash/            # 回收站
├── .keepbay-probe/<随机名称>/  # 测试连接时的临时文件,测完删除
└── .keepbay-up-<编号>          # WebDAV、SFTP 上传中的临时文件,在上传的目标文件夹中
项目作用能否删除
.keepbay-trash/远程文件夹的回收站,占用存储空间并照常计费不要在存储的控制台或其他程序中手动改动
.keepbay-probe/测试连接时写入、复制、删除的几个小文件,测完删除测试中断后残留的可以删除
.keepbay-up- 开头的文件WebDAV、SFTP 上传中的临时文件,见远程文件夹中断后残留的,Keepbay 在之后向这个存储上传时自动清理
以 / 结尾的空对象S3 上空文件夹的标记。对象存储没有实际的文件夹,用它记录空文件夹删除后空文件夹会消失

中转上传先暂存在本机的 stage/ 中,再传到存储。S3 的分片上传中断后,存储上未完成的上传由 Keepbay 自动取消。

卸载时删除什么 ​

keepbay service:uninstall 只停止服务、取消开机启动、删除服务文件。

安装目录、数据目录,以及文件夹和存储上的 .keepbay-*,都不会删除。如需彻底清理,请按安装中的步骤手动删除。