2024年中小企业档案管理软件最新案例落地部署实操全指南

一、前置环境准备

本次案例采用2024年3月更新的开源档案管理系统MyArchives v2.3.1，适配中小企业纸质档案数字化、电子档案合规归档需求，所有操作可直接复用。

1.1 最低环境要求

• 服务器：CentOS7.9+/Ubuntu20.04+，2核CPU，4G内存，100G以上数据盘
• 本地设备：Windows10+/MacOS12+，主流商用扫描仪（惠普、佳能全系列兼容）

1.2 依赖安装

以下命令直接复制执行即可，全程无需手动选择配置：

Ubuntu系统执行：

``` sudo apt update && sudo apt install -y docker.io docker-compose-plugin sudo systemctl enable --now docker ```

CentOS系统执行：

``` sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce docker-compose-plugin sudo systemctl enable --now docker ```

执行完成后输入docker -v、docker compose version，返回版本号即安装成功。

二、档案系统部署实操

2.1 获取最新部署包

执行以下命令下载官方稳定版部署包：

``` wget https://gitee.com/myarchives/myarchives/releases/download/v2.3.1/myarchives-v2.3.1-docker.zip unzip myarchives-v2.3.1-docker.zip && cd myarchives-v2.3.1-docker ```

2.2 修改核心配置

执行vim docker-compose.yml打开配置文件，直接替换为以下完整配置，需修改3处内容：DB_PASSWORD替换为数据库强密码，ADMIN_PASSWORD替换为后台管理员密码，/data/myarchives替换为你服务器的实际存储路径：

``` version: '3.8' services: mysql: image: mysql:8.0 container_name: myarchives-mysql restart: always environment: MYSQL_ROOT_PASSWORD: 你设置的DB_PASSWORD MYSQL_DATABASE: myarchives volumes: - /data/myarchives/mysql:/var/lib/mysql healthcheck: test: ["CMD", "mysqladmin" ,"ping", "-h", "localhost"] timeout: 20s retries: 10 app: image: myarchives/myarchives:v2.3.1 container_name: myarchives-app restart: always ports: - "8080:80" environment: DB_HOST: mysql DB_USER: root DB_PASSWORD: 你设置的DB_PASSWORD ADMIN_PASSWORD: 你设置的ADMIN_PASSWORD volumes: - /data/myarchives/files:/app/public/storage depends_on: mysql: condition: service_healthy ```

2.3 启动服务

执行以下命令启动服务：

``` sudo docker compose up -d ```

执行sudo docker compose ps查看状态，两个服务的STATE均显示healthy即为启动成功，在浏览器输入http://你的服务器IP:8080即可访问后台，账号为admin，密码为你设置的ADMIN_PASSWORD。

三、核心业务功能配置

3.1 纸质档案数字化录入

• 登录后台后进入【档案采集】模块，选择【纸质档案扫描】，直接连接本地扫描仪即可调用，无需额外安装驱动
• 扫描分辨率设置为300DPI，扫描完成后系统自动OCR识别档案内容，自动填充档案编号、保管期限、密级字段，手写内容可手动修正
• 核对信息无误后点击【保存归档】，档案自动存入对应分类库，支持按关键词、编号、时间快速检索

3.2 电子档案自动归档配置

可对接企业OA、CRM等系统实现自动归档，无需手动上传：

• 进入【系统设置】→【API管理】，生成专属接口密钥
• 在OA系统中配置定时调用以下接口，即可自动同步新增档案：

``` curl -X POST http://你的服务器IP:8080/api/archive/auto \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 你生成的API密钥" \ -d '{"archive_type":"contract","title":"2024年XX采购合同","file_url":"https://OA系统文件地址/123.pdf","owner":"采购部"}' ```

3.3 权限分级配置

符合档案管理合规要求，所有操作留痕可查：

• 进入【权限管理】→【角色管理】，按需新增角色，通常可设置管理员、部门档案员、普通员工三类
• 给管理员配置全权限，给部门档案员配置仅本部门档案的增删改查权限，给普通员工配置仅查看、申请下载权限
• 进入【用户管理】批量导入企业员工账号，绑定对应角色即可，所有访问、修改、下载操作均可在【操作日志】模块查询导出

四、常见问题排查

4.1 无法访问后台

• 检查服务器安全组/防火墙是否开放8080端口，Ubuntu执行sudo ufw allow 8080，CentOS执行sudo firewall-cmd --add-port=8080/tcp --permanent && sudo firewall-cmd --reload
• 若服务启动失败，执行sudo docker compose logs app查看报错，常见原因为存储路径权限不足，执行sudo chmod -R 777 /data/myarchives即可解决

4.2 OCR识别准确率低

若识别非中英文字符，可下载多语言包上传即可，下载地址：https://gitee.com/myarchives/myarchives/releases/download/v2.3.1/lang-packs.zip，上传路径为【系统设置】→【OCR配置】，上传后重启服务即可生效。

4.3 自动备份配置

执行crontab -e添加定时任务，每天凌晨2点自动备份数据库：

``` 0 2 cd /root/myarchives-v2.3.1-docker && docker compose exec mysql mysqldump -u root -p你设置的DB_PASSWORD myarchives > /data/backup/myarchives_$(date +\%Y\%m\%d).sql ```

备份文件默认存储在/data/backup目录，可按需调整路径。