Papermerge文档管理系统终极部署指南：5步搞定数字化档案管理

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

Papermerge是一款开源文档管理系统，专为数字化档案（扫描文档）设计，帮助用户高效管理各类扫描文件、自动识别文本内容并实现智能分类。本文将通过5个简单步骤，带您快速部署这套强大的文档管理解决方案，让纸质文档数字化管理变得轻松简单。

📋 准备工作：部署前的环境检查

在开始部署前，请确保您的系统满足以下要求：

• 安装Docker和Docker Compose（推荐版本Docker 20.10+）
• 至少2GB可用内存和10GB磁盘空间
• 互联网连接（用于拉取镜像和依赖）

🔄 步骤1：获取项目代码

首先克隆官方仓库到本地：

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

🐳 步骤2：配置Docker环境

项目提供了完整的Docker配置文件，位于docker/目录下。主要配置文件包括：

• docker-compose.yml：定义服务组合
• app.dockerfile：应用服务构建配置
• worker.dockerfile：后台任务处理服务配置

默认配置已包含PostgreSQL数据库和Redis缓存，无需额外安装这些服务。

⚙️ 步骤3：启动服务集群

在项目根目录执行以下命令启动所有服务：

cd docker
docker-compose up -d

这个命令会自动：

1. 拉取所需的Docker镜像
2. 创建数据库和缓存服务
3. 初始化应用配置
4. 启动Web应用和后台处理服务

🔑 步骤4：创建管理员账户

服务启动后，需要创建初始管理员账户。执行以下命令：

docker-compose exec app python manage.py createsuperuser

按照提示输入用户名、邮箱和密码，完成管理员账户创建。

🌐 步骤5：访问与配置系统

打开浏览器访问 http://localhost:8000，使用刚创建的管理员账户登录系统。

首次登录后，建议完成以下配置：

1. 在设置中调整OCR语言（支持多语言文本识别）
2. 创建文档分类文件夹（如"发票"、"合同"等）
3. 设置用户权限和访问控制
4. 配置自动导入规则（可选）

📄 系统功能概览

Papermerge提供了丰富的文档管理功能：

• 智能OCR识别：自动将扫描文档转换为可搜索文本
• 文件夹分类：树形结构组织文档，支持多级分类
• 标签管理：为文档添加标签，便于快速筛选
• 全文搜索：基于内容快速定位文档
• 权限控制：细粒度的访问权限管理

🛠️ 常见问题解决

如果遇到服务启动失败，可以查看日志排查问题：

docker-compose logs app
docker-compose logs worker

默认数据存储在Docker卷中，如需备份可通过以下路径访问：

• 文档数据：docker/volumes/media/_data
• 数据库数据：docker/volumes/postgres_data/_data

📚 扩展学习

• 官方配置示例：papermerge.conf.py.example
• 环境变量配置：docker/config/app.production.py
• 更多部署选项：docker/目录下的各类配置文件

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