记一笔 paperless-ngx
内容提要
本文介绍了如何搭建 paperless-ngx 系统以管理 PDF 文档，讨论了传统文件系统的局限性，并强调了 paperless-ngx 的优势，如支持 OCR、数据库管理和文件分类。文章详细描述了安装过程，包括配置 PostgreSQL、Redis 和 Nginx，以确保文档的安全存储和高效检索。
延伸解读
传统文件系统管理PDF的痛点
文章指出，用文件夹分类PDF存在明显局限：同一文档可能关联多个事件，硬链接或符号链接有兼容性风险；下载的PDF容易堆积，最终可能被整体删除；扫描的纯图片PDF难以检索；商业OCR需上传文件，有隐私顾虑；本地存储占用大，增加备份恢复难度；PDF格式演化可能导致未来无法打开。这些痛点促使作者寻找更优方案。
paperless-ngx的配置要点与调优
安装paperless-ngx需配置PostgreSQL、Redis和Nginx。作者在FreeBSD上通过port安装，创建专用数据库和用户，启用Redis。关键配置包括：设置PAPERLESS_SECRET_KEY、URL和CSRF信任源；OCR语言设为eng+chi_sim+chi_tra；添加OCR参数忽略数字签名；增大工作超时；禁用OpenBLAS的OpenMP支持以避免CPU满载。Nginx需调整上传大小限制至256MB，并配置真实IP转发。
数据备份与ZFS实践
文章建议使用ZFS进行备份，因为paperless-ngx的数据和数据库都需保护。作者将整个jail放在一个ZFS数据集中，便于快照和恢复。同时启用了paperless_migrate_enable，以便在软件升级时自动执行数据库迁移。这种整体备份策略比单独备份数据目录更符合备份原则，能确保文档和元数据的一致性。
Q&A
paperless-ngx 系统的主要功能是什么？
paperless-ngx 系统提供了文档管理、OCR 功能、安全存储和高效检索等主要功能。
如何安装 paperless-ngx 系统？
安装 paperless-ngx 需要配置 PostgreSQL、Redis 和 Nginx，并创建专用数据库和用户。
使用 paperless-ngx 有哪些优势？
paperless-ngx 解决了传统文件系统在文件分类和检索方面的局限性，并提供了隐私保护的 OCR 功能。
在 PostgreSQL 中如何创建数据库和用户？
在 PostgreSQL 中，可以使用命令创建用户和数据库，例如：createuser paperless 和 createdb paperless -O paperless。
为什么建议使用 ZFS 进行数据备份？
建议使用 ZFS 进行数据备份是因为它可以方便地备份数据库和文档，确保数据安全性。
如何配置 Nginx 以支持大文件上传？
在 Nginx 配置中，需要调整 client_max_body_size 参数，例如设置为 256m，以支持大文件上传。
