跳到正文

隐私与安全 ​

本页说明 Keepbay 什么时候联网、发送什么、记录什么,以及在登录、文件访问、文件处理上做了哪些安全措施。

Keepbay 没有做端到端加密。文件存放在您自己的硬盘上(或者您自己选择的远程存储上)。服务端需要为文件生成缩略图、提取文字、交给 AI 分析,如果文件经过加密,这些处理都无法进行。

因此我们不使用"零知识""只有您能看到"这类表述。我们能承诺的是以下几点:

  • 数据只在您自己的服务器或 NAS 上,不经过我们;用了远程文件夹的,文件在您自己选的远程存储上
  • AI 默认在本地处理;用云端模型时,界面上写明会发送什么、发给谁,由您决定
  • 登录、下载、分享和每一次 AI 调用都有记录,您可以查看
  • 不收集任何数据,没有统计和追踪

Keepbay 什么时候联网 ​

程序里没有统计、遥测、崩溃上报。网页也不加载任何第三方的脚本、字体或图片,页面的 CSP 只允许连接自己;添加了 S3 兼容存储的远程文件夹、用浏览器直连的,会加上这些存储的地址。

Keepbay 只在以下情况主动访问外网,其中大部分需要您手动操作后才会发生:

情况连到哪里发送什么
检查更新(默认每天一次,可关闭)授权中心 huohuastudio.com产品名称、是否接收测试版
在线更新授权中心,再到它给的下载地址产品名称、安装 ID(换取下载链接)
激活专业版、自动续期授权中心授权码、安装 ID、产品名称
下载本地模型ModelScope、Hugging Face、GitHub普通的下载请求
云端 AI您添加的 AI 厂商见 AI
远程文件夹您添加的对象存储、WebDAV 服务或 SFTP 服务器列出、读写文件的请求
外部帐号登录您配置的身份提供方标准的 OIDC 流程
通知Bark 服务器、您的 SMTP 服务器通知的标题和正文
离线下载您给的网址、BT 网络、yt-dlp 访问的网站下载请求
测试代理GitHub、Hugging Face只读响应头
获取自定义的模型清单(只在用 --model-manifest 或环境变量 KEEPBAY_MODEL_MANIFEST 指定了地址时;所有者打开「AI 模型」设置时,最多每小时一次)您指定的地址普通的请求

安装 ID 是首次启动时生成的随机 UUID,不含任何硬件信息,用来让授权中心知道"这是同一台设备"。

授权证书在本地验签,平时不需要联网。开着自动续期时,到期时间或更新服务截止日的前后 7 天内,每天最多联网尝试续期一次;安装的版本超出更新服务范围时,也会每天尝试一次。

如果不希望 Keepbay 为续期联网,可以在授权页关闭自动续期。在无法联网的设备上,也可以手动导入证书,全程不联网。

其中的 HTTP 请求都使用「系统设置 › 网络」中的代理设置(默认跟随 HTTPS_PROXY 等环境变量),地址在局域网内的始终直连。

发邮件用的 SMTP 连接,和 BT 下载的部分连接(如 UDP tracker、和其他节点之间的连接),不经过这个代理,直接联网。

AI ​

AI 功能属于专业版。我们的原则是能在本地处理的,就在本地处理。

语义搜索、以图搜图、识别图片中的文字都有本地模型,下载后在您的设备上运行,不向外发送任何数据。其中按画面搜图和识别图片中的文字目前只能使用本地模型,照片不会发送到云端。

对话、语义搜索和下面几项后台功能,用不用云端模型由所有者决定。

接口地址在局域网内的(比如家里另一台机器上的 Ollama)视为本地;其余视为云端,必须使用 HTTPS。

用云端模型时,「系统设置 › AI 模型」中每项功能都写明会发送什么:

功能用云端模型时发送
AI 桌面您输入的文字和您让它查看的文件内容,详见 AI 桌面
语义搜索文件中的文字和您的搜索词
自动整理文件名、大小、日期和文件中的一段文字,以及可以放进去的文件夹的路径
AI 标签文件名、修改日期和文件中的一段文字,以及您建的标签名
日期提醒文件名和到期日附近的几句原文

后三项在后台自动处理文件,风险最高,因此多设了一道确认:选择云端模型后不会立即发送,需要所有者在「后台功能用云端模型」中逐项允许。更换厂商后需要重新允许。

语义搜索的索引也在后台建立,但没有这道确认。选择云端的文本向量模型后,文件中进入语义索引的文字会发送给厂商转换为向量,请在选择前确认,见语义搜索。

成员默认不能使用云端 AI。如果这项功能配置的是云端模型,成员在 AI 桌面提问会被拒绝,搜索时也不会返回按意思找到的结果。所有者可以在成员详情中打开。

这个开关只针对成员自己发起的调用。收件箱整理、AI 标签、日期提醒等后台处理不属于某个成员发起的调用,是否使用云端模型只取决于所有者的设置和上面的逐项允许。

