Skip to main content
证据状态（2026-09-24，v0.39.7）：使用 Cloudreve 的文件为 available, lifecycle-verified。在 Ubuntu 24.04 amd64（Basement Kit，standalone）上完成的一次生命周期运行，通过了 install、init、generate、apply、setup-files、verify、backup 和 restore；恢复返回了原始字节，并通过来宾本地回环验证了激活和应用层回读。这次运行的公开支持等级发布在 stackkit.cc/compatibility。使用 Paperless-ngx 的文档为 available, not yet lifecycle-verified：目前可以在目录中选择，但还没有生命周期回执覆盖它。
文档与文件为你的家庭提供日常文件的存储与分享，另外还有一个可选的归档，用来存放你以后想要检索的文书资料。Cloudreve 是可选 files 工作负载默认的、已发布的应用。Paperless-ngx 是可选的附加组件，作为单独的 documents 工作负载运行：它摄取扫描或通过邮件收到的文书资料，运行 OCR，并同时保留可检索的文本和原始文件。

​
应用

Cloudreve

文件背后的文件存储与分享应用：选择、部署和运维。

Paperless-ngx

文档背后的文档归档：对已摄取的文书资料进行 OCR、索引和检索。现在即可选择；尚无专门的设置指南。

​
何时使用哪一个

  • 日常存储请使用 Files（Cloudreve）：工作文档、导出的照片、文件夹备份，以及向单个接收者分享链接。
  • 当你希望把扫描的信件、收据和文书资料变成可检索、带 OCR 且保留原始文件的归档时，请添加 Documents（Paperless-ngx）。
  • 两个应用各自保存独立的数据。Cloudreve 不会索引 Paperless-ngx 已归档的内容，Paperless-ngx 也不会浏览你的 Cloudreve 库。

​
先规划存储

  • 选择一个绝对路径的主数据根目录，并为你选择的两个应用留出足够的可用空间。
  • 让备份根目录与主数据分开。
  • 决定哪些客户端可以访问生成的 Files 路由。
  • Paperless-ngx 会把 OCR 文本索引和原始文件放在一起；请按归档加上它的数据库来估算存储容量，并预期它会随着每份扫描的文档而增长。
  • 在你把无法替代的文件或文书资料放进任何一个应用之前，先演练一次恢复。

​
获取应用

​
Cloudreve

  • 网页界面：在桌面或移动设备上，用任意浏览器打开生成的 Files 路由。
  • 桌面同步客户端：Cloudreve 发布了官方的 Windows 同步客户端，支持按需访问文件并集成资源管理器；它需要 Cloudreve Pro 服务器实例。
  • Cloudreve 没有官方移动应用；请在手机浏览器中使用网页界面。

​
Paperless-ngx

  • 网页界面：选择该工作负载之后，用任意浏览器打开生成的 Documents 路由。
  • 移动应用（第三方，不由 kombify 或 Paperless-ngx 项目维护）：Android 上的 Paperless Mobile，以及 iOS 上的 Swift Paperless。两者都连接到你自己的服务器地址和账户；在授予它们访问你的归档的权限之前，请先查看它们的权限。

​
设置

文件是一个很好的首个使用场景，因为 Cloudreve 的独立选择不需要密钥引用。请在 Cloudreve 页面选择、部署并验证它。当你需要归档时，把 Paperless-ngx 作为单独的 documents 工作负载选择，然后按照备份与恢复，为你运行的各个应用演练恢复生命周期。