从零搭建企业级档案管理系统架构 保姆级落地实操全指南

一、前置环境准备

1.1 软硬件基础要求

最低配置：2核4G云服务器/本地虚拟机，操作系统选择CentOS7.9或Ubuntu22.04，依赖组件版本统一为：MySQL8.0、JDK11、Redis6.2、ElasticSearch7.17.0、MinIO最新稳定版。

1.2 环境一键安装命令（CentOS7.9适用）

执行以下命令前请切换至root权限：

``` 安装JDK11 yum install -y java-11-openjdk-devel 安装MySQL8.0 yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm yum install -y mysql-community-server systemctl start mysqld && systemctl enable mysqld 安装Redis6.2 yum install -y http://rpms.remirepo.net/enterprise/remi-release-7.rpm yum --enablerepo=remi install -y redis systemctl start redis && systemctl enable redis ```

ElasticSearch7.17.0中文分词器直接下载对应版本：https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.0/elasticsearch-analysis-ik-7.17.0.zip，解压后放入ES plugins目录重启ES即可。

二、核心架构分层部署实操

2.1 存储层配置

存储层分为三类，分别存储结构化数据、档案文件、全文检索索引：

• MySQL：存储档案元数据、用户权限、操作日志，执行以下初始化脚本建表：

```sql CREATE DATABASE IF NOT EXISTS archive_system DEFAULT CHARSET utf8mb4; USE archive_system; -- 档案分类表 CREATE TABLE archive_category (id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, parent_id BIGINT DEFAULT 0, level TINYINT DEFAULT 1, secret_level TINYINT COMMENT '涉密等级 0公开1内部2机密'); -- 档案主表 CREATE TABLE archive_main (id BIGINT AUTO_INCREMENT PRIMARY KEY, category_id BIGINT NOT NULL, title VARCHAR(200) NOT NULL, file_url VARCHAR(500) NOT NULL, file_hash VARCHAR(64) NOT NULL, secret_level TINYINT NOT NULL, create_by BIGINT NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP); -- 权限表 CREATE TABLE archive_permission (id BIGINT AUTO_INCREMENT PRIMARY KEY, user_id BIGINT NOT NULL, category_id BIGINT NOT NULL, permission_type TINYINT COMMENT '1查看2上传3修改4删除'); ```

• MinIO：存储档案原文件，执行以下docker命令一键启动：

``` docker run -d -p 9000:9000 -p 9090:9090 --name minio -v /data/minio/data:/data -e "MINIO_ROOT_USER=admin" -e "MINIO_ROOT_PASSWORD=Archive@2024" minio/minio server /data --console-address ":9090" ```

启动后访问http://服务器IP:9090即可进入管理后台，默认账号admin，密码Archive@2024。

• ElasticSearch：存储档案内容全文索引，配置elasticsearch.yml中network.host: 0.0.0.0，开启远程访问即可。

2.2 服务层开发&配置

采用SpringBoot2.7.14作为基础框架，核心pom.xml依赖如下：

```xml org.springframework.boot spring-boot-starter-web com.baomidou mybatis-plus-boot-starter 3.5.3.1 io.minio minio 8.5.7 org.elasticsearch.client elasticsearch-rest-high-level-client 7.17.0 ```

完整application.yml配置可直接复制：

```yaml spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archive_system?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8 username: root password: 你的MySQL密码 redis: host: 127.0.0.1 port: 6379 minio: endpoint: http://127.0.0.1:9000 accessKey: admin secretKey: Archive@2024 bucket: archive elasticsearch: host: 127.0.0.1 port: 9200 ```

必须新增全局拦截器，所有请求校验用户权限，对应涉密等级的档案仅允许有权限的用户访问，禁止越权。核心接口可直接基于Mybatis-Plus生成CRUD，上传接口需先校验文件哈希避免重复存储，检索接口直接调用ES全文检索接口。

2.3 应用层前端部署

采用Vue3+ElementPlus搭建前端，核心页面为档案列表、上传、检索、权限管理，执行以下命令打包：

``` npm install npm run build ```

将dist目录上传至服务器/usr/share/nginx/html目录，新增Nginx配置如下：

``` server { listen 80; server_name 你的域名/服务器IP; root /usr/share/nginx/html/dist; index index.html; location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

重启Nginx后即可通过IP/域名访问系统。

三、可用性&安全性加固实操

3.1 高可用配置

• MySQL配置1主2从同步，开启半同步复制，避免数据丢失
• MinIO至少部署4节点分布式集群，实现数据多副本容灾
• 服务层部署2个以上实例，Nginx配置轮询负载均衡，避免单点故障

3.2 安全加固

所有涉密档案文件上传时必须采用AES-256加密存储，加密密钥单独存放在配置中心，禁止硬编码在代码中。新增操作日志切面，所有档案的增删改查操作必须记录操作人、IP、时间、操作内容，保存周期不少于3年。涉密档案访问需新增二次鉴权，比如短信验证码、UKey校验，避免账号泄露导致数据泄露。

自动备份脚本可直接使用以下shell脚本，配置crontab每日凌晨2点执行：

```shell !/bin/bash mysqldump -u root -p你的MySQL密码 archive_system > /backup/archive_$(date +%Y%m%d).sql 同步备份至MinIO mc cp /backup/archive_$(date +%Y%m%d).sql minio/backup/ ```

四、上线验证 Checklist

• 单文件100MB上传耗时≤3s，下载速度≥10MB/s
• 全库100万条档案全文检索响应≤2s，准确率≥99%
• 非授权用户访问涉密档案返回403，无数据泄露风险
• 所有操作日志完整记录，可追溯到具体操作人
• 备份文件可正常恢复，数据容灾机制生效