跳到正文

远程文件夹 专业版 ​

远程文件夹让 Keepbay 直接连接 S3 兼容的对象存储、WebDAV 或 SFTP,比如 Cloudflare R2、阿里云 OSS、您自己架设的 MinIO,坚果云、Nextcloud、群晖 NAS 的 WebDAV,以及能用 SSH 登录的 NAS、VPS。

文件存放在存储上,Keepbay 只保存索引和处理结果。浏览、搜索、上传下载、分享,和本机的文件夹用法一样。

远程文件夹是专业版的功能。

如果不使用专业版,或者要接入的是网盘,可以用 rclone 把它们同步或挂载到本地,见云盘。

支持的存储 ​

S3 兼容的对象存储:

  • Amazon S3、Cloudflare R2
  • 阿里云 OSS、腾讯云 COS、七牛云
  • MinIO
  • SeaweedFS、Garage、Ceph 等其他兼容 S3 的存储,服务商选"其他兼容 S3 的存储"

WebDAV:

  • 坚果云、Nextcloud
  • 群晖 NAS(WebDAV Server 套件)
  • OpenList:国内网盘添加到 OpenList 后,可以经它的 WebDAV 接入,见云盘
  • Seafile、ownCloud、rclone serve webdav 等其他 WebDAV 服务,服务商选"其他 WebDAV 服务"

SFTP:

  • NAS、VPS 等能用 SSH 登录的服务器,包括群晖 NAS

添加 ​

在「系统设置 › 存储」中点「添加文件夹」,位置选"远程存储",再选存储种类:S3 兼容存储、WebDAV 或 SFTP。

免费版在这里只显示一句说明和解锁的入口。

S3 兼容存储 ​

字段说明
服务商选好后预填地址格式、区域和路径风格
地址存储的 S3 接口地址。自己架设的,写自己的地址,如 http://192.168.1.10:9000
区域按服务商填写,部分服务商可以从列表中选
存储桶存储桶的名称
前缀可以不填。填了只用存储桶中这个文件夹下的内容,如 photos/2024
路径风格地址写成"地址/存储桶"。自己架设的存储一般要打开
访问密钥 ID、访问密钥存储的访问密钥,权限要求见访问密钥

以下两家服务商的地址需要注意:

Cloudflare R2 的地址在 Cloudflare 后台 R2 页面的 S3 API 中,里面有您的帐户 ID。

腾讯云 COS 的存储桶名称带 APPID,如 photos-1250000000。

WebDAV ​

字段说明
服务商选好后预填地址。地址中的 {host}、{user} 要换成自己的主机和用户名
地址WebDAV 的完整地址,写到 WebDAV 的根路径
文件夹选填。填了只用地址下这个文件夹中的内容,如 照片/2024
用户名、密码WebDAV 的帐号,权限要求见帐号和密钥

各服务商的地址:

服务商地址
坚果云https://dav.jianguoyun.com/dav/
Nextcloudhttps://主机/remote.php/dav/files/用户名/
群晖 NAShttps://主机:5006/(HTTP 为 5005 端口)
OpenListhttp://主机:5244/dav/

坚果云要用网页版「账户信息 › 安全选项 › 第三方应用管理」中生成的应用密码,用登录密码无法连接。

Nextcloud 建议在「个人设置 › 安全」中生成应用密码,不使用登录密码。

群晖要先在套件中心安装并启用 WebDAV Server。OpenList 的用户要在后台有 WebDAV 读取和管理的权限。

SFTP ​

字段说明
服务器地址主机名或 IP 地址。端口不是 22 时写成"主机:端口"
文件夹选填。以 / 开头为绝对路径,如 /srv/photos;否则相对登录后的默认目录,不能含 .、..。不填为默认目录
用户名SSH 登录的用户名
密码选填。密码和私钥至少填写一项
私钥选填。粘贴私钥文件(如 ~/.ssh/id_ed25519)的全部内容,以 -----BEGIN 开头
私钥口令选填。私钥设置了口令时填写

群晖 NAS 要先在「控制面板 › 文件服务 › FTP」中启用 SFTP 服务,文件夹写共享文件夹名,如 /photo。

文件夹中的符号链接和特殊文件(如设备文件、管道)不显示,Keepbay 也不跟随其中的符号链接。所填的文件夹本身是符号链接的,可以照常添加。

首次连接时要核对服务器的主机指纹,见主机指纹。

其他设置 ​

显示名称、访问方式、补扫间隔、图标和本机的文件夹一样,见文件夹。远程文件夹的处理程度默认为只建目录,S3 兼容存储还有传输方式。

同一个存储上,位置相同或者一个包含另一个的(S3 的前缀,WebDAV、SFTP 的文件夹),不能重复添加。

测试连接 ​

