> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 文档与文件

> 用 Cloudreve 存储和分享你的文件，并用可选的 Paperless-ngx 附加组件归档文书资料

<Info>
  证据状态（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](https://stackkit.cc/compatibility)。使用 Paperless-ngx 的文档为 `available, not yet lifecycle-verified`：目前可以在目录中选择，但还没有生命周期回执覆盖它。
</Info>

文档与文件为你的家庭提供日常文件的存储与分享，另外还有一个可选的归档，用来存放你以后想要检索的文书资料。Cloudreve 是可选 `files` 工作负载默认的、已发布的应用。Paperless-ngx 是可选的附加组件，作为单独的 `documents` 工作负载运行：它摄取扫描或通过邮件收到的文书资料，运行 OCR，并同时保留可检索的文本和原始文件。

## 应用

<CardGroup cols={2}>
  <Card title="Cloudreve" icon="folder-cloud" href="/zh-Hans/stackkits/apps/cloudreve">
    文件背后的文件存储与分享应用：选择、部署和运维。
  </Card>

  <Card title="Paperless-ngx" icon="file-contract" href="/zh-Hans/stackkits/reference/use-case-catalog#文档">
    文档背后的文档归档：对已摄取的文书资料进行 OCR、索引和检索。现在即可选择；尚无专门的设置指南。
  </Card>
</CardGroup>

## 何时使用哪一个

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

## 先规划存储

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

## 获取应用

### Cloudreve

* **网页界面**：在桌面或移动设备上，用任意浏览器打开生成的 Files 路由。
* **桌面同步客户端**：Cloudreve 发布了[官方的 Windows 同步客户端](https://docs.cloudreve.org/en/usage/desktop-client)，支持按需访问文件并集成资源管理器；它需要 Cloudreve Pro 服务器实例。
* Cloudreve 没有官方移动应用；请在手机浏览器中使用网页界面。

### Paperless-ngx

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

## 设置

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.