Paperless-ngx
一个开源文档管理系统，将纸质文件转为可搜索的数字档案。支持自托管、OCR 识别、智能分类，帮你彻底告别纸张。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自建文档库，扫描即搜索，告别纸质文件。
核心功能
- 自动 OCR 文字识别，支持 100+ 语言
- 机器学习自动分类文档、提取标签和对应关系
- 强大全文搜索，可按日期、类型、标签等过滤
- 支持从邮件、摄像头、扫描仪自动导入
- 响应式 Web 界面，手机电脑都能用
避坑指南
- •不要在公网上直接暴露，因为文档存储为明文未加密。建议仅在内网或通过 VPN 访问,OCR 对中文支持不错但手写体识别精度一般，扫描时尽量保证清晰
适用场景
- 家庭：扫描整理发票、合同、病历、保修单，随时查找
- 自由职业/小团队：管理收据、合同、客户文件，多人协作
- 归档癖：把所有纸质书、笔记、剪报数字化，变成个人知识库
详细介绍
Paperless-ngx 是一个开源文档管理系统，能把纸质文件变成可搜索、可管理的在线档案。它自动对扫描件进行 OCR 文字识别、用机器学习分类文档，再通过一个清爽的网页界面让你随时搜索、打标签、调取任何文件。和网盘不同，它是自托管方案——所有数据存你自己服务器上，隐私安全。项目由社区驱动，是 Paperless 和 Paperless-ng 的官方继承版，团队活跃、更新频繁。支持多用户、多语言、邮件自动导入，还能和 Nextcloud、Home Assistant 等工具联动。官方提供在线 demo 可以试用。
常见问题与排障 (2)
故障排除为什么在使用llama.cpp进行嵌入时，Paperless-ngx会失败并显示“输入（681个token）过大，无法处理。请增加物理批处理大小”？
该错误是由于嵌入后端（llama.cpp）接收到的输入大于其配置的物理批处理大小（-b 512）所致。要解决此问题，请在 llama.cpp 命令中将批处理大小至少增加到 1024（例如 -b 1024）。或者，使用支持更大输入尺寸的嵌入模型。Paperless-ngx 当前将 RAG_CHUNK_SIZE 硬编码为 1024，这可能导致上下文窗口较小的模型出现此问题；未来的更新可能会允许调整此值。
故障排除为什么在 Paperless-ngx 中使用批量编辑时标签无法保存？
在ASGI环境下（如Granian）使用PostgreSQL和psycopg3运行Paperless-ngx时存在已知问题。批量修改标签操作（bulk modify_tags）会静默失败，原因在于多对多（M2M）写入操作发生在不同数据库事务中，且该事务永远不会提交。解决方法：从文档详情视图（PATCH /api/documents/{id}/）编辑标签，此操作可成功执行。或者，如果可行，切换至WSGI服务器（如Gunicorn）以避免异步/同步边界问题。请关注GitHub issue #12699以获取永久修复。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker 和 Docker Compose
步骤2：运行一键安装命令：bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
步骤3：按提示配置端口、存储路径，启动后访问 http://localhost:8000 设置管理员账号
- 步骤1：确保已安装 Docker 和 Docker Compose
- 步骤2：运行一键安装命令：bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
- 步骤3：按提示配置端口、存储路径，启动后访问 http://localhost:8000 设置管理员账号
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器并删除相关数据：docker compose down -v。如需清理持久化数据（如 /mnt/paperless 下的文件夹），手动删除对应目录即可。建议备份文档后再操作。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs