盐城档案管理系统本地化部署与核心功能配置实操全指南
一、前期准备工作
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,直接复制以下完整配置即可,无需额外修改:
初始化数据库表结构:
``` 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:
``` 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。