独立索引器镜像文档

镜像概述和主要用途

独立索引器是一个集成了所有必要组件的单文件可执行程序，内置SQLite数据库，旨在提供便捷、轻量级的索引服务，无需复杂的外部依赖配置。主要用于快速部署索引功能，适用于对环境依赖要求低、需要简化部署流程的场景。

核心功能和特性

• 单文件可执行：将所有功能组件打包为单个可执行文件，简化部署及维护流程
• 内置SQLite数据库：无需额外配置外部数据库，降低环境依赖复杂度
• 组件整合：集成索引服务所需的全部组件，提供一站式功能支持
• 轻量级设计：资源占用低，适合资源受限环境或边缘部署场景

使用场景和适用范围

• 开发测试环境：快速搭建索引服务用于功能验证和调试
• 小型应用系统：满足轻量级索引需求，无需部署复杂分布式架构
• 边缘计算设备：适用于资源有限的边缘节点，提供本地化索引能力
• 临时索引任务：需快速启动且短期使用的索引服务场景

使用方法和配置说明

基本部署命令

通过Docker快速启动服务：

docker run -d --name standalone-indexer -p 8080:8080 [镜像名称]

• -p 8080:8080：端口映射（主机端口:容器端口），默认服务端口为8080
• --name standalone-indexer：指定容器名称，便于管理

数据持久化配置

为避免容器重启导致数据丢失，可挂载本地目录保存SQLite数据库文件：

docker run -d --name standalone-indexer \
  -p 8080:8080 \
  -v /本地数据目录:/app/data \
  [镜像名称]

容器内SQLite数据库文件默认存储路径为/app/data/index.db，挂载本地目录后数据将持久化到主机。

配置说明

目前该镜像无需额外配置参数，使用默认配置即可启动服务。若需自定义端口，可通过环境变量PORT指定：

docker run -d --name standalone-indexer \
  -p 9000:9000 \
  -e PORT=9000 \
  [镜像名称]

验证服务

服务启动后，可通过访问http://localhost:8080/health验证服务状态，返回OK表示服务正常运行。