燃气生产和供应企业数字档案馆系统从零搭建与常规运维实操全指南

前期准备（部署前必做检查）

硬件配置要求

针对100人以内的中小燃气生产供应企业，配置要求如下，更大规模企业可按用户量线性提升配置：

• 独立部署：应用服务器4核8G/100G系统盘+2T SSD数据盘，数据库服务器4核16G/100G系统盘+4T SSD数据盘，操作系统统一用CentOS7.9
• 单节点部署：直接用8核16G/100G系统盘+6T SSD数据盘即可

基础依赖安装

登录服务器后执行以下命令安装基础环境依赖：

``` yum install -y wget vim unzip net-tools gcc gcc-c++ make crontabs 测试环境可直接关闭防火墙和SELinux，生产环境按需开放3306、6379、80、9000、9001端口 systemctl stop firewalld && systemctl disable firewalld setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config ```

核心组件版本选型

所有组件统一使用以下固定版本，无需自行升级避免兼容性问题：JDK1.8、MySQL8.0.28、Redis6.2.7、MinIO2023.03.24、Nginx1.24.0

系统部署步骤

1. 数据库部署与初始化

执行以下命令安装MySQL8.0.28：

``` 下载MySQL安装包 wget https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.28-1.el7.x86_64.rpm-bundle.tar tar -xvf mysql-8.0.28-1.el7.x86_64.rpm-bundle.tar 卸载自带mariadb rpm -e --nodeps mariadb-libs 依次安装rpm包 rpm -ivh mysql-community-common-8.0.28-1.el7.x86_64.rpm rpm -ivh mysql-community-client-plugins-8.0.28-1.el7.x86_64.rpm rpm -ivh mysql-community-libs-8.0.28-1.el7.x86_64.rpm rpm -ivh mysql-community-client-8.0.28-1.el7.x86_64.rpm rpm -ivh mysql-community-server-8.0.28-1.el7.x86_64.rpm 启动并设置开机自启 systemctl start mysqld && systemctl enable mysqld ```

初始化数据库与业务库，执行以下命令：

``` 获取初始密码 grep 'temporary password' /var/log/mysqld.log 登录后修改root密码，密码要求包含大小写、数字、特殊字符，示例：GasArchive@2024 mysql -uroot -p ALTER USER 'root'@'localhost' IDENTIFIED BY 'GasArchive@2024'; 创建业务库和专用账号 CREATE DATABASE gas_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'gas_user'@'%' IDENTIFIED BY 'GasArchive@2024'; GRANT ALL PRIVILEGES ON gas_archive. TO 'gas_user'@'%'; FLUSH PRIVILEGES; exit; 导入初始SQL脚本 wget -P /opt https://gitee.com/open-gas/archive-system/raw/master/sql/init.sql mysql -ugas_user -pGasArchive@2024 gas_archive < /opt/init.sql ```

2. 缓存与对象存储部署

首先部署Redis6.2.7作为系统缓存：

``` wget https://download.redis.io/releases/redis-6.2.7.tar.gz tar -zxvf redis-6.2.7.tar.gz && cd redis-6.2.7 make && make install 后台启动，设置密码为GasRedis@2024 redis-server --daemonize yes --requirepass GasRedis@2024 ```

部署MinIO存储燃气档案扫描件、音视频、工单文件等资源：

``` 创建存储目录 mkdir -p /opt/minio/data /opt/minio/log /opt/backup wget https://dl.min.io/server/minio/release/linux-amd64/archive/minio.RELEASE.2023-03-24T21-41-23Z -O /usr/local/bin/minio chmod +x /usr/local/bin/minio 启动MinIO，管理账号minioadmin，密码GasMinio@2024 nohup minio server /opt/minio/data --console-address ":9001" > /opt/minio/log/minio.log 2>&1 & 登录http://服务器IP:9001，创建名为gas-archive的bucket，设置访问权限为私有 ```

3. 应用服务部署

先安装JDK1.8：

