企业版档案管理系统本地部署与核心功能配置实操全指南

一、前置环境准备

以下为最低配置要求，满足即可稳定支撑50人以内团队使用，所有依赖均提供直接下载地址：

• 硬件：2核4G服务器/本地主机，存储空间≥50G，操作系统支持CentOS7.9+/Ubuntu20.04+/Windows Server2019+
• JDK11：https://adoptium.net/zh-CN/temurin/releases/?version=11
• MySQL8.0：https://dev.mysql.com/downloads/mysql/8.0.html
• Redis6.x：https://redis.io/download/
• Nginx1.20+：https://nginx.org/en/download.html
• 开源稳定版企业档案管理系统安装包：https://gitee.com/luoyeo/archives-manage/releases/download/v2.5.0/archives-enterprise-v2.5.0.tar.gz（Linux）/ https://gitee.com/luoyeo/archives-manage/releases/download/v2.5.0/archives-enterprise-v2.5.0.zip（Windows）

环境安装完成后依次执行以下命令验证：

• JDK验证：java -version，返回版本号含11即为正常
• MySQL验证：mysql -u root -p，输入密码可正常进入命令行即为正常
• Redis验证：redis-cli ping，返回PONG即为正常
• Nginx验证：nginx -v，返回版本号即为正常

二、全流程部署步骤

2.1 Linux环境部署

1. 上传安装包到服务器/opt目录，执行解压命令：

tar -zxvf archives-enterprise-v2.5.0.tar.gz -C /opt/
cd /opt/archives-enterprise

2. 初始化数据库，进入MySQL命令行执行以下语句：

create database archives_enterprise default character set utf8mb4 collate utf8mb4_general_ci;
use archives_enterprise;
source /opt/archives-enterprise/sql/init.sql;

3. 修改应用配置文件，编辑config/application.yml，完整可复制配置如下，仅需替换对应密码即可：

```yaml
server:
port: 8080
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/archives_enterprise?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: 替换为你的MySQL root密码
redis:
host: 127.0.0.1
port: 6379
password: 替换为你的Redis密码，无密码则留空
database: 0
servlet:
multipart:
max-file-size: 100MB
max-request-size: 100MB
file:
upload-path: /opt/archives-enterprise/upload/
```

4. 启动应用，执行以下命令：

mkdir -p logs
nohup java -jar archives-enterprise.jar > logs/start.log 2>&1 &

执行tail -f logs/start.log查看日志，出现Started ArchivesApplication in X seconds即为启动成功。

5. 配置Nginx反向代理，编辑nginx.conf的server块，完整配置如下：

```nginx
server {
listen 80;
server_name 替换为你的服务器IP或域名;
client_max_body_size 100M;
location / {
root /opt/archives-enterprise/dist;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
location /prod-api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```

执行nginx -t验证配置无误后，执行nginx -s reload重载配置，访问服务器IP/域名即可进入系统，默认账号密码：admin / 123456。

2.2 Windows环境简化部署

• 解压安装包到D:\archives-enterprise目录
• 修改config/application.yml的upload-path为D:\\archives-enterprise\\upload\\，替换MySQL、Redis密码
• 双击根目录下的start.bat启动服务
• Nginx配置修改root路径为D:/archives-enterprise/dist，其余配置和Linux一致

三、核心功能配置实操

3.1 档案分类与权限配置

登录后台→系统管理→档案分类→新增，必须填写唯一分类编码、分类名称、保管期限（永久/30年/10年），关联对应权限角色，比如财务档案关联财务部角色，人事档案关联HR角色。

进入系统管理→角色管理→新增角色，勾选对应操作权限（上传/下载/编辑/删除/借阅审批），涉及机密的档案分类必须勾选「操作需二次验证」选项，后续操作需验证管理员手机验证码。

进入用户管理→新增用户，绑定对应角色，普通用户默认仅拥有对应分类的查看、借阅申请权限。

3.2 借阅流程配置

进入工作流管理→流程定义→导入，选择根目录template/borrow_flow.bpmn20.xml模板，绑定对应档案分类，设置审批节点为「部门主管+档案管理员」二级审批，借阅超期时间默认设为7天，开启超期自动发送系统消息提醒。

3.3 自动识别与备份配置

如需自动识别扫描版档案内容，去百度智能云申请通用文字识别OCR接口，获取API Key和Secret Key，进入系统设置→OCR配置填写对应参数，开启上传自动识别，识别内容会自动作为档案检索关键词。

进入系统管理→备份设置，开启自动备份，备份频率设为每天凌晨2点，备份路径设为对应系统的backup目录，必须开启异地备份，配置FTP地址将备份文件同步到备用存储设备，避免数据丢失。

四、常见问题排查

• 访问页面404：检查Nginx配置的root路径是否正确，dist文件夹权限是否为755，index.html文件是否存在
• 登录提示账号密码错误：执行MySQL语句update archives_enterprise.sys_user set password='$2a$10$7JB720yubVSz442gVvXp/.rG0zT8yJfKcEaM771HcG8lJnU8aZ7zS' where user_name='admin';即可重置默认密码
• 上传大档案失败：检查application.yml的max-file-size参数，以及Nginx配置是否添加了client_max_body_size 100M
• 服务启动失败：查看logs/start.log，若提示端口占用，执行netstat -tunlp | grep 8080找到占用进程，执行kill -9 进程ID释放端口，或修改application.yml的port参数为其他可用端口