石油工程档案软件本地部署与规范建档全流程实操指南

一、前置准备

本次实操采用免费可商用的开源石油工程档案软件，仅需Windows 10/11 64位系统即可运行，无需额外配置复杂运行环境，所需准备内容如下：

• 设备要求：Windows 10/11 64位操作系统，磁盘剩余空间≥10G
• 直接下载安装包：复制以下链接到浏览器地址栏打开即可下载 https://gitee.com/yanhualang/pe-archive-management/releases/download/v1.0.0/pe-archive-windows-x64.zip

二、本地部署实操步骤

1、解压安装包

将下载好的zip压缩包解压到非系统盘（如D盘）根目录，必须注意：解压路径绝对不能包含中文、空格和特殊符号，否则会启动失败。正确路径示例：D:\pe-archive，错误路径示例：D:\石油工程软件\pe archive。

2、启动系统服务

进入解压后的根文件夹，找到start.bat文件，必须右键点击文件，选择「以管理员身份运行」，不能直接双击打开，否则会因权限不足启动失败。启动后会弹出黑色命令行窗口，等待1-3分钟，看到窗口输出中出现Started Application in字样，说明启动成功，不要关闭该窗口，直接最小化即可。

3、登录系统后台

打开任意主流浏览器（Chrome、Edge、360浏览器均可），在地址栏输入http://localhost:8080/pe-archive，回车即可打开登录页面，默认管理员账号密码为：账号：admin，密码：123456，输入后点击登录即可进入后台。

4、常见启动问题排查

• 端口被占用提示：打开解压目录下的application.yml文件，用记事本打开，找到server.port: 8080，将8080修改为8081，保存后重新启动即可。
• 缺少dll文件提示：直接下载安装微软64位运行库，地址：https://download.microsoft.com/download/1/6/5/16525004-08C3-4DEB-8367-06CBB84A6F5D/vcredist_x64.exe，安装完成后重启电脑再启动即可。

三、石油工程规范建档实操步骤

1、配置符合行业标准的档案分类

首次登录后需要先配置档案分类，符合石油天然气行业档案管理规范，操作路径：左侧菜单栏点击「系统配置」→「档案分类管理」，点击右上角「新增分类」，按照以下层级添加即可：

• 一级分类：钻井工程档案 → 二级分类：完井报告、钻井日志、录井资料、井身结构图
• 一级分类：油气开发档案 → 二级分类：开发方案、试油试采资料、动态监测数据
• 一级分类：地面建设档案 → 二级分类：站场设计图、管线铺设资料、竣工验收报告

添加完成后点击「保存分类」，系统自动生成可检索的分类树，后续可随时调整层级。

2、单份档案上传归档

分类配置完成后即可开始建档，具体步骤：

• 左侧菜单栏点击「档案管理」→「新增档案」
• 填写基础信息：档号必须按照「分类代码-区块编号-井号-年份」规则填写，示例：ZJ-鄂尔多斯-苏10-2024，方便后续快速检索；档案名称填写完整全称，示例：苏10井2024年度完井报告
• 在下拉框中选择刚才配置好的对应档案分类
• 上传档案文件：支持PDF、CAD、Word、高清扫描件等常用格式，单个文件最大支持2G，可批量上传；多页扫描件必须命名为「档案名称-页码」格式，方便后续在线查阅
• 选择保管期限：永久保管的核心地质档案勾选「永久」，普通资料勾选对应10年/30年保管期限，点击「提交归档」，即完成单份档案建档。

3、档案检索与借阅管理

批量建档后，需要调阅档案时，直接在档案管理页顶部搜索框输入档号、井号或任意关键词，点击搜索即可1秒定位目标档案，支持在线预览CAD、PDF格式文件，无需本地安装专业软件。如需给同事开放借阅，操作步骤：

• 左侧菜单栏点击「用户管理」→「新增用户」，输入同事的账号密码，分配对应分类的档案查看权限
• 找到目标档案，点击右侧「发起借阅」，选择对应用户，设置借阅有效期，提交即可，系统自动记录全流程借阅日志，符合石油行业档案管理留痕要求。

四、日常安全维护操作

为避免档案数据丢失，需要按照以下要求操作：

• 备份管理：系统默认每天凌晨2点自动备份数据，备份文件保存在解压目录的backup文件夹中，每周必须将备份文件拷贝到移动硬盘或离线云盘存储，避免本地磁盘损坏导致数据丢失
• 关闭服务操作：需要重启电脑或关闭服务时，先点击命令行窗口，按Ctrl+C关闭服务，再关闭窗口，不要直接强制关闭窗口，避免数据损坏
• 权限管控：仅核心档案管理员保留系统配置权限，普通员工仅开放档案检索查看权限，不要随意分配管理员权限，避免误删档案数据。