档案整理公文系统从零部署实操指南 全流程可直接落地复用

一、前置环境准备

本指南适配50人以下单位使用场景，所有依赖均提供可直接复制的执行命令，无额外冗余操作。

1. 硬件要求

• 服务器配置：2核4G云服务器，系统盘≥40G，数据盘≥100G（用于存储档案扫描件、公文附件）
• 操作系统：CentOS7.9 或 Ubuntu22.04，默认关闭SELinux
• 网络要求：开放80端口安全组规则，源地址设置为0.0.0.0/0

2. 依赖软件安装

以下为CentOS7.9系统下的安装命令，Ubuntu系统可替换为apt命令执行：

安装JDK1.8

``` yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel 验证安装成功 java -version ```

安装MySQL8.0

``` yum install -y mysql-server systemctl start mysqld systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录数据库修改密码（替换为你自己的密码，要求包含大小写字母、数字、特殊符号） mysql -u root -p ALTER USER 'root'@'localhost' IDENTIFIED BY 'Archive@2024'; 创建业务数据库 CREATE DATABASE archive_doc DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit ```

安装Redis6.x

``` yum install -y redis systemctl start redis systemctl enable redis ```

安装Nginx1.20

``` yum install -y nginx systemctl start nginx systemctl enable nginx ```

二、系统部署全流程

1. 获取系统安装包

本教程使用符合国家档案管理规范的开源档案整理公文系统，安装包可直接下载使用：

``` wget https://gitee.com/lcg0124/archives-management/releases/download/v1.0/archive_doc_v1.0.tar.gz 解压安装包 tar -zxvf archive_doc_v1.0.tar.gz ```

2. 后端服务配置启动

第一步：创建文件存储目录

``` mkdir -p /data/archive/upload chmod 777 /data/archive/upload ```

第二步：修改后端配置文件

进入解压后的backend目录，编辑application-prod.yml文件，完整配置内容如下，可直接复制替换后修改数据库密码即可：

``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/archive_doc?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai username: root password: Archive@2024 替换为你自己设置的MySQL密码 redis: host: 127.0.0.1 port: 6379 password: "" 未设置Redis密码则留空 file: upload-path: /data/archive/upload/ max-size: 1024MB ```

第三步：导入数据库脚本

``` mysql -u root -p archive_doc < /root/archive_doc_v1.0/sql/archive_doc.sql 输入MySQL密码后等待导入完成即可 ```

第四步：启动后端服务

``` nohup java -jar archive-doc-admin.jar --spring.profiles.active=prod & 查看启动日志，出现"启动成功"字样即为正常运行 tail -f nohup.out 验证后端接口正常 curl http://127.0.0.1:8080/doc.html ```

3. 前端页面部署

第一步：上传前端打包文件

``` mkdir -p /usr/share/nginx/archive cp -r /root/archive_doc_v1.0/frontend/dist /usr/share/nginx/archive/ ```

第二步：配置Nginx反向代理

新建/etc/nginx/conf.d/archive.conf文件，完整配置内容如下，替换为你自己的服务器公网IP：

``` server { listen 80; server_name 192.168.1.100; 替换为你的服务器公网IP或域名 root /usr/share/nginx/archive/dist; index index.html; client_max_body_size 1024M; 接口请求转发 location /prod-api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } 档案附件访问 location /upload/ { alias /data/archive/upload/; add_header Content-Disposition "inline"; } 前端路由适配 location / { try_files $uri $uri/ /index.html; } } ```

第三步：重启Nginx生效配置

``` nginx -t 提示success后执行重启 systemctl restart nginx ```

此时在浏览器输入服务器公网IP即可访问系统，默认管理员账号密码为：admin/123456，登录后请立即修改密码。

三、核心功能实操配置

1. 档案整理功能配置

• 创建档案分类：进入【档案管理】-【分类配置】，点击新增，输入分类名称（如人事档案、行政档案、项目档案），设置分类编码、保管期限（永久/30年/10年），保存即可，分类层级最多支持5级。
• 批量归档操作：进入【档案录入】，选择对应分类，支持批量上传PDF、Word、扫描件，系统自动识别文件标题、生成页码，支持OCR识别扫描件文字，自动填充著录字段。
• 档案元数据著录：对应上传文件填写档号、责任者、成文日期、主题词等元数据，支持批量导出《归档文件目录》，完全符合《归档文件整理规则》（DA/T 22-2015）要求。
• 权限配置：进入【系统管理】-【角色管理】，设置不同角色的档案查看、下载、编辑权限，普通用户仅能查看授权范围内的档案。

2. 公文流转功能配置

• 创建公文模板：进入【公文管理】-【模板配置】，上传单位标准公文Word模板，配置占位符如${title}${dept}${date}，后续发文时系统自动填充对应内容，无需手动调整格式。
• 配置审批流程：进入【系统管理】-【流程配置】，拖拽节点配置发文/收文流程，默认支持“拟稿→部门审核→办公室核稿→领导签发→归档”全流程，每个节点可设置审批人、可编辑字段、超时24小时自动提醒规则。
• 公文一键归档：审批完成的公文可直接点击【归档】按钮，自动同步到对应档案分类，元数据无需重复录入，自动生成归档凭证。

四、常见问题排查

• 系统无法访问：首先检查服务器安全组是否开放80端口，其次执行systemctl status nginx检查Nginx运行状态，执行ps -ef | grep java检查后端服务是否正常运行。
• 大文件上传失败：检查Nginx配置中的client_max_body_size是否设置为1024M，检查/data/archive/upload目录权限是否为777。
• 数据库连接失败：检查application-prod.yml中的数据库账号密码是否正确，执行systemctl status mysqld检查MySQL服务是否正常运行。
• OCR识别失败：检查服务器是否能访问公网，系统默认调用免费OCR接口，单文件识别不超过100页。