机关单位综合档案管理系统本地化部署零门槛实操全指南

一、前期准备工作

本指南适配国家政务服务平台开源合规的综合档案管理系统机关版v2.3.0，符合《机关档案管理规定》及等保2.0三级要求，所有资源均为国内可直接访问的镜像地址。

1.硬件与系统要求

• 服务器最低配置：2核4G，系统盘40G，数据盘100G以上（存储档案建议配置1T以上数据盘）
• 操作系统：CentOS7.9 或 统信UOS服务器版V20（机关单位主流适配系统）

2.依赖资源下载地址

• JDK1.8清华镜像：https://mirrors.tuna.tsinghua.edu.cn/Adoptium/8/jdk/x64/linux/OpenJDK8U-jdk_x64_linux_hotspot_8u382b05.tar.gz
• MySQL5.7 RPM源：https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
• 系统安装包（Gitee开源合规版）：https://gitee.com/ngis-china/archives-manage/releases/download/v2.3.0/archives-manage-v2.3.0.tar.gz

二、基础依赖安装实操

所有命令可直接复制执行，操作前请使用root账号登录服务器。

1.关闭系统拦截规则

执行以下命令关闭防火墙和SELinux，避免端口访问拦截：

``` systemctl stop firewalld && systemctl disable firewalld sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config reboot ```

重启后执行`getenforce`，输出Disabled即为生效。

2.安装JDK1.8

``` wget https://mirrors.tuna.tsinghua.edu.cn/Adoptium/8/jdk/x64/linux/OpenJDK8U-jdk_x64_linux_hotspot_8u382b05.tar.gz tar -zxvf OpenJDK8U-jdk_x64_linux_hotspot_8u382b05.tar.gz mv jdk8u382-b05 /usr/local/jdk8 ```

打开/etc/profile文件，末尾添加以下环境变量：

``` export JAVA_HOME=/usr/local/jdk8 export JRE_HOME=${JAVA_HOME}/jre export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib export PATH=${JAVA_HOME}/bin:$PATH ```

执行`source /etc/profile`生效，输入`java -version`输出1.8.x版本即为安装成功。

3.安装MySQL5.7

``` wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server --nogpgcheck systemctl start mysqld && systemctl enable mysqld ```

获取初始密码并修改为符合等保要求的复杂密码，创建业务数据库：

``` 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL，将下面的初始密码替换为你获取到的内容 mysql -uroot -p'初始密码' 执行以下SQL语句 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Arch@2024_Admin'; create database archives default character set utf8mb4 collate utf8mb4_general_ci; grant all privileges on archives. to 'arch_admin'@'%' identified by 'Arch@2024_Admin'; flush privileges; exit; ```

4.安装Redis与Nginx

``` 安装Redis yum install -y epel-release && yum install -y redis sed -i 's/ requirepass foobared/requirepass ArchRedis@2024/' /etc/redis.conf systemctl start redis && systemctl enable redis 安装Nginx yum install -y nginx systemctl start nginx && systemctl enable nginx ```

三、系统部署与配置

1.系统安装与基础配置

``` 下载并解压安装包 wget https://gitee.com/ngis-china/archives-manage/releases/download/v2.3.0/archives-manage-v2.3.0.tar.gz tar -zxvf archives-manage-v2.3.0.tar.gz -C /opt/ 创建档案存储目录 mkdir -p /data/archives && chmod 777 /data/archives 导入数据库初始化脚本 mysql -u arch_admin -pArch@2024_Admin archives < /opt/archives-manage/sql/init.sql ```

打开/opt/archives-manage/config/application-prod.yml，替换为以下完整配置：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archives?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: arch_admin password: Arch@2024_Admin driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: ArchRedis@2024 file: save-path: /data/archives/ max-size: 1024MB ```

2.启动系统与Nginx配置

执行启动命令：`cd /opt/archives-manage/bin && chmod +x startup.sh && ./startup.sh`，执行`tail -f ../logs/archives-manage.log`看到“启动成功”字样即可。

新建/etc/nginx/conf.d/archives.conf文件，添加以下反向代理配置：

``` server { listen 80; server_name 替换为你的服务器IP或内网域名; client_max_body_size 1024M; location / { root /opt/archives-manage/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ```

执行`nginx -t`验证配置无误后，执行`nginx -s reload`重载配置。

四、核心功能初始化配置

访问服务器IP即可进入系统登录页，默认账号：admin，默认密码：Admin@123456，首次登录必须修改默认密码。

1.单位架构配置

进入【系统管理】-【部门管理】，点击下载导入模板，按模板填写单位所有部门和人员信息后上传，系统会自动生成部门架构和人员初始账号。

2.档案分类与权限配置

• 进入【档案管理】-【分类设置】，按机关档案管理要求添加文书、科技、人事、会计、声像、电子、实物7个一级分类，每个分类下配置永久、30年、10年三个保管期限选项。
• 进入【系统管理】-【角色管理】，创建档案管理员、普通用户、审计员三个角色，分别赋予档案录入审核、查询借阅、操作审计的对应权限，符合三权分立要求。

五、功能验证与常见问题排查

1.核心功能验证

• 档案录入验证：使用档案管理员账号登录，上传1份PDF格式文书档案，填写文号、标题、成文日期等元数据，提交后可在档案库检索到即为正常。
• 借阅流程验证：普通用户提交档案借阅申请，管理员审批通过后用户可在线查看，到期自动收回权限即为正常。
• 审计日志验证：审计员账号登录，可查看所有用户的登录、查询、下载、修改操作记录，且日志不可删除即为正常。

2.常见问题排查

• 系统启动失败：查看日志如果提示数据库连接错误，检查配置文件中数据库密码是否正确，执行`systemctl status mysqld`确认MySQL服务正常运行。
• 档案上传失败：检查/data/archives目录权限是否为777，Nginx配置中client_max_body_size是否大于上传文件大小。
• 页面无法访问：执行`ss -ntlp`确认80端口和8080端口处于监听状态，执行`ps -ef | grep java`确认后端服务进程存在。