sourcepole/qwc-fulltext-search-service

QWC Fulltext Search Service

概述

QWC Fulltext Search Service是QWC（QGIS Web Client）服务套件的核心组件之一，专注于提供全文检索能力。该服务旨在为QWC生态系统中的应用（如地理信息系统、Web客户端等）提供高效、可配置的文本搜索功能，支持与其他QWC服务无缝集成。更多详情请参见https://github.com/qwc-services/qwc-fulltext-search-service%E3%80%82

核心功能与特性

• 全文检索能力：支持对文本内容进行快速、准确的全文搜索，涵盖关键词匹配、模糊搜索等基础检索功能。
• QWC生态集成：与QWC服务套件中的其他组件（如QWC Map Service、QWC Data Service）兼容，可直接对接QWC应用架构。
• 可配置化：支持通过参数自定义搜索规则、索引路径、日志级别等，适应不同场景的检索需求。
• 轻量部署：基于Docker容器化设计，部署流程简化，易于维护和扩展。

使用场景与适用范围

• 地理信息系统（GIS）：用于检索空间数据属性（如地名、要素描述等），提升地理数据的查询效率。
• QWC Web客户端：为QWC Web应用提供文本内容搜索功能，优化用户对应用内信息的获取体验。
• 企业级应用集成：作为独立服务嵌入企业内部基于QWC构建的业务系统，满足定制化文本检索需求。

使用方法与配置说明

Docker部署

基础运行命令

通过以下命令快速启动服务容器：

bash
docker run -d --name qwc-fulltext-search \
  -p 5000:5000 \
  qwc-fulltext-search-service

Docker Compose配置示例

在docker-compose.yml中集成服务（适用于多服务协同场景）：

yaml
version: '3.8'
services:
  qwc-fulltext-search:
    image: qwc-fulltext-search-service
    container_name: qwc-fulltext-search
    ports:
      - "5000:5000"  # 服务监听端口
    environment:
      - LOG_LEVEL=INFO  # 日志级别：DEBUG/INFO/WARNING/ERROR
      - SEARCH_INDEX_PATH=/app/index  # 搜索索引文件存储路径
      - QWC_CONFIG_PATH=/app/config  # QWC配置文件路径（用于集成其他服务）
      - PORT=5000  # 服务端口（默认5000）
    volumes:
      - ./local/index:/app/index  # 本地索引目录挂载（持久化索引数据）
      - ./local/config:/app/config  # 本地配置目录挂载（自定义配置文件）
    restart: unless-stopped

环境变量配置

服务支持通过环境变量调整运行参数，常用配置如下：

集成说明

该服务需与QWC生态中的应用或服务配合使用，具体集成步骤（如API调用方式、数据对接格式等）请参考https://github.com/qwc-services/qwc-fulltext-search-service%E3%80%82

注意事项

• 版本兼容性：使用时需确保与QWC服务套件的版本匹配，避免因版本差异导致集成问题。
• 索引初始化：首次启动服务时，需确保索引目录（SEARCH_INDEX_PATH）可写，服务可能自动初始化基础索引结构。
• 性能优化：对于大规模数据检索场景，建议通过调整索引分片、内存分配等参数优化搜索效率（具体配置见GitHub文档）。