Paperless-ngx 文档管理系统

项目简介

Paperless-ngx 是一个社区共同维护的开源文档管理系统（DMS），目标是把你手中的纸质文件变成可搜索的在线档案库，真正做到「少一点纸」。它是原 Paperless 与 Paperless-ng 项目的官方继任者，由多个团队分工推进前端、CI/CD 与文档等工作。

核心能力

• 扫描与归档：将扫描件、PDF、图片统一纳入文档库管理。
• OCR 识别：对文档做光学字符识别，生成可检索的文本内容。
• 全文检索：按内容、标题、标签、通信方、文档类型等维度快速定位。
• 自动整理：通过匹配规则自动打标签、分配通信方与文档类型。
• AI 辅助：结合机器学习与 LLM 能力辅助分类与信息提取。
• 多语言界面：通过 Crowdin 社区协作完成多语言翻译。

技术栈

后端基于 Python / Django，前端使用 Angular，整体以容器化方式分发。项目在 GitHub 上提供 CI、代码覆盖率与文档构建状态徽章，工程化程度较高。

快速开始

官方推荐使用 docker compose 部署，仓库的 docker/compose 目录已配置好从 GitHub Container Registry 拉取镜像。也可以使用官方安装脚本初始化环境：

bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

更多安装方式与从 Paperless-ng 迁移的步骤，可参考官方文档 docs.paperless-ngx.com。官方还提供在线 Demo（登录 demo / demo），便于先体验再部署。

使用注意

文档扫描件往往包含社保号、税务记录、发票等敏感信息，而 Paperless-ngx 以明文存储、不做加密。不要将其部署在不可信的主机上，最安全的做法是在家庭本地服务器运行并做好备份。

社区与贡献

项目欢迎 Bug 修复、功能增强与界面改进。较大的改动建议先在 GitHub Discussions 发起讨论；功能建议与问题反馈也分别通过 Discussions 和 Issues 渠道处理。