``` wget https://repo.huaweicloud.com/java/jdk/8u202-b08/jdk-8u202-linux-x64.tar.gz tar -zxvf jdk-8u202-linux-x64.tar.gz -C /usr/local/ 配置环境变量 echo "export JAVA_HOME=/usr/local/jdk1.8.0_202" >> /etc/profile echo "export PATH=\$PATH:\$JAVA_HOME/bin" >> /etc/profile source /etc/profile ```

下载应用包并修改配置：

``` 下载最新稳定版应用包 mkdir -p /opt/gas-archive/config /opt/gas-archive/logs wget https://gitee.com/open-gas/archive-system/releases/download/v1.0.0/gas-archive.jar -P /opt/gas-archive/ 下载配置文件模板 wget https://gitee.com/open-gas/archive-system/raw/master/config/application-prod.yml -P /opt/gas-archive/config/ 修改配置文件，仅需修改3处，其他保持默认：1.数据库IP、账号密码 2.Redis IP、密码 3.MinIO IP、账号密码 vim /opt/gas-archive/config/application-prod.yml 启动应用 nohup java -jar /opt/gas-archive/gas-archive.jar --spring.profiles.active=prod > /opt/gas-archive/logs/start.log 2>&1 & ```

4. Nginx反向代理配置

执行以下命令安装配置Nginx：

``` yum install -y nginx 替换/etc/nginx/nginx.conf的server块内容为以下配置 vim /etc/nginx/nginx.conf ``` ``` server { listen 80; server_name 你的服务器IP; client_max_body_size 1024M; 支持最大1G的档案文件上传 location / { root /opt/gas-archive/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; } } ```

下载前端包并启动Nginx：

``` wget https://gitee.com/open-gas/archive-system/releases/download/v1.0.0/dist.zip -P /opt/gas-archive/ unzip /opt/gas-archive/dist.zip -d /opt/gas-archive/ systemctl start nginx && systemctl enable nginx ```

部署完成后，访问http://你的服务器IP即可进入系统，默认管理员账号admin，密码Admin@123456，第一次登录必须修改密码。

燃气行业专属配置实操

1. 档案分类配置

登录系统后进入【系统管理-档案分类】，导入燃气行业专属分类模板，模板下载地址：https://gitee.com/open-gas/archive-system/raw/master/template/gas-category.xlsx，默认包含燃气生产工艺档案、管网巡检档案、用户开户档案、安全检查档案、应急抢修档案、设备维护档案6大类，可按需新增子类。

2. 岗位权限配置

进入【系统管理-角色管理】，按燃气企业岗位配置对应权限：

• 生产部：仅可上传、查看生产工艺、设备维护档案
• 管网部：仅可上传、查看巡检、抢修档案
• 客服部：仅可上传、查看用户开户、安检档案
• 合规部：仅可查看所有档案、导出审计报表
• 管理员：拥有所有操作权限

3. 智能归档配置

针对纸质扫描的燃气工单、安检单等文件，进入【系统设置-智能配置】，填写百度智能云OCR的API密钥（申请地址：https://cloud.baidu.com/product/ocr.html），配置后可自动提取单据上的用户编号、地址、安检结果等字段，自动匹配对应分类归档。

常规运维操作

1. 自动备份配置

执行crontab -e添加以下定时任务，每天凌晨2点自动备份数据，备份文件保留30天：

``` 0 2 mysqldump -ugas_user -pGasArchive@2024 gas_archive > /opt/backup/db_$(date +%Y%m%d).sql 0 2 tar -zcvf /opt/backup/minio_$(date +%Y%m%d).tar.gz /opt/minio/data 0 3 find /opt/backup -mtime +30 -name ".sql" -o -name ".tar.gz" | xargs rm -f ```

2. 常见问题排查

• 无法访问系统：执行netstat -ntlp查看80、8080端口是否正常监听，若Nginx未启动执行systemctl start nginx，若应用未启动重新执行jar包启动命令即可
• 文件上传失败：检查MinIO是否正常运行，gas-archive bucket是否创建，配置文件中MinIO地址是否填写正确
• 档案查询慢：登录MySQL执行OPTIMIZE TABLE archive_info;优化数据表即可