每一次实际发出的 AI 调用都记在「系统设置 › AI 模型 › 调用记录」中:谁发起的、哪项功能、哪个模型、发送了哪类数据、多少字节、多少 token、产生了多少费用。不保存内容本身(调用失败时会记下厂商返回的错误说明,其中可能带有一小段内容),保留 400 天。

还可以设置每月花费上限。费用根据您填写的单价和厂商返回的 token 数估算,单价填写正确时估算才准确;多个调用同时进行时,花费可能略微超出上限。实际费用以厂商的账单为准。

日志 ​

「系统设置 › 日志」记录这些操作:

  • 登录,包括成功和失败、用的什么方式
  • 下载和打包下载
  • 创建分享链接、离线下载
  • 分享链接的访客打开、输入密码、浏览、下载

每条记录时间、用户、IP、浏览器和结果,默认保留 180 天(可改为 30 到 365 天),只有所有者能看。

浏览和预览不记录,否则浏览文件夹会产生大量记录,需要查找的记录反而难以找到。

登录时输入了不存在的用户名,也不记这个用户名,因为用户常会把密码误输入用户名框。

密钥和加密 ​

  • 登录密码:argon2id 哈希(64 MiB 内存、3 轮),数据库中没有明文
  • 会话:随机 256 位令牌,数据库只存哈希
  • 其他敏感配置:AI 厂商的 API Key、两步验证密钥、外部登录的 client_secret、远程存储的访问密钥和密码、通知渠道和代理的密码,用数据目录中的 secret.key 加密(AES-256-GCM)

secret.key 不包含在数据库备份中。这样即使备份文件被复制走,其中的 Key 和密码仍是密文。

代价是用备份恢复到新设备时,需要把 secret.key 一起复制过去,或者重新填写这些配置。远程文件夹在没有原来的 secret.key 时显示离线,重新填写凭据后恢复,见远程文件夹。

这项加密只能防止数据库单独泄露,无法应对整台服务器被攻破的情况。

登录 ​

限流和锁定 ​

同一个用户名 15 分钟内失败 5 次后,每次尝试要等的时间逐次加倍;失败 10 次锁定 15 分钟,并给这个帐号发一条通知。同一个 IP 失败 20 次也会暂停。

被锁定后可以等 15 分钟,或由所有者在成员页解除,或在服务器上运行 keepbay user:unlock。

会话 ​

会话在一段时间没有活动后失效,持续使用时一直有效。时长默认 30 天,所有者可以在「系统设置 › 通用 › 登录保持时长」中改为 7 天或 90 天,改了之后已登录的设备立即按新时长判断。

Cookie 带 HttpOnly、SameSite=Lax,经 HTTPS 访问时加 Secure。修改密码后,其他设备上的登录失效。

两步验证 ​

标准 TOTP(6 位、30 秒),用过的验证码不能再用。开启时给 10 个恢复码,每个只能用一次。

输完密码后 5 分钟内要完成第二步,最多试 5 次,失败同样计入限流。

通行密钥 ​

要求在设备上验证身份(指纹、面容或 PIN),可以不输用户名直接登录。对域名和 HTTPS 的要求见外网访问。

外部帐号登录 ​

始终使用 PKCE。OIDC 提供方(Authentik、Keycloak、Google、Microsoft 等)还会校验 ID Token 的签名、签发方、受众和有效期。GitHub 用的是 OAuth2,没有 ID Token,按 GitHub 的用户 ID 识别用户。

Keepbay 按身份提供方和其中的用户 ID 识别用户,不按邮箱自动关联已有帐号,否则他人在身份提供方修改邮箱后就能登录。

没有对应帐号时默认拒绝。所有者可以开启自动建号并限定邮箱或域名,自动建的帐号固定是成员。

外部帐号永远不能变成所有者,所有者也必须保留密码登录。这样在更换手机或身份提供方出现故障时,仍可以用密码登录。

应用密码 ​

WebDAV 客户端使用应用密码,不使用登录密码。应用密码由程序随机生成(80 位),只能用于 WebDAV,不能登录网页,也不能调用接口。

数据库中只保存应用密码的 SHA-256 摘要。每个 WebDAV 请求都要校验密码,慢哈希会拖慢客户端;随机生成的密码足够长,无法靠猜测得到。

输错应用密码与登录失败共用限流和锁定的规则。应用密码验证成功不会清零登录失败的次数,否则一直在同步的客户端会让他人可以无限次猜测登录密码。

只读的应用密码不能写入。浏览器中由其他网站发起的 WebDAV 写入请求一律拒绝,防止借用浏览器记住的密码。

敏感操作 ​

修改密码、开关两步验证、管理登录方式、新建应用密码、在网页上更新程序,都要先确认一次身份。

确认的方式是输入密码,或者 5 分钟内用外部帐号重新验证过(GitHub 不支持重新验证)。

跨站请求 ​

