标准版文书档案系统全流程部署实操指南 零基础可直接落地

前置准备

本次部署使用开源标准版文书档案系统，所有资源可直接复用，无需额外开发。

• 服务器要求：最低2核4G云服务器，操作系统优先选择CentOS7.9或Ubuntu22.04
• 依赖环境：JDK1.8、MySQL5.7、Redis6.x、Nginx1.20+
• 系统安装包地址：https://gitee.com/osworks/archives-system/releases/download/v2.3.0/archives-system-v2.3.0.tar.gz

第一步：基础环境部署

所有命令均在root用户下执行，普通用户需在命令前加sudo。

1.1 JDK1.8安装

执行以下命令完成安装：

```bash yum install -y java-1.8.0-openjdk-devel ```

安装完成后验证：执行java -version，返回openjdk version "1.8.0_xxx"即为成功。

1.2 MySQL5.7安装

依次执行以下命令完成安装与初始化：

```bash 配置MySQL yum源 rpm -ivh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm 禁用GPG校验 sed -i 's/gpgcheck=1/gpgcheck=0/g' /etc/yum.repos.d/mysql-community.repo 安装MySQL yum install -y mysql-community-server 启动并设置开机自启 systemctl start mysqld && systemctl enable mysqld ```

初始化数据库配置：

```bash 获取初始密码 grep 'temporary password' /var/log/mysqld.log | awk '{print $NF}' 登录MySQL，输入上一步获取的初始密码 mysql -uroot -p 修改root密码（替换为你自己的密码） ALTER USER 'root'@'localhost' IDENTIFIED BY 'Your@Mysql123'; 创建档案系统专用数据库 create database archives default character set utf8mb4 collate utf8mb4_general_ci; 退出MySQL exit; ```

1.3 Redis6.x安装

执行以下命令完成安装：

```bash yum install -y epel-release && yum install -y redis 启动并设置开机自启 systemctl start redis && systemctl enable redis ```

修改Redis配置，开启密码校验：编辑/etc/redis.conf，找到requirepass字段，修改为requirepass Your@Redis123，保存后执行systemctl restart redis重启生效。

验证：执行redis-cli -a Your@Redis123 ping，返回PONG即为成功。

1.4 Nginx安装

执行以下命令完成安装：

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

验证：执行curl localhost，返回Nginx欢迎页即为成功。

第二步：后端服务部署配置

2.1 下载并解压系统安装包

```bash cd /root wget https://gitee.com/osworks/archives-system/releases/download/v2.3.0/archives-system-v2.3.0.tar.gz tar -zxvf archives-system-v2.3.0.tar.gz ```

2.2 导入初始数据库

```bash mysql -uroot -pYour@Mysql123 archives < /root/archives-system-v2.3.0/sql/archives.sql ```

无报错返回即为导入成功。

2.3 修改后端配置文件

编辑/root/archives-system-v2.3.0/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?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Your@Mysql123 替换为你自己的MySQL密码 redis: host: 127.0.0.1 port: 6379 password: Your@Redis123 替换为你自己的Redis密码 database: 0 servlet: multipart: max-file-size: 100MB 单文件最大上传限制 max-request-size: 200MB 单次请求最大上传限制 ```

2.4 启动后端服务

```bash cd /root/archives-system-v2.3.0 创建日志目录 mkdir logs 后台启动服务 nohup java -jar archives-admin.jar > logs/out.log 2>&1 & ```

验证：执行ps -ef | grep archives-admin.jar，能查到进程即为启动成功，等待30秒后执行curl localhost:8080/doc.html，能返回接口文档页面即为运行正常。

第三步：前端服务部署配置

3.1 修改前端接口配置

编辑/root/archives-system-v2.3.0/dist/env.js，将接口地址替换为你的服务器实际地址：

```javascript window.env = { VUE_APP_BASE_API: 'http://你的服务器公网IP:8080' } ```

3.2 配置Nginx反向代理

新建/etc/nginx/conf.d/archives.conf，完整配置如下：

```nginx server { listen 80; server_name 你的服务器公网IP; root /root/archives-system-v2.3.0/dist; index index.html; client_max_body_size 100M; location / { 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; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ```

执行nginx -t验证配置正确，再执行nginx -s reload重载配置生效。

第四步：系统初始化与功能验证

4.1 系统登录

浏览器访问http://你的服务器公网IP，默认账号admin，默认密码123456，登录成功即为部署完成。

4.2 基础配置初始化

• 进入【系统管理】-【部门管理】，配置本单位及下属部门层级结构
• 进入【档案管理】-【档案配置】，配置文书档案的分类、保管期限、必填元数据字段
• 进入【系统管理】-【用户管理】，添加操作用户，分配档案录入、审核、借阅等对应权限

4.3 核心功能测试

依次完成以下测试，确保功能正常：

• 测试文书档案录入、附件上传、提交审核流程
• 测试档案检索、批量导出、借阅申请、审批流程
• 测试档案归档、销毁、统计报表生成功能

常见问题排查

• 前端页面无法访问：检查服务器防火墙是否开放80端口，执行firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload放行端口
• 后端启动失败：查看logs/out.log日志，排查MySQL、Redis连接密码是否正确，8080端口是否被其他服务占用
• 附件上传失败：检查application.yml和Nginx配置中的上传大小限制是否匹配，同时执行chmod -R 755 /root/archives-system-v2.3.0赋予目录读写权限