零门槛本地部署开源档案管理软件 完整实操步骤全指南

前置准备

环境要求

本方案基于开源档案管理系统Papermerge，采用Docker容器化部署，无需手动配置编译环境，满足以下要求即可完成部署：

• CPU双核及以上，内存≥2G，剩余磁盘空间≥10G
• 支持Windows 10+/MacOS 10.14+/Linux全系列系统，支持本地部署或云服务器部署

安装Docker环境

不同系统直接按以下步骤操作，无额外配置：

• Windows系统：直接下载安装包，地址：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe，下载后双击运行，一路点击下一步完成安装，安装完成后打开Docker Desktop，等待程序启动完成即可。
• MacOS系统：直接下载安装包，地址：https://desktop.docker.com/mac/main/amd64/Docker.dmg，下载后拖动安装即可，打开Docker等待启动完成。
• Ubuntu/Debian系Linux系统：打开终端，直接复制执行以下命令，自动完成安装： ``` sudo apt update && sudo apt install docker.io docker-compose -y ```

正式部署步骤

1. 创建配置文件

在电脑任意位置新建一个名为open-archive的文件夹，进入文件夹后新建一个名为docker-compose.yml的文件，新手注意操作细节：Windows系统默认隐藏文件后缀，需要打开文件夹顶部的「查看」选项卡，勾选「文件扩展名」，再将新建的文本文档后缀从.txt改成.yml。

打开docker-compose.yml，将以下完整配置复制进去保存，所有参数已经调好，无需修改（如果需要改端口、管理员账号密码可以直接对应修改）： ``` version: "3.3" services: archive: image: papermerge/papermerge:2.1.2 restart: unless-stopped ports: - "8000:8000" volumes: - ./data:/app/data - ./media:/app/media environment: - DJANGO_SUPERUSER_USERNAME=admin - DJANGO_SUPERUSER_PASSWORD=admin123456 ```

2. 启动服务

Windows/Mac系统：打开刚才的open-archive文件夹，在地址栏输入cmd回车打开终端，Linux系统直接进入该文件夹打开终端。

在终端中直接复制执行以下命令： ``` docker-compose up -d ```

命令执行后会自动拉取镜像、启动服务，等待1-5分钟（根据网速决定）完成即可，不需要任何额外操作。

3. 访问系统

启动完成后，打开浏览器，根据你的部署场景输入对应地址：

• 本地部署：输入 http://localhost:8000
• 云服务器部署：输入 http://你的服务器IP:8000，同时需要在服务器防火墙后台开放8000端口

打开登录页后，输入默认管理员账号密码：账号 admin，密码 admin123456，点击登录即可进入后台开始使用。

核心功能实操配置

1. 创建档案分类

登录后点击左侧菜单栏「文档管理」，点击页面右上角「新增文件夹」，输入你的分类名称，比如「个人证件」「工作合同」「家庭票据」「项目档案」，选择父级目录后点击保存，即可完成分类创建，支持多级分类分层管理。

2. 上传档案并启用OCR

进入对应分类文件夹，点击右上角「上传」，支持上传PDF、JPG、PNG等常见扫描件和电子档案格式，上传完成后系统会自动进行OCR文字提取，自带中文识别包，提取完成后支持全文检索，扫描件也能直接搜内容。

3. 档案检索使用

需要查找档案时，直接在页面顶部的搜索框输入档案内包含的任意关键词，即可秒级匹配出对应档案，无需手动翻找分类，大幅提升查找效率。

4. 团队权限配置

如果是团队多人使用，点击左侧菜单栏「用户管理」-「新增用户」，输入用户名、密码，配置对应用户可访问的文件夹权限，保存后用户即可用自己的账号登录，仅能查看权限范围内的档案，保障数据安全。

数据备份与常见问题解决

数据备份迁移

所有档案数据和系统配置都存储在你创建的open-archive文件夹下的data和media目录中，备份时直接压缩这两个文件夹，保存到其他存储位置即可；迁移时将两个文件夹解压到新部署的对应目录，重启容器即可完成恢复，数据不会丢失。

常见卡壳问题解决

• 启动后无法访问：首先执行docker-compose ps查看容器状态，如果状态不是Up，说明端口被占用，打开docker-compose.yml，将8000:8000改成8080:8000，保存后执行docker-compose up -d重启即可；如果是云服务器部署，检查防火墙是否开放8000端口。
• OCR中文识别失败：默认镜像已经预装中文识别包，重新上传档案即可，若仍失败执行docker-compose restart重启容器即可解决。
• 忘记管理员密码：直接打开docker-compose.yml，修改DJANGO_SUPERUSER_PASSWORD对应的值为新密码，保存后执行docker-compose up -d重启，即可更新管理员密码。

本部署方案所有数据都存储在本地/自有服务器，不会上传到第三方平台，完全免费开源，可长期稳定使用，满足个人和小团队的档案管理需求。