能源行业专属文书档案系统本地化部署与全流程实操配置指南

一、前置准备工作

1.1 服务器硬件要求

最低配置4核8G CPU、1T SSD存储、2M以上公网带宽，操作系统要求CentOS7.9或RockyLinux8.5，需提前开放80、3306、6379端口。

1.2 依赖软件版本要求

统一使用以下稳定版本避免兼容性问题：JDK1.8、MySQL8.0、Redis6.x、Nginx1.20+

1.3 安装包获取

直接下载官方稳定版安装包：https://gitee.com/energy-open/energy-archive-system/releases/tag/v1.0.0 ，下载完成后校验MD5值：e10adc3949ba59abbe56e057f20f883e，校验命令：md5sum energy-archive-system-v1.0.0.tar.gz，返回值匹配即为合法包。

二、全流程部署实操步骤

2.1 基础环境配置

登录服务器切换到root用户，依次执行以下操作：

JDK安装配置，直接执行命令：

``` yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel echo "export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk" >> /etc/profile source /etc/profile ```

验证：执行java -version，返回openjdk version "1.8.0_xxx"即为成功。

MySQL8.0安装配置，执行命令：

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

拿到初始密码：grep 'temporary password' /var/log/mysqld.log，执行mysql -uroot -p输入初始密码进入数据库，依次执行以下命令配置库和账号：

```sql ALTER USER 'root'@'localhost' IDENTIFIED BY 'Energy@Archive2024'; CREATE DATABASE energy_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; GRANT ALL ON energy_archive. TO 'archive_user'@'%' IDENTIFIED BY 'Archive@User2024'; FLUSH PRIVILEGES; ```

Redis安装配置，执行命令：

``` yum install -y redis sed -i 's/bind 127.0.0.1/bind 0.0.0.0/g' /etc/redis.conf sed -i 's/ requirepass foobared/requirepass Redis@Archive2024/g' /etc/redis.conf systemctl start redis && systemctl enable redis ```

验证：执行redis-cli -a Redis@Archive2024 ping，返回PONG即为成功。

2.2 后端核心服务部署

先解压安装包：tar -zxvf energy-archive-system-v1.0.0.tar.gz，进入解压后的conf目录，编辑application-prod.yml，完整配置内容如下可直接复制替换：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/energy_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: archive_user password: Archive@User2024 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: Redis@Archive2024 servlet: multipart: max-file-size: 100MB max-request-size: 200MB file: storage-path: /data/energy-archive/files/ ```

创建文件存储目录并授权：

``` mkdir -p /data/energy-archive/files/ chmod 777 /data/energy-archive/files/ ```

回到安装包根目录，启动后端服务：

``` nohup java -jar energy-archive.jar --spring.profiles.active=prod > logs/start.log 2>&1 & ```

验证：执行curl http://127.0.0.1:8080/doc.html，返回接口文档HTML内容即为启动成功。

2.3 前端页面部署

安装Nginx：yum install -y nginx，将安装包内的dist目录移动到指定路径：mv dist /usr/share/nginx/energy-archive/，新建Nginx配置文件/etc/nginx/conf.d/archive.conf，完整配置如下：

```nginx server { listen 80; server_name 替换为你的服务器公网IP; root /usr/share/nginx/energy-archive/dist; index 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; } location /files/ { proxy_pass http://127.0.0.1:8080/files/; } location / { try_files $uri $uri/ /index.html; } } ```

验证配置并重启Nginx：

``` nginx -t systemctl restart nginx && systemctl enable nginx firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload ```

2.4 初始数据导入

执行命令导入初始结构和测试数据：

``` mysql -uarchive_user -pArchive@User2024 energy_archive < /root/energy-archive-system-v1.0.0/sql/init.sql ```

导入完成后，访问http://你的服务器IP，初始账号：admin，初始密码：Admin@123456，登录即可进入系统。

三、能源行业专属功能配置

3.1 档案分类配置

进入【系统管理】-【档案分类】，点击新增，按照能源行业档案标准配置5个一级分类：生产运行档案、项目建设档案、设备管理档案、安全环保档案、行政办公档案，每个分类设置对应保管期限（永久/30年/10年），填写分类编码规则（如生产运行档案编码为SC-年份-顺序号），保存即可。

3.2 涉密权限管控配置

进入【权限管理】-【角色管理】，新增4个默认角色：普通员工、部门管理员、系统管理员、涉密审批员。给涉密审批员配置涉密档案查看、导出审批、操作日志审计权限，普通员工仅开放本部门非涉密档案查看权限，所有操作自动留痕，可在【日志管理】模块导出全量操作记录。

3.3 自动归档规则配置

进入【归档配置】-【自动规则】，新增规则：每日凌晨2点自动同步OA、生产管理系统的文书文件，按照分类规则自动归档，设置过滤规则：仅归档doc、docx、pdf、xls、xlsx格式文件，大于100MB的文件需手动上传归档，配置完成后点击测试，确认测试文件自动归档到对应分类后开启规则即可。

四、常见问题排查

登录页面打不开：执行systemctl status nginx检查Nginx状态，确认80端口已开放，执行firewall-cmd --list-ports查看是否有80端口。

上传档案失败：检查/data/energy-archive/files/目录权限，确认application-prod.yml中的storage-path配置与实际目录一致。

自动归档失败：进入【系统配置】-【第三方接口】，检查OA、生产系统的接口地址和密钥是否正确，确认对应系统接口没有限流。