填好后点「测试连接」。Keepbay 会在存储的 .keepbay-probe/ 下写入、复制、删除几个临时文件,检测这个存储支持哪些操作,结束后删除。

点添加时会再测一次,不通过就不添加。

Keepbay 依靠"目标已存在就拒绝"的写入保证上传、改名时不会覆盖其他文件:S3 是带条件的写入,WebDAV、SFTP 是不覆盖的改名。存储不支持时只能以只读方式添加,测试结果会提示"这个存储不支持安全写入"。

有的 SFTP 服务器改名时会覆盖已有的文件,也属于这种情况。

测试结果中还可能列出这个存储的一些限制,比如改名、移动要先复制再删除,或者复制文件要经本机读出再写入,速度较慢。

上传到 S3 兼容存储的单个文件最大 5 TB。存储不能保证分片上传不覆盖其他文件时,最大 5 GB,测试结果中会写明。WebDAV、SFTP 没有这项限制,以服务器自身的上限为准。

主机指纹 ​

SFTP 用主机指纹确认连接的是您自己的服务器。首次测试连接时,页面显示服务器出示的指纹,以及在服务器上查看指纹的命令,例如:

bash
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

在服务器上运行这条命令,结果与页面上的一致时,点「指纹一致,继续」。用 ssh 连接过这台服务器的,也可以对照当时提示的指纹。不一致时不要继续,否则可能连接到冒充的服务器。

之后每次连接都会核对。指纹与确认过的不同时,文件夹离线,原因为"主机指纹变了"。

如果服务器重装过系统或更换过主机密钥,在文件夹那一行点「修改密码或私钥」,核对新的指纹后接受。没有这类变动时不要接受,否则密码和文件可能交给冒充的服务器。

帐号和密钥 ​

S3 的访问密钥要有存储桶(或前缀下)的列出、读取、写入、删除权限。只有读取权限的密钥,只能以只读方式添加,测试结果会提示"访问密钥没有写入权限"。

建议在存储的控制台中为 Keepbay 单独建一个密钥,只给这个存储桶的权限。停止使用时删除这个密钥,不会影响其他程序。

WebDAV、SFTP 的帐号要能读取、写入、删除所用的文件夹。没有写入权限的帐号,只能以只读方式添加,测试结果会提示"这个帐号没有写入权限"。

WebDAV 服务商支持应用密码的,建议为 Keepbay 单独生成一个。

访问密钥、WebDAV 的用户名和密码、SFTP 的密码、私钥和口令,都用数据目录中的 secret.key 加密保存,保存后不再显示。用备份恢复到新设备时,请把 secret.key 一并迁移,见隐私与安全。缺少原来的 secret.key 时,远程文件夹显示离线,重新填写后恢复,见离线。

添加后能改的只有这些凭据:在文件夹那一行的菜单中点「修改访问密钥」(WebDAV 为「修改用户名和密码」,SFTP 为「修改密码或私钥」),整组重新填写,测试通过才保存。

服务商、地址、存储桶、前缀、文件夹、SFTP 的用户名都不能改。如需更改,请先移除,再重新添加。

移除只删除 Keepbay 中的索引,存储上的文件不受影响。和本机的文件夹一样,标签、AI 的处理结果、成员对这个文件夹的授权会一起删除,重新添加后要重新设置。

传输方式 ​

传输方式只用于 S3 兼容存储。WebDAV、SFTP 的访问要带登录凭据,无法交给浏览器直接访问,所有传输都经过 Keepbay,添加时也没有这一项。

S3 兼容存储默认是"浏览器直连":上传、下载单个文件、查看原图、播放视频和音频,都在浏览器和存储之间进行,不经过 Keepbay。

Keepbay 给浏览器的是一个有时效的签名地址,访问密钥始终只在服务器上。

部分操作无论选择哪种传输方式都经过 Keepbay,比如打包下载和文档预览,见流量走向。

直连需要满足以下条件:

  • 浏览器能访问存储的地址
  • 存储桶允许本站来源的跨域请求:方法 GET、HEAD、PUT,请求头不限,暴露 ETag
  • 用 https 打开 Keepbay 的,存储也要是 https
  • 存储在局域网地址上的,Keepbay 也要从局域网中打开。从公网打开时,浏览器无法连接这类存储,Chrome 也会阻止这类请求

跨域规则无需手动配置。添加文件夹或改为直连时,Keepbay 会尝试自动设置。

存储不支持、或者密钥没有这个权限时,页面上会说明。这时请按存储控制台的说明手动设置。

在 Keepbay 中上传、下载时如果直连失败,比如跨域规则未设置好、浏览器无法连接存储,这一次会自动改为经 Keepbay 中转,速度较慢,经过 Keepbay 的流量也更多。下载前,浏览器会先向存储读取 1 个字节,确认能连上再开始下载。

