国产开源文书档案系统从零部署实操指南 信创兼容全流程落地

一、前置准备（部署前必做校验）

1. 硬件&系统要求

最低配置：2核4G内存、50G可用存储，推荐使用国产麒麟V10/统信UOS服务器版操作系统，Windows Server环境也可兼容。

2. 基础软件安装

麒麟V10/统信UOS环境下直接执行以下命令安装依赖：

```bash sudo yum install -y java-11-openjdk mysql-server redis git maven nodejs npm sudo systemctl start mysqld redis sudo systemctl enable mysqld redis ```

执行以下命令校验安装是否成功：

• JDK校验：java -version 返回11.x版本即可
• MySQL校验：mysql --version 返回8.x版本即可
• Redis校验：redis-cli -v 返回6.x版本即可

3. 安装包获取

直接执行Git命令拉取最新稳定版代码，无需手动去官网下载：

```bash git clone https://gitee.com/dangjian-anzhu/archival-manage-system.git cd archival-manage-system ```

二、系统部署实操步骤

1. 数据库初始化

登录MySQL执行以下命令创建数据库和专属账号，可直接复制执行：

```sql create database archival_system default character set utf8mb4 collate utf8mb4_general_ci; create user 'archival'@'%' identified by 'Archival@2024'; grant all privileges on archival_system. to 'archival'@'%'; flush privileges; quit; ```

执行以下命令导入初始化表结构和基础数据：

```bash mysql -u archival -pArchival@2024 archival_system < ./sql/archival_init.sql ```

2. 后端服务部署

进入后端代码目录，修改生产环境配置文件./archival-admin/src/main/resources/application-prod.yml，完整配置如下可直接复制替换：

```yaml server: port: 8080 servlet: context-path: /archival spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/archival_system?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: archival password: Archival@2024 redis: host: 127.0.0.1 port: 6379 password: '' database: 0 档案存储配置 archival: file: storage-path: /data/archival/file/ max-size: 1024MB ```

执行以下命令打包并启动后端服务：

```bash cd archival-admin mvn clean package -DskipTests mkdir -p /data/archival/file/ chmod 755 /data/archival/file/ nohup java -jar target/archival-admin.jar --spring.profiles.active=prod > /dev/null 2>&1 & ```

执行curl http://127.0.0.1:8080/archival/doc.html，返回HTML内容即代表后端启动成功。

3. 前端服务部署

进入前端代码目录，修改生产环境接口地址配置文件./archival-ui/.env.production，将IP替换为你自己的服务器公网IP：

```env VUE_APP_BASE_API = 'http://你的服务器IP:8080/archival' ```

执行以下命令打包前端代码：

```bash cd ../archival-ui npm config set registry https://registry.npmmirror.com npm install npm run build ```

安装Nginx并添加配置，执行sudo yum install -y nginx安装后，修改/etc/nginx/nginx.conf，在http块内添加以下server配置：

```nginx server { listen 80; server_name 你的服务器IP; client_max_body_size 1024M; location / { root /usr/share/nginx/html/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } location /archival/ { proxy_pass http://127.0.0.1:8080/archival/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

将打包好的dist目录移动到Nginx站点目录，重启Nginx生效：

```bash mv dist /usr/share/nginx/html/ nginx -s reload ```

三、首次登录基础配置（必做）

浏览器访问http://你的服务器IP，使用默认账号admin/默认密码123456登录，按以下顺序配置：

• 修改默认密码：进入系统管理-用户管理，找到admin用户点击修改，密码要求包含大小写字母+数字+特殊符号，长度不小于8位
• 配置档案分类：进入档案管理-分类配置，点击新增，按需求添加收文、发文、合同、人事档案等分类，每类可单独设置归档期限、借阅审批规则
• 权限配置：进入系统管理-角色管理，新增普通用户、档案管理员、审批员三类角色，分别配置对应功能权限

四、核心功能实操验证

• 档案录入：进入档案管理-档案录入，上传Word/PDF格式文书文件，系统会自动提取文号、标题、发文单位、发文时间等元数据，无需手动填写
• 全文检索：在首页搜索框输入关键词，支持按文号、标题、正文内容、时间范围检索，正常返回结果耗时不超过1秒
• 借阅审批：使用普通用户账号提交某份档案的借阅申请，选择借阅时长，管理员账号会收到审批通知，审批通过后普通用户可下载查看，到期自动回收权限
• 档案销毁：到期档案可提交销毁申请，多级审批通过后系统自动删除存储文件并生成不可篡改的销毁日志，无法恢复

五、常见问题排查

• 前端访问空白：F12打开控制台查看是否跨域，检查Nginx配置中proxy_pass的后端地址是否正确，确认8080端口已在防火墙放开：firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload
• 档案上传失败：检查存储目录权限，执行chown nginx:nginx /data/archival/file/授权，确认Nginx配置中已添加client_max_body_size 1024M参数
• 达梦数据库适配：替换pom.xml中的MySQL驱动为达梦官方驱动，数据库url改为jdbc:dm://127.0.0.1:5236/archival_system，driver-class-name改为dm.jdbc.driver.DmDriver即可，其他配置无需修改
• 服务异常退出：查看后端日志tail -100f ./archival-admin/logs/sys-info.log，确认是否为内存不足，可将启动命令调整为nohup java -Xms2g -Xmx2g -jar archival-admin.jar --spring.profiles.active=prod > /dev/null 2>&1 &分配固定内存