所有修改类请求都要带一个自定义请求头,并核对 Origin 与站点自己的地址一致,不一致时拒绝请求,提示"请求来源不正确"。

经反向代理访问时出现这个提示,通常是因为没有设置可信代理,见外网访问。

首次设置 ​

设置向导要输入启动时生成的一次性令牌,防止同一网络中的人抢先创建所有者,见首次设置。

文件访问 ​

所有对您文件的读写都经过同一个模块,它从文件夹根目录逐级打开,不跟随任何符号链接。

符号链接在界面上显示为链接,能看到它指向哪里,但不能通过它打开或进入。这样无论链接指向文件夹外部,还是指向成员无权访问的位置,都无法借此绕过限制。

以只读方式添加的文件夹在最底层拒绝所有写入,即使上层代码有错误,也无法写入。

成员只能访问所有者授权的文件夹(只读或读写)。对看不到的文件,接口一律按"不存在"返回,无法通过错误信息的差异来探测。

后台任务、撤销、恢复执行时会重新检查权限。

成员的三个开关默认都关闭,因为它们都会让数据离开这台设备:创建分享链接、使用云端 AI、离线下载。

处理不可信文件 ​

照片解码库是用 C 写的,一张精心构造的图片就可能使它出错,进而被利用。所以 Keepbay 把 JPEG、PNG、RAW 等图片的解码放在一个受限的子进程里。

主进程打开文件后,只把只读的文件描述符交给它。子进程加载 seccomp 过滤器后,不能打开任何文件、不能联网、不能执行其他程序、不能写文件;内核 7.0 及以上再叠加一层 Landlock。

即使解码器被攻破,它也无法读取数据库和密钥,也无法向外发送任何数据。

视频、HEIC 照片,以及实况照片视频和 TS 视频的转换,交给系统中的 ffmpeg 处理。ffmpeg 启动时需要加载自己的动态库,无法禁止它打开文件,因此对它的限制较宽:只能以只读方式打开文件,不能写文件、不能联网、不能创建新的进程,也不叠加 Landlock。细节见技术架构。

内核不支持 seccomp 时(部分 NAS),Keepbay 默认不在没有隔离的情况下解码照片和视频,也就不生成缩略图。

浏览器能直接显示的图片、能直接播放的视频仍然可以预览,文件也可以正常浏览和下载。

内核无法更换时,所有者可以在「系统设置 › 媒体处理」的"不支持系统调用过滤时"一节,打开「照样处理照片和视频」。打开时需要确认,之前跳过的照片和视频会重新处理。

打开后,解码仍在与主进程分开的子进程中进行,有内存和时间上限,但不再受系统调用过滤的限制。恶意文件可能利用解码器的漏洞,读取这台设备上的其他文件或联网。建议只在文件来源可信时打开。

关闭后恢复默认,新的照片和视频不再处理,已经生成的缩略图和预览图保留。

预览同样有防护措施:

  • 文件原样返回时带 Content-Security-Policy: sandbox,即使被直接打开也不能执行脚本、不能向外部网站发请求(否则 SVG 文件可以借此获知是谁在什么时间打开了它)
  • Word 文档、网页在不允许脚本的沙箱 iframe 中显示
  • 下载一律以附件方式返回

分享链接 ​

  • 链接中的令牌是随机 96 位,数据库存的是哈希,另有一份用 secret.key 加密的副本,用来在管理页中再次显示链接
  • 可以设置密码、有效期(最长 10 年)、下载次数上限和下载限速
  • 按 IP 和链接限流;尝试不存在的令牌、输错密码时,响应会逐次变慢
  • 访客打开、下载都记在日志中;同一访客 30 分钟内重复打开只记一次,12 小时内重复下载同一个文件也只记一次(也只算一次下载次数)
  • 分享带拍摄地点的照片时会提醒您:下载原图的人能看到地点
  • 加水印的链接(专业版)在服务端生成水印图,访客无法获取原图

离线下载 ​

离线下载会按用户提供的网址访问外网,主要风险是被用来访问内网,比如路由器的管理页、云服务器的元数据地址。

Keepbay 在建立连接时检查实际连接的 IP,只允许公网地址,通过跳转或 DNS 重绑定都无法绕过。BT 下载同样过滤内网地址,默认不做种。

Tailscale 的地址段(100.64.0.0/10)也在拒绝之列,离线下载无法连接您 Tailscale 网络中的设备。

诊断信息 ​

遇到问题需要求助时,可以在「系统设置 › 维护」中导出诊断信息:版本和系统、依赖检测、数据库检查、文件夹和任务队列的统计、最近的日志。导出前可以在页面上预览全部内容。

「隐藏路径、文件名和网址」默认打开,会把它们换成 [路径1] 这样的占位。

无论是否打开这个选项,secret.key、密码、会话、API Key、授权证书和您的文件内容都不会出现在诊断信息中,日志中的令牌和密码也会被清除。