gpsgate/gpsgate-services

GpsGate Services 镜像文档

概述

GpsGate Services 是一款基于GPS技术的追踪与管理平台，专注于提供位置监控、设备管理及数据可视化解决方案。该平台支持多类型GPS设备接入，可实现实时位置追踪、历史轨迹查询、设备状态监控及数据报告生成，广泛应用于车队管理、物流监控、资产跟踪等领域。

核心功能与特性

• 实时位置监控
  支持全球GPS设备接入，提供秒级实时位置更新，显示设备在线状态、速度、方向等关键信息。

• 设备与协议管理
  兼容主流GPS协议（如NMEA、GT06、TK103等），支持设备分组管理、固件升级及参数配置。

• 数据报告与分析
  内置多维度报告模板（里程统计、停留时间、超速记录等），支持自定义报告生成与导出（CSV/PDF格式）。

• API与集成能力
  提供RESTful API接口，支持与第三方系统（如ERP、物流管理平台）集成，实现数据互通与流程自动化。

• 安全与权限控制
  基于角色的访问控制（RBAC），支持多用户权限管理，确保数据访问安全。

使用场景

• 车队管理：实时监控车辆位置、行驶路线、油耗统计，优化调度效率。
• 物流配送：跟踪货运车辆位置，预测到达时间，提升配送透明度。
• 资产跟踪：监控贵重设备（如工程机械、集装箱）位置，防止资产丢失。
• 人员监控：适用于外勤人员定位、紧急救援响应等场景。

使用方法

基本部署（Docker Run）

通过以下命令快速启动GpsGate Services容器：

bash
docker run -d \
  --name gpsgate-services \
  -p 80:8080 \  # HTTP端口映射（默认应用端口8080）
  -p 443:8443 \ # HTTPS端口映射（默认SSL端口8443）
  -v /host/path/data:/app/data \  # 持久化存储（配置、日志、设备数据）
  -e DB_TYPE=mysql \  # 数据库类型（支持mysql/postgresql）
  -e DB_HOST=192.168.1.100 \  # 数据库主机地址
  -e DB_PORT=3306 \  # 数据库端口
  -e DB_NAME=gpsgate \  # 数据库名称
  -e DB_USER=admin \  # 数据库用户名
  -e DB_PASSWORD=SecurePass123 \  # 数据库密码
  -e ADMIN_EMAIL=admin@example.com \  # 管理员邮箱（用于登录）
  -e ADMIN_PASSWORD=Admin123! \  # 管理员密码
  gpsgate/services:latest

持久化存储

为避免容器重启后数据丢失，需挂载持久化目录：

• /app/data：存储配置文件、设备日志及报告数据。
• 建议使用Docker Volume或主机目录挂载（如示例中/host/path/data需替换为实际主机路径）。

环境变量配置

Docker Compose配置示例

创建docker-compose.yml文件实现多容器部署（含数据库）：

yaml
version: '3'
services:
  gpsgate:
    image: gpsgate/services:latest
    ports:
      - "80:8080"
      - "443:8443"
    volumes:
      - ./gpsgate-data:/app/data
    environment:
      - DB_TYPE=mysql
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=gpsgate
      - DB_USER=root
      - DB_PASSWORD=rootpass
      - ADMIN_EMAIL=admin@example.com
      - ADMIN_PASSWORD=Admin123!
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    volumes:
      - ./mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=gpsgate

启动服务：

bash
docker-compose up -d

访问与配置

1. 部署完成后，通过 http://<主机IP>:80 或 https://<主机IP>:443 访问Web管理界面。
2. 使用配置的ADMIN_EMAIL和ADMIN_PASSWORD登录。
3. 进入「设备管理」页面添加GPS设备，配置协议类型与连接参数。
4. 在「报告」模块生成自定义统计报告，或通过API接口获取实时数据。

注意事项

• 数据库需提前创建（或通过Docker Compose自动初始化，如示例）。
• 生产环境建议启用HTTPS（可通过容器内SSL配置或外部反向代理实现）。
• 高并发场景下，建议配置外部Redis缓存以提升性能。