owntracks/frontend

OwnTracks UI

!版本 https://github.com/owntracks/frontend/workflows/Build/badge.svg](https://github.com/owntracks/frontend/actions?query=workflow%3ABuild+branch%3Amaster) https://github.com/owntracks/frontend/workflows/Tests/badge.svg](https://github.com/owntracks/frontend/actions?query=workflow%3ATests+branch%3Amaster) https://github.com/owntracks/frontend/workflows/Lint/badge.svg](https://github.com/owntracks/frontend/actions?query=workflow%3ALint+branch%3Amaster)

!https://raw.githubusercontent.com/owntracks/frontend/master/docs/images/owntracks-ui.png

镜像概述和主要用途

OwnTracks UI是https://github.com/owntracks/recorder%E7%9A%84Web%E7%95%8C%E9%9D%A2%EF%BC%8C%E4%BD%9C%E4%B8%BAVue.js%E5%8D%95%E9%A1%B5%E5%BA%94%E7%94%A8%E6%9E%84%E5%BB%BA%E3%80%82%E8%99%BD%E7%84%B6OwnTracks%E8%AE%B0%E5%BD%95%E5%99%A8%E6%9C%AC%E8%BA%AB%E5%B7%B2%E9%99%84%E5%B8%A6%E4%B8%80%E4%BA%9B%E5%9F%BA%E6%9C%AC%E7%BD%91%E9%A1%B5%EF%BC%8C%E4%BD%86%E6%AD%A4%E7%95%8C%E9%9D%A2%E6%8F%90%E4%BE%9B%E4%BA%86%E6%9B%B4%E9%AB%98%E7%BA%A7%E7%9A%84%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%B0%86%E6%89%80%E6%9C%89%E5%8A%9F%E8%83%BD%E9%9B%86%E4%B8%AD%E5%9C%A8%E4%B8%80%E4%B8%AA%E5%9C%B0%E6%96%B9%E3%80%82

!https://raw.githubusercontent.com/owntracks/frontend/master/docs/images/map-features.png

核心功能和特性

• 最新已知（实时）位置：
  • 精度可视化（圆圈）
  • 设备友好名称和图标
  • 详细信息（如可用）：时间、纬度、经度、高度、电池、速度和区域
• 位置历史记录（数据点、线条或两者同时显示）
• 位置热力图
• 快速将地图上显示的所有对象适配到视图中
• 按特定日期和时间范围显示数据
• 按用户或特定设备筛选
• 旅行距离计算
• 将选定的位置数据下载为JSON
• 高度可定制

使用场景和适用范围

OwnTracks UI适用于需要监控和分析OwnTracks位置数据的个人和组织。典型使用场景包括：

• 家庭定位监控，实时了解家庭成员位置
• 个人旅行记录和路线分析
• 车队或物流车辆追踪与管理
• 户外活动参与者位置监控
• 宠物追踪（配合适当的GPS设备）

该界面特别适合需要直观可视化位置数据和历史轨迹的用户，提供了比OwnTracks记录器自带基础网页更丰富的功能和更好的用户体验。

详细的使用方法和配置说明

Docker安装

Docker Hub上提供了预构建的Docker镜像：https://hub.docker.com/r/owntracks/frontend%E3%80%82

使用docker run直接启动容器

console
$ docker run -d -p 80:80 -e SERVER_HOST=otrecorder-host -e SERVER_PORT=8083 owntracks/frontend

使用docker-compose部署

如果您还使用默认的compose配置运行OwnTracks Recorder，且服务名为otrecorder：

yaml
version: "3"

services:
  owntracks-ui:
    image: owntracks/frontend
    ports:
      - 80:80
    volumes:
      - ./path/to/custom/config.js:/usr/share/nginx/html/config/config.js
    environment:
      - SERVER_HOST=otrecorder
      - SERVER_PORT=8083
    restart: unless-stopped

配置参数说明

环境变量

自定义配置

要自定义UI配置，可以挂载自定义的config.js文件：

yaml
volumes:
  - ./path/to/custom/config.js:/usr/share/nginx/html/config/config.js

所有可用配置选项详见https://github.com/owntracks/frontend/blob/master/docs/config.md%E3%80%82

构建镜像（从源代码）

如果需要从源代码构建镜像，可以在docker-compose.yml中替换image:配置：

yaml
build:
  context: ./owntracks-frontend
  dockerfile: docker/Dockerfile

（假设您已将此仓库克隆到与docker-compose.yml相同目录下的owntracks-frontend目录中）

使用方法

1. 启动容器后，通过浏览器访问服务器的IP地址或域名（取决于您的端口映射配置）
2. 初始配置需要指向OwnTracks记录器的地址和端口
3. 在界面中，您可以：
   • 查看实时位置数据
   • 浏览历史位置记录
   • 生成位置热力图
   • 按用户或设备筛选数据
   • 选择特定时间范围查看位置数据
   • 计算并查看旅行距离
   • 下载位置数据进行离线分析

界面高度可定制，您可以根据需要调整地图视图、数据显示方式和其他视觉元素。