3 条命令搞定 Papermerge 部署：让扫描件也能全文搜索

3 条命令搞定 Papermerge 部署：让扫描件也能全文搜索

【免费下载链接】papermergeOpen Source Document Management System for Digital Archives (Scanned Documents)项目地址: https://gitcode.com/gh_mirrors/pa/papermerge

扫描的合同、发票、银行对账单散落在网盘和 U 盘里，要找的时候翻不到，翻到了也搜不到内容。Papermerge 部署就是为了解决这件事：把扫描件丢进去，它自动做 OCR 提取文字并建好索引，之后直接按关键词搜文档。Papermerge 文档管理系统安装完，浏览器里就能用，个人存档、小团队协作都合适。下面带你从一台干净的机器走到"可搜索的档案库"，全程跟着做就行。

🧾 环境自检：一张表确认机器够不够

开干之前对照下表，全部满足就可以开始。

🐳 最简部署路径：3 条命令跑通 Papermerge Docker 搭建

git clone https://gitcode.com/gh_mirrors/pa/papermerge cd papermerge/docker

这步把项目拉到本地并进入 Docker 目录，目录里能看到 docker-compose.yml 就成功了。

docker-compose up -d

这步一次性拉起主应用、PostgreSQL 数据库、Redis、后台 worker 四个容器。首次启动要拉镜像、初始化数据库，请耐心等几分钟；浏览器打开 http://localhost:8000 能看到登录页，就是成功了。

登录后的第一件事：先把默认密码换掉

启动脚本会自动创建一个超级用户：用户名 admin，密码 admin。登录成功后立刻从右上角用户菜单进 Preferences 修改密码，别把这对默认组合留在正式环境里。

主界面分三块：左边是文件夹树，中间是文档网格，顶部是全功能搜索框；点任意文档，右侧显示页面预览和元数据面板（标签、类型、自定义字段）。

从这张图能看到：左侧的文件夹与文档网格、中间的扫描页预览，以及右侧标签、文档类型等元数据字段。

🩹 踩坑速查：三行看懂常见故障

页面打不开，connection refused症状：浏览器打开 localhost:8000 提示"连接被拒绝" 排查：docker-compose logs -f常见原因：首次启动要拉镜像、初始化数据库，应用容器往往最后就绪，等一分钟再刷新

传完文档却搜不到症状：上传完成，全文搜索没有结果 排查：docker-compose ps常见原因：worker 容器没有 Up，OCR 和索引都由它完成

OCR 出来的文字是乱码症状：搜索命中的内容缺字、错词 排查：docker-compose logs worker常见原因：默认 OCR 语言是德语，下一节改一下配置

按你的习惯做微调：改 OCR 语言、改端口

只挑两个最实用的项，都是改一行配置再重启容器的事。

Papermerge OCR 语言怎么改

改哪里：docker/config/papermerge.config.py，改成：

OCR_DEFAULT_LANGUAGE = "eng" OCR_LANGUAGES = {"eng": "English"}

→ 效果：上传后 OCR 默认按英语识别。系统默认是德语（deu），扫描件以英文为主的话记得改。

这就是它要处理的扫描件：一张银行对账单。入库后，你可以直接按里面的关键词搜索。

改端口只需一行

改哪里：docker/docker-compose.yml里的 ports，把 "8000:8000" 改成 "8080:8000"。 → 效果：浏览器地址变成 http://localhost:8080，8000 被别的服务占用时用它。

🧭 下一步去哪玩

• 官方文档：搜 "Papermerge 官方文档"，覆盖 OCR、自动化、多用户等完整功能
• 源码关键目录：docker/是部署与容器配置，config/settings/是 Django 设置，example_data/有德、英、西三语示例扫描件
• issue 与社区：项目仓库的 issue 区，是报 bug、提问的主阵地

现在就把它跑起来，把手头的扫描件丢进去试试。

【免费下载链接】papermergeOpen Source Document Management System for Digital Archives (Scanned Documents)项目地址: https://gitcode.com/gh_mirrors/pa/papermerge