跳到正文

文件夹 ​

Keepbay 管理的是您服务器上已有的文件夹。所有者在「系统设置 › 存储」中把文件夹"挂载"进来,Keepbay 读取文件、建立索引,文件原样留在原处。

本页讲挂载文件夹的设置、离线状态和忽略规则。第一次添加文件夹的步骤见首次设置。

文件在 S3 兼容的对象存储、WebDAV 或能用 SSH 登录的服务器(SFTP)上的,专业版可以直接添加,见远程文件夹。在各种网盘或者另一台 NAS 上的,先同步或挂载到本地,见云盘。

添加文件夹 ​

点「添加文件夹」,填写服务器上的绝对路径,比如 /srv/photos。路径要手动输入,没有目录浏览。

字段说明
服务器上的路径文件夹的绝对路径,添加后不能修改
显示名称显示在侧栏中,默认用文件夹名
访问方式读写,或只读
处理程度完整处理(默认)、只认文件或只建目录,见处理程度
定期补扫间隔默认 360 分钟,可以设 15 到 10080 分钟
图标显示在侧栏、面包屑和文件夹列表中,可以选图标和颜色

添加前,请先授予 keepbay 用户这个文件夹的权限,只需运行一条命令,见安装。如果没有提前授权,页面会显示填好路径的命令,可以直接复制。

路径填好后,Keepbay 会检查它所在的磁盘类型。如果是网络盘或 rclone 等 FUSE 挂载,访问方式会预先选为只读,表单中还会说明添加后读取文件内容产生的流量。哪些磁盘会这样处理,见添加时的检查;流量的估算和降低方法,见挂载的注意事项。

Keepbay 还会检查能否写入。只能读取的文件夹,访问方式会自动选为只读,路径下说明原因并给出授权命令。仍选读写时不能添加。文件夹所在的文件系统是只读挂载的(如光盘、只读挂载的网络盘),只能以只读方式添加。

以上两种情况,您已经手动选择过访问方式的,不会被更改。

以下路径不能添加:

  • 不存在或者不是文件夹
  • 和已经添加的文件夹重叠,也就是一个在另一个里面
  • 和 Keepbay 的数据目录、备份目录重叠

添加后立即开始扫描。先建立文件列表,这时就能浏览和按文件名搜索了;然后在后台识别文件、生成缩略图、提取文字,具体做哪些取决于处理程度。进度在列表中和侧栏的「更多 › 后台任务」中显示。

只读和读写 ​

以只读方式添加的文件夹,Keepbay 只读取和建立索引,不做任何写入:不能上传、移动、改名、删除,也不会在里面放回收站。

这个限制在最底层的文件访问模块中实现,即使上层代码出错,也无法写入。

如果您还在试用 Keepbay,或者文件夹中是重要资料,建议先用只读方式添加。确认效果后,在「修改设置」中改为读写。改为读写时同样会检查能否写入,不能写入时不保存,并给出授权命令。

读写的文件夹之后失去写入权限的(比如所有者或权限被改动),存储页中这个文件夹下会提示"上传、移动、删除等操作会失败",并给出授权命令。这时可以运行命令授权,也可以把文件夹改为只读。文件系统变为只读挂载的,授权无法解决,请改为只读。

处理程度 ​

每个文件夹可以选择 Keepbay 读取多少内容。添加时在表单中选择,以后在文件夹的设置中修改。本机文件夹默认完整处理,远程文件夹默认只建目录。

处理程度读取的内容能做的事
完整处理多数文件完整读取一次,生成缩略图、提取文字时可能再读取缩略图、搜索文字、AI、查找相同的文件
只认文件每个文件开头、中间、结尾各 64 KB,192 KB 以内的整份读取识别类型、查找相同的文件;没有缩略图,不提取文字
只建目录不读取按名称浏览、搜索、分享;类型按扩展名判断

挂载的网盘、按流量计费的存储,可以用后两档减少读取,见挂载的注意事项。

只认文件时,如果有大小和抽样内容都相同的另一份,Keepbay 会完整读取这几份,确认是否相同。

只建目录时,浏览器能直接显示的图片(SVG 除外)、视频、音频和 PDF,打开时读取原文件;其他文件只能下载。还没有识别的文件,不能通过加了水印的分享链接查看和下载。

改为更完整的程度后,Keepbay 在后台补做已有的文件。改为更低的程度时,已有的缩略图、文字等保留;这些已经完整处理过的文件,在 Keepbay 升级处理方式时仍可能重新读取。