查看原图、播放视频和音频时直连失败的,也会自动经 Keepbay 再试一次。

以下情况 Keepbay 不尝试直连,直接改为中转:

  • 用 https 打开 Keepbay,存储是 http:上传、下载、查看都经过 Keepbay
  • 存储在局域网地址上,而 Keepbay 是从公网打开的,比如您在外面用手机访问,或者访客打开分享链接:下载、查看经过 Keepbay;上传仍先尝试直连,失败后改为中转

访客通过分享链接下载时,不做上面读取 1 个字节的确认。页面是 https 而存储是 http、存储在局域网而访客从公网打开,这两种情况以外,访客的浏览器无法连接存储时,下载会失败。

如果浏览器经常无法连接存储,建议在文件夹的设置中把传输方式改为"经 Keepbay 中转",所有传输都经过服务器,不再每次先尝试直连。

流量走向 ​

直连:浏览器和存储之间直接传输,不经过 Keepbay。经 Keepbay:数据经过 Keepbay 所在的服务器,占用服务器的带宽。

从存储读出的数据,不论是否经过 Keepbay,存储一般都按流量计费。

浏览器和存储之间 ​

这部分受传输方式影响。WebDAV、SFTP 没有直连,按"经 Keepbay 中转"一列。

操作选"浏览器直连"时选"经 Keepbay 中转"时本机暂存
上传直连 注 1经 Keepbay中转时
下载单个文件直连 注 2经 Keepbay—
打包下载(多选、整个文件夹)经 Keepbay经 Keepbay—
查看原图、播放视频和音频直连 注 3经 Keepbay—
预览 PDF、文本等文档经 Keepbay经 Keepbay—
查看预览图(HEIC、相机 RAW、大图)Keepbay 提供 注 4Keepbay 提供 注 4—
显示缩略图Keepbay 提供Keepbay 提供—
访客下载单个文件直连 注 5经 Keepbay—
访客在线播放视频、音频经 Keepbay经 Keepbay—

Keepbay 和存储之间 ​

这部分与传输方式无关。✓ 表示有,— 表示没有。

操作从存储读取写入存储本机暂存
浏览文件列表、搜索———
测试连接少量少量—
补扫只列出对象 注 6——
生成缩略图、提取文字、交给 AI✓ 注 7—临时文件
查找相同的文件✓ 注 8—确认重复时
编辑图片、批量加水印✓✓临时文件
同一个远程文件夹中复制、改名、移动、移入回收站、恢复存储内部完成 注 9存储内部完成读出再写入时
跨文件夹复制、移动 注 10来源是远程时目标是远程时目标是远程时
解压到远程文件夹压缩包在远程时✓✓
离线下载到远程文件夹—✓✓
立即删除、清空回收站—只发删除请求—
撤销、重做注 11注 11注 11

注释 ​

  1. 直连不通时(跨域规则没设好、浏览器无法连接存储),自动改为经 Keepbay 中转。上传时遇到重名、选了替换的,也经 Keepbay 中转。
  2. 下载前先读取 1 个字节确认能连上存储,连不上时这一次经 Keepbay 中转。页面是 https、存储是 http,或者存储在局域网而从公网打开 Keepbay 时,直接经 Keepbay。
  3. 直连失败时,自动经 Keepbay 再试一次。TS 视频不能在线播放,只能下载,见TS 视频。
  4. 第一次查看时从存储读取原文件,生成的预览图保存在 Keepbay 上,之后直接由 Keepbay 提供。
  5. 分享设了限速或水印,页面是 https、存储是 http,或者存储在局域网而访客从公网打开时,经 Keepbay。其他情况下访客的浏览器无法连接存储时,下载会失败,不会自动改为中转。加了水印的图片,访客下载的是 Keepbay 生成的版本。
  6. 只列出存储桶(或前缀)中的对象、WebDAV 和 SFTP 文件夹中的内容,不下载文件,存储按请求次数计费。
  7. 处理程度为完整处理时才有。文件下载到本机的临时文件,处理完删除;缩略图和提取的文字保存在 Keepbay 上。
  8. 处理程度为完整处理或只认文件时才有,各档读取的内容见文件夹。发现可能相同时,把文件完整下载到本机的临时文件中核对,超过 2 GB 的不核对。
  9. S3 由存储在内部复制,再删除原对象;WebDAV、SFTP 的改名、移动、移入回收站、恢复是存储上的一次改名。数据都不经过 Keepbay。存储不能安全地在内部复制的(包括 SFTP 上的复制),以及 S3 上单个文件超过 5 GB 的,经 Keepbay 读出再写入,要在本机暂存。收件箱整理到远程文件夹也算移动。
  10. 本机文件夹和远程文件夹之间、两个远程文件夹之间。同一个存储桶中不同前缀的两个远程文件夹,也算两个文件夹。目标是远程文件夹的,先在本机暂存,完整后再上传。
  11. 按实际执行的操作计算。撤销改名、同一个远程文件夹中的移动,是在存储内部再移动一次。撤销跨文件夹的移动,是从来源的回收站中恢复原文件,再把目标处的副本移入回收站,不会重新传输文件。

