电力档案系统从零部署到业务配置全流程实操零门槛指南

一、前期准备

1. 硬件&系统要求

满足县级及以下供电单位10万份以内档案存储需求，配置如下：

• 服务器：2核4G云服务器/物理机，100G以上SSD硬盘
• 操作系统：CentOS7.9 / Ubuntu22.04，开放80、3306、8080端口

2. 依赖包下载地址

所有依赖直接复制链接下载，无需自行查找：

• OpenJDK11：https://builds.openlogic.com/downloadJDK/openlogic-openjdk/11.0.22+7/openlogic-openjdk-11.0.22+7-linux-x64.tar.gz
• MySQL8.0：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-linux-glibc2.28-x86_64.tar.xz
• 电力档案系统服务端包：https://gitee.com/opensource-power/power-archive-system/releases/download/v1.0.0/power-archive-server.jar
• 电力档案系统前端包：https://gitee.com/opensource-power/power-archive-system/releases/download/v1.0.0/power-archive-web.tar.gz

二、基础环境安装

1. JDK11安装配置

执行以下命令完成安装：

``` 下载安装包 wget https://builds.openlogic.com/downloadJDK/openlogic-openjdk/11.0.22+7/openlogic-openjdk-11.0.22+7-linux-x64.tar.gz 解压到/opt目录 tar -zxf openlogic-openjdk-11.0.22+7-linux-x64.tar.gz -C /opt 配置环境变量 echo 'export JAVA_HOME=/opt/openlogic-openjdk-11.0.22+7-linux-x64' >> /etc/profile echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile 生效配置 source /etc/profile 验证安装 java -version ```

返回openjdk version "11.0.22"即为安装成功。

2. MySQL8.0安装配置

执行以下命令完成安装：

``` 下载安装包 wget https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.36-linux-glibc2.28-x86_64.tar.xz 解压 xz -d mysql-8.0.36-linux-glibc2.28-x86_64.tar.xz tar -xf mysql-8.0.36-linux-glibc2.28-x86_64.tar -C /usr/local mv /usr/local/mysql-8.0.36-linux-glibc2.28-x86_64 /usr/local/mysql 创建用户和数据目录 useradd mysql mkdir -p /var/lib/mysql chown mysql:mysql /var/lib/mysql 初始化数据库 /usr/local/mysql/bin/mysqld --initialize --user=mysql --datadir=/var/lib/mysql 复制配置文件，直接覆盖原有配置 cat > /etc/my.cnf << EOF [mysqld] port=3306 datadir=/var/lib/mysql socket=/var/lib/mysql/mysql.sock character-set-server=utf8mb4 default-time-zone='+8:00' max_connections=1000 innodb_buffer_pool_size=1G [client] port=3306 socket=/var/lib/mysql/mysql.sock default-character-set=utf8mb4 EOF 启动服务 /usr/local/mysql/support-files/mysql.server start 配置环境变量 echo 'export PATH=/usr/local/mysql/bin:$PATH' >> /etc/profile source /etc/profile ```

初始化完成后控制台会输出初始密码，登录后修改密码并创建业务库：

``` 登录MySQL，输入初始密码 mysql -uroot -p 修改密码 ALTER USER 'root'@'localhost' IDENTIFIED BY '自定义MySQL密码'; 创建电力档案库 CREATE DATABASE power_archive DEFAULT CHARSET utf8mb4; exit; ```

3. Nginx安装

CentOS执行：

``` yum install -y nginx ```

Ubuntu执行：

``` apt update && apt install -y nginx ```

执行nginx -v返回版本号即为安装成功。

三、系统部署

1. 服务端部署

``` 下载服务端包 wget https://gitee.com/opensource-power/power-archive-system/releases/download/v1.0.0/power-archive-server.jar 创建配置文件，直接复制修改MySQL密码即可 cat > application.yml << EOF server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/power_archive?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=GMT%2B8 username: root password: 你设置的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 100MB max-request-size: 100MB power: archive: storage-path: /data/power-archive/files allow-suffix: .pdf,.doc,.docx,.xls,.xlsx,.dwg,.jpg,.png EOF 创建档案存储目录 mkdir -p /data/power-archive/files chmod 755 /data/power-archive/files 启动服务 nohup java -jar power-archive-server.jar --spring.config.location=./application.yml > server.log 2>&1 & 验证启动 curl http://127.0.0.1:8080/health ```

返回{"code":200,"msg":"success"}即为启动成功。

2. 前端部署

``` 下载前端包 wget https://gitee.com/opensource-power/power-archive-system/releases/download/v1.0.0/power-archive-web.tar.gz 解压到Nginx目录 mkdir -p /usr/share/nginx/html/power-archive tar -zxf power-archive-web.tar.gz -C /usr/share/nginx/html/power-archive 创建Nginx配置文件 cat > /etc/nginx/conf.d/power-archive.conf << EOF server { listen 80; server_name 你的服务器公网IP/域名; root /usr/share/nginx/html/power-archive; index index.html; client_max_body_size 100M; location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host \$host; proxy_set_header X-Real-IP \$remote_addr; } location ~ \.(js|css|png|jpg|gif|ico)$ { expires 7d; add_header Cache-Control "public, no-transform"; } } EOF 验证配置并生效 nginx -t nginx -s reload ```

此时访问http://你的服务器IP，默认管理员账号admin，密码123456，即可登录系统。

四、核心业务配置

1. 档案分类配置

登录后台→系统管理→档案分类管理→点击新增分类，按照电力业务规范设置三级分类：

• 一级分类：输变配电档案、用户档案、运维档案、安全档案
• 二级分类：对应一级分类下设置变电站档案、线路档案、设备档案、居民用户档案、非居民用户档案等
• 三级分类：对应二级分类下设置竣工图、试验报告、巡检记录、报装资料等

配置完成后点击保存，系统自动生成对应分类的上传模板。

2. 权限配置

系统管理→用户管理→新增用户，填写用户姓名、所属供电所、手机号，绑定对应角色：

• 系统管理员：全权限，仅分配给信息科人员
• 档案管理员：可上传、修改、审核档案，分配给各供电所档案专员
• 普通用户：仅可查询本人权限范围内的档案，分配给一线运维人员

必须勾选「仅查看所属机构数据」选项，避免跨供电所数据泄露。

3. 历史档案批量导入

档案管理→批量导入→下载对应分类的导入模板，按照模板要求填写档案编号、名称、所属分类、生成日期、责任人，上传对应电子附件，单次最大支持1000条导入。导入前先点击「数据校验」，校验无错误后再点击确认导入，导入进度可在任务中心查看。

五、上线验证&常见问题排查

1. 上线验证

• 用普通用户账号登录，上传1份测试PDF和1份50M以内的CAD图纸，验证是否可正常预览、下载
• 用不同供电所的账号登录，验证是否无法查看其他供电所的档案
• 批量导入100条测试数据，验证导入成功率100%

2. 常见问题排查

• 服务启动失败：查看server.log，若提示连接数据库失败，检查application.yml中的MySQL密码是否正确；若提示路径不存在，检查是否创建了/data/power-archive/files目录并赋权
• 前端访问404：检查Nginx配置中的root路径是否正确，路径下是否存在index.html文件
• 大文件上传失败：检查application.yml中的max-file-size配置和Nginx配置中的client_max_body_size，二者均需≥上传文件大小