子文件夹可以单独设置,这项设置只有所有者能看到。选中一个文件夹(不选时是当前所在的文件夹),在信息面板的「处理程度」一节中选「跟随上级」或三档之一。例如整个文件夹只建目录,只给照片子文件夹完整处理。文件夹的根目录没有「跟随上级」,与文件夹设置中的是同一项。

修改和移除 ​

列表中每个文件夹的菜单中,有「立即扫描」和「修改设置」。显示名称、访问方式、补扫间隔、图标都可以改,路径不能改。

拖动文件夹左侧的把手,可以调整它们在侧栏中的顺序。图标和顺序对所有成员都相同。

需要更换路径时,先移除,再用新路径添加。

移除文件夹只删除 Keepbay 中的索引,磁盘上的文件不受影响。但是文件上的标签、AI 的处理结果会随索引一起删除,重新添加后需要重新打标签。成员对这个文件夹的授权也会删除。

发现文件的变化 ​

本地磁盘上的文件变化,Keepbay 通过系统的文件监听可以立即发现,通常几秒内就会更新索引。在 NAS 文件管理、Syncthing、相册程序中做的改动同样如此。

SMB、NFS 等网络磁盘无法收到变化通知,需要依靠定期补扫,默认每 6 小时一次。网络磁盘上的文件夹,可以把补扫间隔改短一些。需要立即更新时,点「立即扫描」。

文件夹很多时,可能超过系统的文件监听上限,存储页会提示"文件夹太多,部分文件夹的变化无法立即发现"。调大上限的方法见常见问题。

离线状态 ​

Keepbay 会定期检查每个文件夹是否正常。发现异常时,把文件夹标记为离线,停止写入和清理索引,等您处理。

原因说明
找不到文件夹可能是硬盘没有连接,重新连接后自动恢复
磁盘已更换文件夹所在的磁盘和之前不同,可能是硬盘未挂载,看到的是挂载点下面的空目录
文件夹突然变空可能是硬盘未挂载
无法读取权限变了,请检查文件夹的权限
路径指向了别处路径中的符号链接被改动,为安全起见暂停使用

我们这样设计,是因为 USB 硬盘未挂载时,挂载点 /mnt/usb 仍然存在,只是一个空目录。这时如果当成"文件全部删除",就会清空索引,丢失所有标签;如果往里写入文件,硬盘挂载后,这些文件会被遮盖,无法访问。

状态为"磁盘已更换"时,把原来的硬盘重新连接,检查通过后会自动恢复。如果确实更换了新硬盘,点「确认恢复」。

状态为"文件夹突然变空"时,原来的内容重新出现并通过检查后,会自动恢复。如果确实清空了文件夹,点「确认恢复」。

文件夹离线期间,索引、标签、AI 结果都原样保留。硬盘重新连接后即可继续使用。

缺失的文件 ​

扫描时发现文件已不存在,Keepbay 不会马上删除它的记录,而是标记为缺失,30 天后才清除。

如果文件在这 30 天内重新出现,比如您把它从别处移了回来,标签等信息仍然保留。

一次扫描发现大量文件不见时,Keepbay 会暂停清理,存储页提示"上次扫描发现大量文件缺失"。确认这些文件确实已删除后,再点「确认继续清理」。

忽略规则 ​

匹配忽略规则的文件和文件夹不建立索引,不出现在列表和搜索结果中,磁盘上的文件不受影响。

内置规则始终生效,跳过各系统和 NAS 生成的杂项文件。另有四类默认跳过,可以关闭:macOS 照片图库、开发目录、其他应用的资料库、同步软件的缓存。完整清单见搜索。

所有者可以添加自己的规则:

  • 名称可以用通配符,* 匹配任意字符,? 匹配一个字符,比如 *.tmp、node_modules
  • 生效范围可以是全部文件夹,也可以是某一个文件夹

回收站 ​

存储页的「回收站」一节可以设置保留时间,见回收站和撤销。

媒体处理 ​

「系统设置 › 媒体处理」显示缩略图和预览所需的工具是否可用:

  • ffmpeg、ffprobe:视频缩略图、TS 视频的在线播放和 HEIC 照片需要,HEIC 要 7.1 及以上版本;浏览器不能播放的实况照片视频由它转换,「支持的格式」中的「实况照片的视频转码」一行显示是否可用
  • 安全限制:处理照片和视频的子进程是否被隔离。内核不支持系统调用过滤时,这里还有"照样处理照片和视频"的开关

安装或升级 ffmpeg 后,点「重新检测」,不需要重启。之前未处理的文件会自动补充处理。

处理照片和视频为什么要隔离,见隐私与安全。