深圳数字档案馆系统本地部署与基础功能配置实操全指南

一、部署前环境准备

1.硬件要求

最低配置：2核4G云服务器/物理机，50G系统盘+100G数据盘，操作系统为CentOS7.9 64位。

2.软件依赖准备

需提前下载以下对应版本的安装包，避免版本兼容问题：

• JDK11：https://adoptium.net/zh-CN/temurin/releases/?version=11 选择x64 RPM包
• MySQL8.0：https://dev.mysql.com/downloads/mysql/8.0.html 选择Linux Generic x86_64包
• Redis6.2：https://download.redis.io/releases/redis-6.2.7.tar.gz
• 深圳数字档案馆系统部署包：http://www.szda.gov.cn/xxgk/ztzl/xxhjs/xfw/xzcx/202306/t20230615_32416398.htm 下载v2.1.0社区部署版

二、系统部署实操步骤

1.基础环境初始化

所有操作均使用root账号执行，依次运行以下命令：

① 安装JDK11：

```shell rpm -ivh temurin-11.0.20+8.x86_64.rpm echo 'export JAVA_HOME=/usr/lib/jvm/temurin-11 export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar' >> /etc/profile source /etc/profile 验证安装，返回openjdk version "11.0.20"即为成功 java -version ```

② 安装MySQL8.0：

```shell tar -xvf mysql-8.0.33-linux-glibc2.28-x86_64.tar.xz -C /usr/local/ mv /usr/local/mysql-8.0.33-linux-glibc2.28-x86_64 /usr/local/mysql useradd mysql mkdir -p /data/mysql chown mysql:mysql /data/mysql 初始化后记录生成的初始密码 /usr/local/mysql/bin/mysqld --initialize --user=mysql --datadir=/data/mysql ```

③ 安装Redis6.2：

```shell tar -zxvf redis-6.2.7.tar.gz cd redis-6.2.7 make && make install cp redis.conf /etc/redis.conf 修改配置：放开远程访问、设置密码 sed -i 's/bind 127.0.0.1/bind 0.0.0.0/g' /etc/redis.conf sed -i 's/ requirepass foobared/requirepass Sz_redis@2024/g' /etc/redis.conf 启动Redis redis-server /etc/redis.conf & 验证连接，返回PONG即为成功 redis-cli -a Sz_redis@2024 ping ```

2.数据库配置

登录MySQL创建业务库和账号，依次执行以下SQL：

```sql -- 登录MySQL，替换为你初始化时生成的密码 mysql -uroot -p你的初始密码 -- 创建业务库 CREATE DATABASE sz_da_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 创建业务账号 CREATE USER 'sz_da_user'@'%' IDENTIFIED BY 'Sz_da@2024'; GRANT ALL PRIVILEGES ON sz_da_archive. TO 'sz_da_user'@'%'; FLUSH PRIVILEGES; exit; -- 导入初始表结构，部署包解压后sql目录下有init.sql文件 mysql -u sz_da_user -pSz_da@2024 sz_da_archive < /opt/sz_archive/sql/init.sql ```

3.系统服务部署

① 解压部署包并创建存储目录：

```shell tar -zxvf sz-digital-archive-v2.1.0.tar.gz -C /opt/ mkdir -p /data/archive/file chmod 755 /data/archive/file ```

② 修改配置文件/opt/sz-digital-archive/config/application.yml，完整可复制配置如下：

```yaml server: port: 8088 servlet: context-path: / spring: datasource: url: jdbc:mysql://127.0.0.1:3306/sz_da_archive?useUnicode=true&characterEncoding=utf8mb4&useSSL=false&serverTimezone=GMT%2B8 username: sz_da_user password: Sz_da@2024 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: Sz_redis@2024 database: 0 sz-archive: storage-path: /data/archive/file sync-enabled: false sync-api-key: 待申请的官方同步密钥 ```

③ 启动系统服务：

```shell cd /opt/sz-digital-archive/ nohup java -jar sz-archive-admin.jar --spring.profiles.active=prod & 查看启动日志，出现Started SzArchiveAdminApplication即为启动成功 tail -f nohup.out ```

三、基础功能配置实操

1.系统初始化登录

访问地址：http://你的服务器IP:8088，初始账号：admin，初始密码：Admin@123456，登录后第一时间在【个人中心】修改密码，密码要求包含大小写字母、数字、特殊字符，长度不低于8位。

2.档案分类规则配置

进入【系统管理-分类配置】，按照深圳档案馆SZDA-2022标准配置分类，编码规则为：4位一级类目+2位二级类目，示例配置如下：

• 一级类目：WS00（文书档案），二级类目：WS01（党群工作类）、WS02（行政管理类）
• 一级类目：KJ00（科技档案），二级类目：KJ01（产品档案）、KJ02（基建档案）

必须严格按照编码规则配置，否则后续无法同步到市级档案平台

3.上传权限配置

进入【系统管理-角色管理】，新增普通档案管理员角色，权限勾选：档案上传、档案查询、元数据校验，保存后分配给对应操作人员即可。

四、功能验证与合规检查

1.档案上传测试

使用普通管理员账号登录，进入【档案管理-上传档案】，选择分类为WS01，上传一份PDF格式的文书档案，填写元数据（全宗号、年度、保管期限为必填项），提交后在【档案列表】能看到对应记录即为上传成功。

2.合规性校验

在档案列表点击【一键合规检查】，返回“符合SZDA-2022归档标准”即为合规，若报错可根据提示修改对应元数据字段。

3.市级平台同步测试

如需同步到深圳市级档案馆，先到http://www.szda.gov.cn/xxgk/bsdt/xzsp/202211/t20221108_21763980.htm 申请同步接口密钥，将密钥填入application.yml的sync-api-key字段，设置sync-enabled为true后重启服务，点击档案列表的【同步到市级平台】，返回“同步成功”即为配置完成。

五、常见问题排查

• 启动报错端口被占用：执行lsof -i:8088查看占用进程PID，执行kill -9 PID后重新启动即可
• 上传报错元数据不匹配：检查分类编码是否符合4+2位的SZDA-2022标准，必填字段是否为空
• 同步报错密钥无效：检查配置文件中的密钥是否包含空格、是否在申请的有效期内
• 上传大文件报错：修改application.yml中的spring.servlet.multipart.max-file-size参数，设置为100MB即可