前期环境准备
基础要求
本次搭建使用开源轻量化方案,零开发基础就能完成,仅需要满足以下条件:
- 一台2核4G以上配置的云服务器,系统选择Ubuntu 22.04 LTS;
- 服务器开放端口权限,后续需要放行8000端口(可自定义修改)。
一键安装Docker环境
使用Docker部署可以避免环境配置出错,登录服务器后依次执行以下命令即可完成安装:
```
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
```
执行完成后输入docker --version && docker-compose --version,输出版本号即说明安装成功。
部署配置档案管理系统
编写部署配置文件
先创建部署目录,执行以下命令:
```
mkdir -p ~/paperless && cd ~/paperless
```
然后执行nano docker-compose.yml创建配置文件,将以下完整内容复制进去,按注释标注修改3处自定义信息:
```
version: "3.8"
services:
paperless:
image: ghcr.io/paperless-ngx/paperless-ngx:latest
restart: unless-stopped
ports:
- "8000:8000"
environment:
- PAPERLESS_REDIS=redis://broker:6379
- PAPERLESS_DBHOST=db
- PAPERLESS_DBNAME=paperless
- PAPERLESS_DBUSER=paperless
- PAPERLESS_DBPASS=YOUR_DB_PASSWORD 替换为自定义数据库密码
- PAPERLESS_SECRET_KEY=YOUR_SECRET_KEY 替换为随机16位字母数字字符串
- PAPERLESS_URL=http://你的服务器IP:8000 替换为你的实际访问地址
volumes:
- ./data:/usr/src/paperless/data
- ./media:/usr/src/paperless/media
- ./export:/usr/src/paperless/export
- ./consume:/usr/src/paperless/consume
db:
image: docker.io/library/postgres:15
restart: unless-stopped
volumes:
- ./postgres:/var/lib/postgresql/data
environment:
- POSTGRES_DB=paperless
- POSTGRES_USER=paperless
- POSTGRES_PASSWORD=YOUR_DB_PASSWORD 需要和上方的数据库密码一致
broker:
image: docker.io/library/redis:7
restart: unless-stopped
volumes:
- ./redis:/data
```
修改完成后,按Ctrl+O保存文件,再按Ctrl+X退出编辑器即可。
启动系统创建管理员账号
执行以下命令后台启动系统:
```
docker-compose up -d
```

等待1-5分钟拉取镜像完成后,执行以下命令创建系统管理员账号:
```
docker-compose run --rm paperless createsuperuser
```
按提示依次输入用户名、邮箱、密码,输入密码时不会显示字符,输入完成直接回车即可。
完成后,在浏览器输入http://你的服务器IP:8000,用刚创建的账号登录即可进入系统。
核心配置优化检索效率
要通过档案管理提升决策效率,核心是能快速找到需要的决策依据,完成以下配置即可实现秒级检索:
开启中文OCR全文检索
登录系统后,依次点击设置 > 应用设置 > 文档处理,找到OCR语言选项,将值修改为chi_sim eng,保存设置即可,系统会自动对所有上传的档案做中文文字识别,支持全文关键词检索。
配置分类归档规则
提前做好分类可以大幅提升筛选效率,按以下步骤操作:
- 点击管理 > 文档类型,点击添加,按业务属性创建分类,例如:项目立项档案、财务审计档案、会议纪要档案;
- 点击管理 > 标签,创建跨分类的维度标签,例如:2023年度、A项目、应急项目,支持多标签组合筛选;
- 点击管理 > 存储路径,设置自动归档规则为
{created_year}/{document_type}/{correspondent},系统会自动按规则分类存储。
导入使用与常见问题
批量导入已有档案
- 少量档案上传:点击左上角上传按钮,批量选择本地文件,一次最多支持100份,系统自动识别归档;
- 大量档案批量导入:将所有档案上传到服务器的
~/paperless/consume目录,系统会自动扫描导入,适合百份以上档案批量导入。
日常快速获取决策资料
需要调取档案支撑决策时,仅需要两步:
- 在顶部搜索框输入关键词,系统秒出所有匹配结果,还可以通过文档类型、标签、创建时间筛选范围;
- 找到目标档案后,可以直接查看内容、下载原文件,也可以一键分享给参与决策的成员,不用反复传输文件。
常见卡壳问题解决
- 无法访问系统:检查云服务器安全组,是否放行你设置的端口(默认8000),添加入口TCP规则即可;如果端口被占用,修改docker-compose.yml的端口配置后重启即可;
- 中文OCR识别失败:确认OCR语言配置正确,执行
docker-compose restart重启系统即可解决;
- 启动失败:执行
docker-compose logs查看报错,绝大多数是配置中两个数据库密码不一致导致,修改后重启即可。
整个搭建过程全程仅需15分钟左右,不需要任何开发基础,所有配置和命令都可以直接复制使用。搭建完成后,所有档案统一存储、可秒级检索,做决策时不需要花费几小时找资料,能够快速获取完整的历史决策依据,直接提升决策效率。