处理程度 ​

远程文件夹默认「只建目录」,只记录名称、大小和修改时间,不读取内容。

改为「完整处理」后,Keepbay 才会生成缩略图、提取文字、交给 AI、查找相同的文件。添加时可以选择,以后在文件夹的设置中也能改,子文件夹可以单独设置。三档的区别和设置方法见文件夹。

读取内容要从存储下载,会产生流量费。

完整处理时,生成缩略图、提取文字要下载整个文件,超过 2 GB 的文件不做这些处理。只认文件只读取每个文件的几段,流量较少。

只建目录时后台不读取,但打开、下载文件时照常从存储读取。

编辑图片要先改为完整处理。批量加水印只需要识别出文件类型,只认文件即可。

费用 ​

存储按空间、流量、请求次数计费的,Keepbay 的读写同样会计费。使用前请确认存储的计费标准。

删除的文件放在存储上的回收站 .keepbay-trash/ 中,占用空间,照常计费。回收站的保留时间见回收站和撤销。

S3 不支持直接改名。移入回收站、恢复、改名、移动,在存储上都是先复制再删除原对象,在后台进行。大文件夹耗时较长,也会产生请求费。改名、移动、移入回收站、立即删除一次涉及 1 万个及以上的对象时,Keepbay 会先请您确认。

WebDAV、SFTP 能直接改名,这些操作在存储上一次改名完成,文件夹再大也很快。

完整处理、只认文件会多一笔下载流量,见处理程度。每种操作的流量怎么走,见流量走向。

后台操作 ​

远程文件夹中的改名、移入回收站、恢复、撤销、重做在后台进行,进度显示在右下角的传输面板中,按"已移 x / 共 y 个文件"显示,结束时提示结果。

移入回收站、恢复可以取消还没开始的项。改名、撤销、重做不能取消,文件夹开始移动后不会中途停下。

本机空间 ​

解压、离线下载到远程文件夹时,文件先暂存在 Keepbay 的数据目录中,完成后再上传到存储。经 Keepbay 中转的上传(WebDAV、SFTP 的上传都是)、存储内部不能直接复制的复制和移动,也一样要在本机暂存。S3 浏览器直连的上传直接传到存储,不占本机空间。

WebDAV、SFTP 上传时先写到同一个文件夹中 .keepbay-up- 开头的临时名称,完成后改为正式名称。目标已存在时不覆盖。中断后留下的临时文件,Keepbay 会在之后向这个存储上传时自动清理。

完整处理时,生成缩略图、提取文字也要先把文件下载到本机的临时文件中,处理完删除。只认文件时,确认重复的文件同样要下载。

因此数据目录所在的磁盘需要预留足够的空间。例如向远程文件夹离线下载一部 50 GB 的电影,本机需要有 50 GB 的可用空间。

传输中断后会继续:已经传完的文件保留,没有传完的文件重新上传。取消时,已上传的文件保留在存储上。

发现变化 ​

远程存储没有变化通知。在 Keepbay 之外的改动,比如用存储的控制台或其他程序上传的文件,靠定期补扫发现。

远程文件夹的补扫间隔默认 60 分钟,最短 15 分钟。需要立即发现变化时,点「立即扫描」。

每次补扫都要列出存储桶(或前缀)中的全部对象,或者 WebDAV、SFTP 文件夹及其子文件夹中的全部内容。按请求次数计费的存储,不建议把间隔设得太短。

离线 ​

无法连接存储、认证失败、存储位置不存在(存储桶或文件夹被删除或改名)、SFTP 服务器的主机指纹变了时,文件夹显示离线和原因。

索引、标签、AI 结果都保留。存储恢复后,Keepbay 自动重新连接并补扫。

认证失败有两种情况:存储拒绝了访问(访问密钥、密码或私钥已被删除、过期、修改,或没有读取权限),或者 Keepbay 无法解密保存的凭据(secret.key 丢失或更换过)。两种情况都在文件夹那一行的菜单中重新填写凭据后恢复,入口的名称见帐号和密钥。

文件夹离线期间不能修改其中的内容,见只读和离线的文件夹。

专业版到期后 ​

专业版到期或者试用结束后,远程文件夹变为只读:可以浏览、搜索、下载,不能上传、改名、删除,见只读和离线的文件夹。

数据和索引都保留,重新激活后恢复。

这期间不能添加新的远程文件夹。