盐城档案管理系统本地化部署与核心功能配置实操全指南

一、前期准备工作

1.1 硬件与环境要求

服务器最低配置:2核4G内存、50G以上SSD硬盘,操作系统选择CentOS7.9或Ubuntu22.04,需开放端口80(公网)、443(公网)、3306(仅内网)。

1.2 软件依赖清单

需提前安装以下固定版本依赖:JDK1.8、MySQL8.0、Redis6.2、Nginx1.24,所有安装命令均针对CentOS7.9环境,Ubuntu环境可对应替换apt命令。

1.3 安装包获取

官方开源稳定版安装包下载地址:https://mirrors.ycdagov.cn/archive-system/archive-v2.3.1.tar.gz,sha256校验码:7a8f9d2e4c6b1a0f3d8c7e9b0a1d2c3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c,下载后可执行sha256sum archive-v2.3.1.tar.gz校验完整性。

二、部署实操步骤

2.1 基础环境安装配置

JDK安装:执行以下命令直接安装,验证输出openjdk version "1.8.0_382"即为成功。

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

MySQL8.0安装:依次执行以下命令完成数据库初始化,数据库密码需严格按照规则配置,避免后续连接报错。

``` 配置MySQL源 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm 安装并启动 yum install -y mysql-community-server systemctl start mysqld systemctl enable mysqld 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL(替换为查询到的初始密码) mysql -uroot -p你查询到的初始密码 执行SQL配置 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Archive@2024_yc'; CREATE DATABASE archive_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'archive_user'@'%' IDENTIFIED BY 'Archive_User@2024'; GRANT ALL PRIVILEGES ON archive_system. TO 'archive_user'@'%'; FLUSH PRIVILEGES; exit; ```

Redis安装配置:执行以下命令完成安装,设置密码后重启生效。

``` yum install -y redis6 systemctl start redis systemctl enable redis 修改配置文件添加密码 sed -i 's/ requirepass foobared/requirepass Redis@Archive2024/g' /etc/redis.conf systemctl restart redis ```

Nginx安装:执行以下命令完成安装,后续用于反向代理。

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

2.2 系统包部署与配置

首先解压安装包到指定目录:

``` tar -zxvf archive-v2.3.1.tar.gz -C /opt/ cd /opt/archive-system ```

创建档案存储目录并授权:

``` mkdir -p /opt/archive-data chmod 755 /opt/archive-data ```

修改配置文件application.yml,直接复制以下完整配置即可,无需额外修改:

```yaml server: port: 8080 servlet: context-path: /archive spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/archive_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: Archive_User@2024 redis: host: 127.0.0.1 port: 6379 password: Redis@Archive2024 database: 0 servlet: multipart: max-file-size: 100MB max-request-size: 100MB 盐城档案专属配置 archive: area-code: 320900 盐城行政区划代码 storage-path: /opt/archive-data/ 档案存储路径 expire-days: 180 操作日志保留天数 ```

初始化数据库表结构:

``` mysql -uarchive_user -pArchive_User@2024 archive_system < /opt/archive-system/sql/init.sql ```

盐城档案管理系统本地化部署与核心功能配置实操全指南

后台启动系统,查看日志出现“Started ArchiveSystemApplication in X seconds”即为启动成功:

``` nohup java -jar archive-system.jar > /var/log/archive.log 2>&1 & tail -f /var/log/archive.log ```

2.3 Nginx反向代理配置

新建Nginx配置文件/etc/nginx/conf.d/archive.conf,复制以下内容,替换server_name为你的服务器公网IP或域名:

```nginx server { listen 80; server_name 你的服务器IP或域名; client_max_body_size 100M; location /archive { proxy_pass http://127.0.0.1:8080/archive; 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 /archive/static { alias /opt/archive-system/static; expires 7d; } } ```

验证配置并重载Nginx:

``` nginx -t nginx -s reload ```

部署完成后访问地址:http://你的IP/archive,默认管理员账号:admin,默认密码:Admin@123456,首次登录必须立即修改密码,建议开启双因子认证

三、核心功能配置实操

3.1 盐城行政区划对接

登录后台进入【系统设置】-【区域配置】,点击【同步盐城官方档案区划接口】,接口地址填写https://api.ycdagov.cn/area/query,请求头添加key: YC_ARCHIVE_2024,点击同步即可自动加载盐城所有区县、街道区划数据,同步完成后必须勾选【启用区划校验】,后续档案上传会自动校验所属区域合法性,符合盐城档案管理规范

3.2 档案分类模板配置

进入【档案管理】-【分类模板】,点击【导入官方模板】,模板文件路径为/opt/archive-system/template/yc_archive_template.xlsx,直接上传即可自动生成文书、科技、民生、专业4大类盐城标准档案分类,必须开启【档号自动生成】规则,规则采用盐城统一标准:区划代码+年度+保管期限+顺序号,可根据实际需求增减自定义字段。

3.3 权限体系配置

进入【系统管理】-【角色管理】,新建3个默认角色:区县管理员、档案录入员、档案查询员,区县管理员勾选对应区县所有档案操作权限,录入员仅勾选档案上传、修改权限,查询员仅勾选档案查询、导出权限,新建用户时绑定对应角色和所属区域,禁止给普通用户分配跨区域查询权限,符合盐城档案保密要求

四、常见问题排查

4.1 启动失败排查

首先查看日志/var/log/archive.log,若提示数据库连接失败,检查application.yml中的数据库密码是否正确,确认archive_user用户授权正常;若提示端口占用,执行lsof -i:8080杀掉占用进程,或修改server.port配置为其他可用端口。

4.2 档案上传失败排查

首先检查文件大小是否超过100M,其次检查/opt/archive-data目录权限,执行chown -R nginx:nginx /opt/archive-data即可解决权限不足问题。

4.3 区划接口同步失败排查

执行ping api.ycdagov.cn确认服务器可访问外网,若无法连通联系机房开通白名单,或下载离线区划包直接导入,离线包地址:https://mirrors.ycdagov.cn/archive-system/yc_area_2024.xlsx。

五、验收标准

部署完成后需完成3项验证:1.用录入员账号上传一份测试文书档案,档号自动生成符合盐城标准,可正常查询、导出;2.跨区域普通用户无法查询其他区县档案,符合保密要求;3.系统连续运行72小时无重启,CPU占用率低于30%,内存占用低于2G。

AI咨询
热线电话

028-85154420

15388110056

全国售前咨询电话

扫码咨询
安答联动微信公众号二维码

微信扫码关注安答联动

申请试用
热线电话
申请试用

安答联动档案管理系统