Papermerge 扫描文档归档部署指南:30 分钟跑通 OCR 全文搜索 📅 发布时间:2026/8/22 13:21:11 👁 浏览次数: Papermerge 扫描文档归档部署指南30 分钟跑通 OCR 全文搜索【免费下载链接】papermergeOpen Source Document Management System for Digital Archives (Scanned Documents)项目地址: https://gitcode.com/gh_mirrors/pa/papermergePapermerge 是一款为扫描文档设计的开源文档管理系统DMS它用 OCR 从 PDF、TIFF、JPEG、PNG 中提取文字并建立索引让你在搜索框里直接命中文档正文。系统以 Web 服务形式运行界面是接近桌面文件管理器的双面板浏览器。照这份指南操作你可以用 Docker 完成部署并在 30 分钟内完成第一次上传与搜索。 Papermerge 适合管什么它的主要用途是数字档案的长期存储。和把扫描 PDF 堆在文件夹里相比Papermerge 多做了几件事全文搜索OCR 提取的文本被索引可跨整个档案库检索双面板文档浏览器支持拖放操作习惯接近桌面文件管理器层级文件夹、彩色标签、文档类型以及按类型自定义的元数据字段页面管理删除、重排、拆分和提取 PDF 中的单个页面。 部署前检查清单项目要求说明Docker Docker Compose20.10 及以上承载应用、数据库和队列端口8000 空闲Web 服务监听 8000内存建议 4GBOCR 过程较吃内存磁盘预留 10GB文档库随时间增长文件格式PDF / TIFF / JPEG / PNG这四种是支持范围拉取代码并查看部署配置克隆仓库并进入目录git clone https://gitcode.com/gh_mirrors/pa/papermerge cd papermerge部署由仓库里的 docker/docker-compose.yml 定义共四个服务appWeb 服务镜像eugenci/papermerge:2.0.0把宿主机 8000 端口映射进来dbPostgres 12.3存文档元数据redis任务队列的中间件worker后台处理程序eugenci/papermerge-worker:v2.0.0异步执行 OCR 和索引。数据库账号密码在 compose 文件中已固定dbuser/dbpass应用通过容器网络访问db服务你不需要额外改任何凭据。启动容器栈在仓库根目录执行一键启动docker compose up -d首次运行会先拉取镜像随后 app 容器内的 启动脚本 自动完成数据库迁移、静态文件收集并创建初始管理员账号。确认服务状态docker compose ps预期结果四个容器均为 runningapp 容器对外监听 8000。 首次登录管理界面浏览器打开http://localhost:8000用预置账号登录用户名admin密码admin。该账号由 建用户脚本 创建具备超级用户权限登录后第一件事就是改密码。接着在偏好设置里确认两点OCR 语言可选列表写在 papermerge.config.py 里德、英、西、法、俄、罗马尼亚语默认是德语改成你文档实际使用的语言否则识别准确率会掉文件夹结构建议按年份或按文档类别合同、发票、报告先建一层。上传第一篇文档并搜索在上传入口拖入一份扫描版 PDF。想直接找测试文件仓库的 example_data/ 目录里有现成的样例扫描件上传后 worker 容器在后台执行 OCR 并入库。稍等片刻在搜索框输入文档正文里的任意词组——比如一个编号或金额——系统会返回命中的文档和页码。看到这条结果你的档案库就算跑通了。 踩坑排查页面打不开先用curl -I localhost:8000确认端口再改 docker-compose.yml 中8000:8000冒号左侧的宿主机端口避开冲突。app 容器反复重启执行docker compose logs app看日志多数情况是 db、redis 尚未就绪等待片刻后docker compose restart app即可。搜不到内容核对 OCR 语言是否与文档一致并确认 worker 容器在运行——识别发生在 worker 里而不是 Web 容器。大文件上传被拒Web 服务对单次上传限制 20MB见 app.startup.sh 中的--limit-request-body参数超限文件需拆分。接下来做什么跑通之后按这个顺序推进修改 admin 密码并启用多用户用标签和文档类型做第二层分类再接入扫描仪或邮箱导入最后用 OpenAPI 兼容的 REST API 对接你的业务系统。更完整的配置项与部署方式见项目主页上的官方文档。【免费下载链接】papermergeOpen Source Document Management System for Digital Archives (Scanned Documents)项目地址: https://gitcode.com/gh_mirrors/pa/papermerge创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考