Paperless

Paperless-ngx 使用指南

Paperless-ngx 是一个开源且完全免费的无纸化个人/家庭/小企业文档管理系统（DMS）。它具备强大的功能，能够自动索引、识别、归档纸质或电子文档，将扫描件和 PDF 转换为可快速搜索、分类和检索的数字化档案库。

主要功能

1. 自动 OCR 识别与索引： 内置Tesseract OCR引擎，上传扫描件或图片后可自动提取文本（支持多语言），生成带有可选择文字的 PDF 文件。
2. 智能自动分类（机器学习）： 根据历史文档和学习模型，自动为你上传的文档打标签（Tags）、匹配联系人/发行方（Correspondents）和文档类型（Document Types）。
3. 全文检索与高级筛选： 支持类似于搜索引擎的全文搜索、自动补全以及按时间、标签、类型、联系人等维度的多条件筛选。
4. 自动化抓取 (Consume Folder)： 监控指定文件夹或扫描仪共享路径，新放入的 PDF/图片会立刻自动扫描并导入系统。
5. 电子邮件集成： 可直接连接你的邮箱（IMAP），自动从指定邮箱中提取发票或附件并导入系统。
6. 多用户与权限管理： 支持多账户配置、角色的细粒度权限管控与多租户隔离。

适用人群

1. 家庭与个人用户： 用于归档家庭发票、医疗单据、合同证书、保修卡、税单等日常纸质文件。
2. 小微企业与自由职业者： 替代传统的文件夹归档模式，快速管理业务进销存单据、对账单与客户合同。
3. 自建服务（Self-hosted）与隐私敏感爱好者： 拒绝将敏感财务/法律文档上传到第三方云盘，追求数据自主控权的用户。

免费与付费情况

1. 平台属性： 100% 免费且完全开源（基于GPL-3.0协议）。无论个人或商业使用均无需购买许可证，没有任何功能限制。
2. 服务成本： 软件本身没有任何官方付费方案。如果你选择自行部署（Self-Host）（如安装在本地 NAS、旧电脑或家用服务器上），费用为 $0。
3. 第三方云部署（可选）： 如果你不想自己搭建硬件，可以使用第三方云托管平台（如 Elestio 等云服务商一键托管），此时需付云服务器费用（通常在 $6 - $16/月 左右，由第三方收取而非官方）。
4. 项目主页与文档： 可以随时前往 Paperless-ngx 官方 GitHub 仓库 或 官方文档首页 查看最新动态与开发者社区支持。

如何使用

官方推荐使用 Docker Compose 进行一键部署：

1. 环境准备： 准备好已安装Docker和Docker Compose的Linux 服务器、NAS（如群晖、威联通、Unraid）或树莓派。
2. 下载示例配置： 官方提供一键脚本或基础配置文件 docker-compose.env 与 docker-compose.yml：
3. bash

# 使用官方安装脚本交互式配置
bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

1. 启动容器：bash

docker compose up -d

1. 访问与配置： 在浏览器中输入 http://<你的 IP>:8000 进入 Web UI，使用部署过程中创建的管理员账号登录即可开始使用。

注意事项

1. 磁盘空间与性能消耗： OCR 解析（尤其处理数百页大文件或高分辨率图片时）需要消耗一定的CPU和内存算力。如在低配设备（如老旧树莓派）上运行，建议限制并发 OCR 任务数。
2. 原始文件安全与备份： Paperless-ngx 默认会保留原始文件（Originals）和处理后的文件（Archive）。请务必定期备份其存储目录（Data & Media 目录）和PostgreSQL 数据库。
3. 扫描文件命名规范： 如果配合物理扫描仪使用，建议将扫描件输出格式设为PDF或高清晰度PNG/TIFF，这会显著提高OCR 识别的准确率。