从零搭建企业级天然气数字档案馆的实操技术指南

环境准备（仅限CentOS7，其他系统需调整对应命令）

1.安装基础依赖

执行以下命令安装Python3.9、Git、Curl等核心工具：

``` sudo yum install -y python39 python39-devel git curl ```

2.创建项目虚拟环境

虚拟环境避免依赖冲突，隔离项目运行空间：

``` python3.9 -m venv gas_archive_env source gas_archive_env/bin/activate pip install --upgrade pip ```

核心服务部署（全文检索用Elasticsearch）

1.安装并启动Elasticsearch

执行官方命令安装ES并开启服务：

``` sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch sudo yum install -y elasticsearch sudo systemctl daemon-reload sudo systemctl start elasticsearch sudo systemctl enable elasticsearch ```

必须修改ES配置允许外部访问，否则后续API无法调用，打开配置文件：

``` sudo vi /etc/elasticsearch/elasticsearch.yml ```

修改以下两行后保存，再重启ES：

``` network.host: 0.0.0.0 http.port: 9200 ``` ``` sudo systemctl restart elasticsearch ```

验证ES是否正常：执行curl http://localhost:9200，输出含"version"字段即为成功。

Django档案系统搭建

1.克隆项目并安装依赖

使用开源简化版天然气档案项目，执行以下命令：

``` git clone https://github.com/tech-expert/gas-digital-archive.git cd gas-digital-archive pip install django elasticsearch-dsl djangorestframework ```

2.配置核心参数

编辑项目主配置文件gas_archive/settings.py，替换为完整可复制内容：

``` import os from pathlib import Path BASE_DIR = Path(__file__).resolve().parent.parent SECRET_KEY = 'django-insecure-@2j^!@your-secret-key-here' DEBUG = True ALLOWED_HOSTS = [''] INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'rest_framework', 'archives', ] DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / 'db.sqlite3', } } ES_HOST = 'localhost' ES_PORT = 9200 ```

3.初始化数据库与超级用户

执行迁移命令创建数据库，再创建后台管理账号：

``` python manage.py migrate python manage.py createsuperuser 按提示输入用户名、邮箱、密码 ```

档案数据导入与验证

1.准备数据文件

新建gas_pipe.csv，写入示例管线档案数据：

``` pipe_id,diameter,material,burial_depth,install_date,station P001,219,碳钢,1.2,2022-01-15,1号站场 P002,114,PE,0.8,2022-03-20,2号站场 ```

2.导入档案数据

项目内置CSV导入命令，运行：

``` python manage.py import_gas_data --file=gas_pipe.csv ```

3.检索功能验证

启动服务：python manage.py runserver 0.0.0.0:8000，在新终端执行检索请求：

``` curl -X POST http://localhost:8000/api/search -H "Content-Type: application/json" -d '{"keyword":"1号站场"}' ```

返回结果将包含P001管线的所有信息，验证成功。

操作验证与后续调整

1.后台管理：打开浏览器输入http://服务器IP:8000/admin，用超级用户账号登录，可新增、修改、删除天然气档案；2.检索优化：如需调整匹配规则，可修改archives/models.py中的ES查询条件；3.生产部署：需将DEBUG设为False，更换为PostgreSQL数据库，并配置Nginx反向代理。