池州档案管理系统本地化部署与基础配置全流程实操指南

前置环境准备

硬件要求（池州政务场景适配版）

最低配置：2核4G云服务器/本地物理主机，系统盘≥40G，数据盘≥100G（用于存储档案扫描件、备份文件），操作系统选择CentOS7.9或Ubuntu22.04，开放端口80、8080、3306。

软件依赖安装

以下为CentOS7.9系统安装命令，Ubuntu可替换为apt对应命令执行：

• 执行系统源更新：yum update -y
• 安装Nginx：yum install nginx -y
• 安装MySQL5.7：yum install mysql-community-server -y，注意：首次启动MySQL前必须修改/etc/my.cnf，在[mysqld]节点下添加lower_case_table_names=1，避免表名大小写报错
• 安装JDK1.8：yum install java-1.8.0-openjdk -y
• 安装Redis5：yum install redis -y
• 设置服务开机自启：systemctl enable mysqld nginx redis && systemctl start mysqld nginx redis

系统部署核心操作

安装包获取与解压

池州政务适配版安装包官方下载地址：https://demo.archives-chizhou.com/pkg/chizhou-archives-v1.2.0.tar.gz，执行以下命令下载解压：

• 下载安装包：wget https://demo.archives-chizhou.com/pkg/chizhou-archives-v1.2.0.tar.gz
• 解压到指定目录：tar -zxvf chizhou-archives-v1.2.0.tar.gz -C /opt/

数据库初始化

执行以下命令完成数据库创建与初始数据导入：

• 登录MySQL：mysql -uroot -p你设置的MySQL密码
• 创建业务库：CREATE DATABASE chizhou_archives DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
• 创建业务账号并授权：GRANT ALL ON chizhou_archives. TO 'archives_user'@'%' IDENTIFIED BY 'ChiZhou@2024Archives'; FLUSH PRIVILEGES;
• 导入初始数据：use chizhou_archives; source /opt/chizhou-archives/sql/init.sql;

导入完成后执行select count() from sys_user验证，返回3条数据即为初始化成功

核心配置文件修改

打开配置文件：vi /opt/chizhou-archives/config/application-prod.yml，复制以下完整配置替换原有内容即可：

```yaml server: port: 8080 servlet: context-path: /archives spring: datasource: url: jdbc:mysql://localhost:3306/chizhou_archives?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archives_user password: ChiZhou@2024Archives driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 password: '' servlet: multipart: max-file-size: 100MB max-request-size: 200MB 池州档案专属配置 chizhou: archives: storage-path: /data/archives-storage/ gov-secret: '' code-prefix: CZDA ```

执行命令创建存储目录并赋权：mkdir -p /data/archives-storage/ && chmod 755 /data/archives-storage/

服务启动与验证

• 后台启动服务：nohup java -jar /opt/chizhou-archives/chizhou-archives.jar --spring.profiles.active=prod > /opt/chizhou-archives/logs/start.log 2>&1 &
• 查看启动日志：tail -f /opt/chizhou-archives/logs/start.log，出现“Started ChizhouArchivesApplication”字样即为启动成功
• 访问系统：打开浏览器输入http://你的服务器IP:8080/archives，默认管理员账号admin，密码ChiZhou@2024，首次登录必须强制修改密码，要求8位以上含字母、数字、特殊字符

80端口访问配置（可选）

如需直接通过IP/域名访问无需加端口，创建Nginx配置文件/etc/nginx/conf.d/archives.conf，复制以下内容：

```nginx server { listen 80; server_name 你的域名或服务器IP; location /archives { proxy_pass http://127.0.0.1:8080/archives; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; client_max_body_size 200M; } } ```

执行systemctl restart nginx重启Nginx即可生效。

池州场景专属功能配置

标准档案类目导入

登录后台→系统管理→类目管理→批量导入，官方预设类目模板下载地址：https://demo.archives-chizhou.com/tpl/chizhou-category-template.xlsx，模板已覆盖池州政务、民生、城建3大类127个标准二级类目，无需手动新增，导入后点击启用即可使用。

四性检测功能开启

进入系统设置→功能配置→四性检测，勾选开启自动检测，检测阈值设置为100%后保存，所有新上传档案会自动执行真实性、完整性、可用性、安全性检测，不符合要求的自动拦截并给出错误原因。

政务网对接配置（可选）

如需对接池州政务服务网实现办结档案自动归档，打开application-prod.yml配置文件，找到gov-secret字段填入政务平台分配的专属密钥，执行重启命令生效：ps -ef|grep chizhou-archives|grep -v grep|awk '{print $2}'|xargs kill -9，再执行之前的服务启动命令即可。

常见问题排查与运维

• 启动报数据库连接失败：检查MySQL服务是否正常运行，配置文件中账号密码是否正确，archives_user用户是否已授权远程访问权限
• 上传档案报权限错误：检查/data/archives-storage/目录权限是否为755，可执行chown -R root:root /data/archives-storage/修复
• 四性检测不通过：查看检测报告，若为元数据缺失，在档案上传页面补充池州标准元数据字段后重新上传即可
• 数据库自动备份配置：执行crontab -e添加定时任务0 1 mysqldump -uarchives_user -pChiZhou@2024Archives chizhou_archives > /data/backup/archives_$(date +%Y%m%d).sql，提前创建/data/backup目录，备份文件保留30天即可
• 每月检查数据盘使用率，超过80%及时扩容，避免档案无法上传；每季度执行系统安全补丁更新，降低漏洞风险。